# Mireye Earth

## Docs

- [POST /v1/ask — natural-language geospatial Q&A](https://docs.mireye.ai/api-reference/ask.md): Send a US coordinate and a question; get a cited prose answer backed by federal data, with per-source provenance on every citation.
- [Mireye Earth error codes and response shapes](https://docs.mireye.ai/api-reference/errors.md): Mireye Earth returns structured JSON errors for all 4xx and 5xx responses. Learn each error code, its cause, and how to recover from it.
- [POST /v1/fetch — structured field data with provenance](https://docs.mireye.ai/api-reference/fetch.md): Request named fields or a preset bundle for a US coordinate and get values with per-field source, URL, timestamp, confidence, and TTL.
- [Field catalog: all 47 fields across 5 layers](https://docs.mireye.ai/api-reference/field-catalog.md): Browse every geospatial field available in Mireye Earth by layer — terrain, land cover, built environment, utilities, and parcels and boundaries.
- [GET /v1/meta/fields — field and preset catalog](https://docs.mireye.ai/api-reference/meta-fields.md): Fetch the machine-readable catalog of all 47 fields with units and sources, all 8 preset expansions, and the US coordinate envelope. ETag-cached.
- [Understanding confidence ratings: HIGH, MEDIUM, LOW](https://docs.mireye.ai/concepts/confidence.md): Mireye rates every field HIGH, MEDIUM, or LOW. Learn what each confidence level means and how to act on it in regulatory and underwriting workflows.
- [Fields and presets in the Mireye catalog](https://docs.mireye.ai/concepts/fields-presets.md): Mireye exposes 47 named fields across 5 layers. Request any combination by name, or use one of 8 presets that bundle fields for common use cases.
- [Provenance: per-field citations in every response](https://docs.mireye.ai/concepts/provenance.md): Every Mireye field includes source, source_url, fetched_at, and confidence — a complete provenance trail for regulators and auditors to verify any value.
- [Mireye Earth: Geospatial data with federal citations](https://docs.mireye.ai/introduction.md): Mireye Earth answers geospatial questions about US coordinates with authoritative federal-source citations. Every field carries provenance you can audit.
- [Install the Mireye Earth MCP server for agents](https://docs.mireye.ai/mcp/installation.md): Install the Mireye Earth MCP server and configure it for Claude Desktop, Cursor, or a custom Python agent to query US geospatial data.
- [Mireye Earth MCP tools: ask and fetch reference](https://docs.mireye.ai/mcp/tools.md): The two Mireye Earth MCP tools — ask for natural-language questions and fetch for structured field access — their input schemas and when to use each.
- [Troubleshoot the Mireye Earth MCP server](https://docs.mireye.ai/mcp/troubleshooting.md): Diagnose and fix common issues with the Mireye Earth MCP server — tools not appearing, connection timeouts, coordinate errors, and unknown fields.
- [Quickstart: make your first Mireye Earth API call](https://docs.mireye.ai/quickstart.md): Make your first API call, fetch raw geospatial fields, and optionally connect the MCP server — all in under five minutes with no SDK required.
- [Using Mireye Earth in AI agents and pipelines](https://docs.mireye.ai/use-cases/agents.md): Integrate Mireye into AI agents via the MCP server or direct HTTP API for geospatial reasoning with cited, reproducible answers grounded in federal data.
- [Property insurance underwriting with Mireye Earth](https://docs.mireye.ai/use-cases/insurance.md): Fetch flood zone, wildfire, and building risk signals for P&C underwriting — with federal-source citations that satisfy regulatory audits.
- [Mortgage and property lending due diligence](https://docs.mireye.ai/use-cases/lending.md): Pull floodplain status, easements, and building data for mortgage origination and title — with federal-source citations for compliance audits.