The hosted Mireye MCP server provides cited US-coordinate answers and field-level data retrieval with provenance.
Ask Mireye (mireye_ask): answer natural-language questions about a US coordinate, returning citations and per-source provenance.
Fetch Mireye fields (mireye_fetch): retrieve specific catalog fields or named presets at a US coordinate, with value, source, source URL, fetched_at, and confidence per field.
Use US coordinates: latitude 18–72, longitude -180 to -65.
Discover fields: field descriptions are available through MCP resources such as mireye://catalog/fields and mireye://field/{name}.
Read-only and safe: both tools are annotated read-only, idempotent, non-destructive, and open-world.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mireye-mcp is 123 Main St in a flood zone?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mireye-mcp 0.7.3 configures Claude Code, Codex and Cursor to connect directly to
https://api.mireye.com/mcp, and installs the use-mireye skill. The package
runs no MCP server. Its default invocation refuses the retired local stdio
transport; device login and local data tools are not included.
Sign in at Mireye agent setup, accept the current customer terms, copy the private setup prompt and paste it into your agent. The prompt supplies the scoped API key through standard input, never a process argument. The helper validates the account and exact setup-key identity before saving the key or changing client configuration.
# The agent supplies the private key on stdin, without echoing or logging it.
uvx --from mireye-mcp==0.7.3 mireye-mcp connect --all --api-key-stdin --attempt-id '<attempt-id>' --token-id '<token-id>'
uvx --from mireye-mcp==0.7.3 mireye-mcp doctor --proofconnect writes native hosted configurations, without API keys or local launch
commands. Restart your agent and authorize its hosted MCP connection using the
client's OAuth sign-in. OAuth credentials remain managed by that client.
doctor --proof verifies the installed configuration and skill, checks the saved
API key's account, and makes one free REST Fetch for elevation at 40.7128,
-74.0060. It requires a finite value, ok status, source URL and timestamp before
reporting the data proof. The API records the successful Fetch against the setup
attempt. This proves the REST key/data path; it does not authorize or verify
hosted MCP OAuth. Confirm the connected client's tools after OAuth sign-in.
Client / purpose | Configuration | Skill / credentials |
Claude Code |
|
|
Codex |
|
|
Cursor |
|
|
Helper API key | — |
|
Setup ownership | — |
|
Setup preserves unrelated configuration, refuses custom conflicting entries or
modified skills, and backs up changed configuration files. A process lock and
content rechecks protect concurrent edits. Repeating connect reuses the saved
key and files; it does not issue credentials or grant another promotional
balance. An inherited shell key cannot replace an existing managed account.
To switch accounts, remove the managed connection, run logout, then connect
from that account's setup page. Authorize the correct account separately in the
MCP client's OAuth flow.
# Preview only: no key read, API requests, login save, lock or file changes.
uvx --from mireye-mcp==0.7.3 mireye-mcp connect --all --dry-run
# Reuse the saved key; --client can be repeated.
uvx --from mireye-mcp==0.7.3 mireye-mcp connect --client codex
# Read a redacted diagnostic report.
uvx --from mireye-mcp==0.7.3 mireye-mcp doctor --proof --json
# Remove unchanged owned entries/skills, retaining the helper API key.
uvx --from mireye-mcp==0.7.3 mireye-mcp connect --all --remove
# Remove the helper's saved key. --revoke also revokes its server-verified key ID.
uvx --from mireye-mcp==0.7.3 mireye-mcp logout--all skips absent supported clients; explicitly selecting an absent client
fails. Existing identical manual entries remain unmanaged, including on removal.
No project instructions or shell profiles are changed. Custom CODEX_HOME and
CLAUDE_CONFIG_DIR locations require manual setup; use --config-home PATH for
isolated tests. --base-url accepts the production API or loopback only and
binds saved keys to that origin. Redirects never forward a key to another host.
Legacy --api-key input remains accepted for compatibility; prefer stdin so the
key cannot appear in process listings.
Native configurations follow the client documentation: Claude Code, Codex, and Cursor.
The official MCP registry entry is hosted-only. This package is not a local transport distribution, and installing it does not add a second data service.
The hosted mireye_enrich tool returns the same compact response as
POST /v1/enrich. Each returned field contains value, source, confidence,
and interpretation_hints, with unit only when defined. Failed fields are
omitted. A matched parcel can return fields: {}.
Coordinates, geocode evidence, the analysis point, parcel match status and
billing are included. mireye_enrich takes preset as a list of one or more
bundle names, such as ["power", "water"].
mireye_search returns scalar filter values and every requested public Search or
Enrich field as plain values in each match's fields, excluding top-level identity
duplicates, using the matched parcel record's lat/lon pair. Every response carries
remarks ([] when clean; branch on code and path) and next_cursor (null on the
last page). Fetch and Ask have their own contracts.
See the Enrich reference for the
525-field inventory, selectors and examples.
Answer a natural-language question about a US coordinate, with citations to authoritative federal data sources. Returns the answer plus per-citation provenance (source, source URL, fetched_at, confidence). Use this when the caller has a specific question about a place (e.g. 'is this in a flood zone?', 'what's the wildfire risk here?', 'what kind of building is at this address?').
Inputs: lat (required), lng (required), question (required). Returns: object
Fetch specific data fields at a US coordinate with full provenance per field. Use this when the caller knows exactly which fields they need (e.g. 'elevation and slope at this point') or wants to power a custom workflow. Each field includes its value, source, source URL, fetched_at timestamp, and confidence.
Inputs: lat (required), lng (required), fields, preset. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 2 tools
The two tools have clearly distinct purposes: mireye_ask handles natural-language questions with implicit field selection, while mireye_fetch retrieves explicitly specified data fields. There is no overlap or ambiguity.
Both tools follow the same 'mireye_<verb>' pattern with snake_case, using descriptive verbs ('ask' and 'fetch'). The naming is consistent and predictable.
With only two tools, the server is minimal but scoped appropriately for its purpose of US coordinate data queries. It could potentially benefit from a metadata tool, but the count is not unreasonable for the stated domain.
The server covers the two primary interaction modes: asking questions and fetching specific fields. It may lack a discovery or listing tool, but the existing tools provide a full workflow for obtaining data with provenance.
Remote MCP endpoint for U.S. home forecasts, public benchmark data, and permit or zoning readiness.
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Flood, wildfire, soils, terrain, power grid, utilities and parcels for any US location, sourced.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
