MapQuery MCP Server

Give your AI assistant real US location intelligence. This free, read-only Model Context Protocol server lets Claude, ChatGPT (developer mode), Gemini, and Cursor geocode addresses, pull demographics, build trade areas, and score sites — with every figure cited to US Census and OpenStreetMap data. US addresses only.

Tools

  • geocode_address

    Resolve a US address or ZIP to coordinates, city/state/ZIP, and a Census block group.

  • get_area_demographics

    Population, households, median income and age for the block group at a point — each figure sourced.

  • get_drive_time_area

    A drive- or walk-time isochrone polygon (5/10/15 min) from a point.

  • get_site_snapshot

    Score a US address for a business type: opportunity score, competitors, summary, and a public report URL.

  • compare_locations

    Diff two public report slugs — scores, competitors, and demographic deltas. Facts only.

Connect it

Point your client at https://<your-deployment>.convex.site/mcp. Keyless access works immediately at a low daily rate; add a free key (below) for the higher tier.

Claude (custom connector)

Settings → Connectors → Add custom connector
Name: MapQuery
URL:  https://<your-deployment>.convex.site/mcp

ChatGPT (developer mode)

Settings → Connectors → Advanced → Developer mode
Add server → URL: https://<your-deployment>.convex.site/mcp

Cursor

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "mapquery": { "url": "https://<your-deployment>.convex.site/mcp" }
  }
}

Get a free key (higher limits)

Optional. Send the key asAuthorization: Bearer <key>. Shown once — store it.

Daily limits

ToolKeyless (per IP)With a free key
geocode_address10 / day50 / day
get_area_demographics10 / day50 / day
get_drive_time_area3 / day15 / day
get_site_snapshot1 / day5 / day
compare_locations1 / day5 / day

Read-only. No account access, no writes. Foot traffic is named as a data gap rather than estimated. Every response links the full source-cited report at mapquery.ai.