Allows running Overpass QL queries against the OpenStreetMap Overpass API to retrieve OpenStreetMap data, with configurable endpoint and request timeout.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
An MCP server that lets an agent run Overpass QL queries against the OpenStreetMap Overpass API.
npm installRelated MCP server: litescrape-mcp-server
npm startIt speaks MCP over stdio.
{
"mcp": {
"overpass": {
"type": "local",
"command": ["node", "/absolute/path/to/overpass-mcp/index.js"]
}
}
}overpass_queryRuns an Overpass QL query and returns the raw response.
argument | required | description |
| yes | Overpass QL, e.g. |
| no | Overpass API endpoint (default |
| no | request timeout in ms (default 60000) |
Responses are truncated at 200 kB to protect the model's context; narrow the query if you see a truncation notice.
npm test # offline unit tests (retry + truncation), CI-safe
npm run test:live # one live query against a public endpointtest never touches the network. test:live does, and can fail when a public
instance is busy.
A User-Agent header is sent because the public Overpass endpoint rejects
requests from unknown clients (notably Node's default undici UA) with
HTTP 406.
The public instances intermittently shed load with HTTP 429/503/504. The client retries those twice with a short backoff before giving up.
Public Overpass instances are rate limited. For heavy use, point endpoint
at your own instance.
The default endpoints are free, community-run public services. They are not yours and they are not guaranteed.
Respect the servers. Space out queries, cache results, and avoid heavy or automated bulk querying. Do not hammer the endpoint.
Allow time. Queries may be slow, rate limited, or intermittently return HTTP 429/503/504. The client retries a little, but patience is expected.
Follow the rules. You are responsible for complying with the usage policies and terms of whichever endpoint you use, and with the OpenStreetMap licence (data © OpenStreetMap contributors, ODbL).
No warranty, no liability. This software is provided "as is", without warranty of any kind. The author is not responsible for any use, misuse, rate limiting, blocks, data loss, or damages arising from it.
If you need volume or reliability, run your own Overpass instance and point
endpoint at it.
MIT. Use, modify, and distribute freely; keep the copyright and license notice.
This server cannot be deployed
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
OpenStreetMap Overpass MCP — programmatic queries against the OSM database
OpenStreetMap queries, maps/styles, search, routing, terrain, analysis, pipelines, and rendering.
