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_addressResolve a US address or ZIP to coordinates, city/state/ZIP, and a Census block group.
get_area_demographicsPopulation, households, median income and age for the block group at a point — each figure sourced.
get_drive_time_areaA drive- or walk-time isochrone polygon (5/10/15 min) from a point.
get_site_snapshotScore a US address for a business type: opportunity score, competitors, summary, and a public report URL.
compare_locationsDiff 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/mcpChatGPT (developer mode)
Settings → Connectors → Advanced → Developer mode
Add server → URL: https://<your-deployment>.convex.site/mcpCursor
// ~/.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
| Tool | Keyless (per IP) | With a free key |
|---|---|---|
geocode_address | 10 / day | 50 / day |
get_area_demographics | 10 / day | 50 / day |
get_drive_time_area | 3 / day | 15 / day |
get_site_snapshot | 1 / day | 5 / day |
compare_locations | 1 / day | 5 / 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.