/quickstart
Quickstart
Five minutes from zero to a cited answer about a US coordinate.
1. Pick a coordinate
Python
lat = 40.7128 lng = -74.0060
Starting from an address?
curl -s https://api.mireye.com/v1/geocode \
-H "Authorization: Bearer $MIREYE_API_TOKEN" \
-H 'content-type: application/json' \
-d '{"address": "350 5th Ave, New York, NY 10118"}' | jq 2. Get a token
Shell
export MIREYE_API_TOKEN="<paste from dashboard>"
3. Ask a question
curl -s https://api.mireye.com/v1/ask \
-H "Authorization: Bearer $MIREYE_API_TOKEN" \
-H 'content-type: application/json' \
-d '{
"lat": 40.7128,
"lng": -74.0060,
"question": "What is the elevation here?"
}' | jq- The planner (Claude Sonnet 4.6) read the question, looked at the field catalog, and decided only elevation was needed.
- The terrain layer fetched 3DEP elevation for the coordinate.
- The synthesizer (also Claude Sonnet 4.6) wrote the prose answer, grounded in the fetched value, and the citation engine attached the source.
4. Fetch raw fields
curl -s https://api.mireye.com/v1/fetch \
-H "Authorization: Bearer $MIREYE_API_TOKEN" \
-H 'content-type: application/json' \
-d '{
"lat": 40.7128,
"lng": -74.0060,
"fields": ["elevation", "coast_distance_m"]
}' | jq 5. Use it from Claude Code
claude mcp remove mireye-earth -s user
6. Self-discover the catalog
cURL
curl -i https://api.mireye.com/v1/meta/fields | head -20