Skip to main content
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 for how to get one (dashboard API token, device-flow login, or MCP OAuth). The field catalog at GET /v1/meta/fields is public.

​
Why it’s different

Federal sources only

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.

Per-field citations

Every value carries source, source_url, fetched_at, and confidence. A regulator or underwriter can re-fetch each citation independently and verify.

MCP-native distribution

The product surface is two MCP tools. Any MCP-aware agent uses Mireye without learning an HTTP API.

Honest pattern

Source failures surface as partial_failures with a retryable flag. We never silently drop a value we couldn’t fetch.

​
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.
  • 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

Quickstart

Make your first /v1/ask call in five minutes.

API reference

Endpoint schemas with try-it panels.

MCP install

Wire Mireye into Claude Desktop or Cursor.

Use cases

Underwriting, lending, and agent workflows.