> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mireye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Provenance-tagged geospatial data for any US coordinate.

Mireye Earth answers geospatial questions about US coordinates with
federal-source citations. Every field returned — elevation, flood-zone
status, wildfire fuel load, nearest power plant, parcel zoning — carries
the source, source URL, fetched timestamp, and a calibrated confidence
bucket. Built for insurance underwriters, lenders, and AI agents that need
an audit trail, not just an answer.

## What you get

Two HTTP endpoints and one MCP server, sharing the same field catalog and
the same provenance model:

* **`POST /v1/ask`** — a planner LLM picks the relevant fields, fetches
  them in parallel, and a synthesizer LLM writes the answer with inline
  citations. Returns the answer plus the full citation list.
* **`POST /v1/fetch`** — the developer escape hatch. Pass the fields or
  preset you want; get raw per-field values with provenance and a
  `partial_failures` array for anything we couldn't fetch.
* **MCP server** — exposes the same two operations as MCP tools so
  Claude Desktop, Cursor, and custom MCP agents call Mireye natively.

Data requests are authenticated with a bearer token — see
[Authentication](/authentication) for how to get one (dashboard API
token, device-flow login, or MCP OAuth). The field catalog at
[`GET /v1/meta/fields`](/api-reference/meta-fields) is public.

## Why it's different

<CardGroup cols={2}>
  <Card title="Federal sources only" icon="building-columns">
    USGS, NOAA, USDA, USFS, USFWS, EPA, EIA, FAA, FHWA, BTS, US Census.
    No proprietary risk scores, no third-party brokers, no "AI-derived"
    values masquerading as data.
  </Card>

  <Card title="Per-field citations" icon="file-shield">
    Every value carries `source`, `source_url`, `fetched_at`, and
    `confidence`. A regulator or underwriter can re-fetch each citation
    independently and verify.
  </Card>

  <Card title="MCP-native distribution" icon="plug">
    The product surface is two MCP tools. Any MCP-aware agent uses
    Mireye without learning an HTTP API.
  </Card>

  <Card title="Honest pattern" icon="circle-info">
    Source failures surface as `partial_failures` with a `retryable`
    flag. We never silently drop a value we couldn't fetch.
  </Card>
</CardGroup>

## Coverage

* **Geography**: United States only — lower 48, Alaska, Hawaii, and US
  territories. Bounds: `lat ∈ [18, 72]`, `lng ∈ [-180, -65]`. Out-of-bounds
  requests return `400 coord_out_of_bounds`.

- **Fields**: 296 across 7 layers (terrain, land cover, built environment, utilities, parcels, climate, hazards). Full catalog at [`GET /v1/meta/fields`](/api-reference/meta-fields).
- **Presets**: 15 use-case bundles (`terrain`, `flood_risk`, `wildfire_underwrite`, `land_cover`, `site_selection`, `building_lookup`, `points_of_interest`, `utilities`, `boundaries`, `solar_siting`, `wind_siting`, `storage_siting`, `data_center_siting`, `grid_interconnect`, `natural_hazard`).

## What's next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first `/v1/ask` call in five minutes.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/ask">
    Endpoint schemas with try-it panels.
  </Card>

  <Card title="MCP install" icon="plug" href="/mcp/installation">
    Wire Mireye into Claude Desktop or Cursor.
  </Card>

  <Card title="Use cases" icon="compass" href="/use-cases/insurance">
    Underwriting, lending, and agent workflows.
  </Card>
</CardGroup>