Paid plans discount Enrich, Search and driving. Ask remains $0.10.
Lookup and Resolve are retired; use the replacement that matches the task.
Choosing fields
Readmireye://catalog/fields and mireye://catalog/presets for the stable free
Fetch contract. Experimental fields require explicit selection/visibility where
supported. Licensed parcel fields and fields derived from licensed parcel geometry
are absent from free Fetch. An explicit mixed free/licensed selection fails clearly;
public presets intentionally contain only eligible free fields.
mireye_enrich
The tool returns the same compact response as POST /v1/enrich. Its sparse field
map follows Enrich preset order: shared fields appear once at their first preset,
then unassigned fields follow in catalog order. Each returned field has value,
source, confidence, and interpretation_hints, plus unit only when defined.
Failed fields are omitted. Most null-valued fields are omitted; a temporary
33-field allowlist retains nulls that can carry domain meaning, but these can
also represent missing source attributes. Do not infer absence from a null or
omitted field. A matched parcel can return fields: {}.
Field source_url metadata, timestamps, vintage, TTL, notes, status, lifecycle and failure
metadata are not returned. Top-level fetched_at and partial_failures are
also omitted. Coordinates, geocode evidence, analysis_point, parcel_match
including its status, and the billing receipt remain available.
Enrich includes both free public evidence and premium parcel fields, so one call
can select all 546 available fields. Its field IDs and presets are listed in
Enrich fields. Coordinates require both lat and
lng; an address replaces the pair. Check geocode quality before drawing a
parcel-specific conclusion.
Paid requests
Enrich, Search and Proximity take their HTTP request object insidereq.
For example, Search plus enrichment:
mireye_search
Every request requires state or state2 with eq or a nonempty in list of
two-letter US state codes (50 states and DC). County is optional; ne alone is insufficient.
Search returns 10 parcels per page by default, with a maximum of 100. Send a
non-null next_cursor as cursor to continue within one hour, keeping filters,
fields and enrichment mode unchanged. Each page is a new paid operation; use a
new idempotency key for the next page and the same key when retrying that page.
Basic Search leaves enrich false and returns identity plus scalar filter values
and requested public Search/Enrich extras in fields, excluding duplicate identity
values. Those extras are included in the query price. Set enrich: true to attempt
the complete current Enrich catalog regardless of the fields list and receive
compact enriched_fields instead. Each match has one map, never both. Both modes
reuse the exact matched parcel and its stored parcel lat/lon unchanged; invalid
pairs skip candidates and make Search partial.
On Free, the query costs $0.20 plus $0.02 per successfully enriched delivered
parcel when full enrichment is enabled. Failed enrichment retains the match.
Complete internal outcomes determine billing and overall partial status before
compact projection. Failed fields and most nulls are omitted from enriched_fields;
its empty map is valid. There are no per-match status/error wrappers or nested
billing receipts. Fetch and Ask keep their existing contracts.
Search and enrichment share a 180-second default budget. MCP hosts should allow
at least 210 seconds for the response. The supported transport is hosted MCP;
the local adapter is retired. See Search for partial results,
capacity, dollar ceilings and saved-result recovery.
Use the same idempotency_key and payload to recover an existing paid operation.
Replaying a completed partial response returns its saved fields without recomputing
them. A deliberate new execution after a known terminal failure or a completed
partial result needs a new key; a fresh or omitted key creates a new operation.
Completed responses include a dollar billing receipt.
Tools describe themselves as read-only; paid tools do not promise keyless idempotency.
The account must have current terms acceptance and the connection’s required grants.
Resources and prompts
For a bounded worked workflow, follow Find and enrich a parcel. It shows ordinary Search, optional inline enrichment and a separate selected-parcel investigation. Resources includemireye://catalog/fields, mireye://catalog/presets,
mireye://catalog/us-envelope, mireye://field/{name} and mireye://preset/{name}.
Field/preset resources use the same free view as HTTP metadata. Unknown or licensed
Fetch resource names return a structured error.
Workflow prompts help select fields and organize cited reports; they do not change
prices or bypass permissions. Inspect source and precision, and per-field
status where the response exposes it. Standalone Enrich omits field statuses
and failures. Missing evidence is not proof of absence, and a point sample is
not a whole-parcel fact.