Overspan MCP server
{
"mcpServers": {
"overspan": {
"command": "npx",
"args": [
"-y",
"overspan-mcp@latest"
],
"env": {
"OVERSPAN_KEY": "<overspan_key>",
"OVERSPAN_API_KEY": "<overspan_api_key>",
"OVERSPAN_API_URL": "https://...",
"YOUR_KEY": "<your_key>"
}
}
}
}{
"mcpServers": {
"overspan": {
"command": "npx",
"args": [
"-y",
"overspan-mcp@latest"
],
"env": {
"OVERSPAN_KEY": "<overspan_key>",
"OVERSPAN_API_KEY": "<overspan_api_key>",
"OVERSPAN_API_URL": "https://...",
"YOUR_KEY": "<your_key>"
}
}
}
}{
"mcpServers": {
"overspan": {
"command": "npx",
"args": [
"-y",
"overspan-mcp@latest"
],
"env": {
"OVERSPAN_KEY": "<overspan_key>",
"OVERSPAN_API_KEY": "<overspan_api_key>",
"OVERSPAN_API_URL": "https://...",
"YOUR_KEY": "<your_key>"
}
}
}
}{
"servers": {
"overspan": {
"command": "npx",
"args": [
"-y",
"overspan-mcp@latest"
],
"env": {
"OVERSPAN_KEY": "${input:overspan_key}",
"OVERSPAN_API_KEY": "${input:overspan_api_key}",
"OVERSPAN_API_URL": "${input:overspan_api_url}",
"YOUR_KEY": "${input:your_key}"
}
}
},
"inputs": [
{
"id": "overspan_key",
"type": "promptString",
"description": "Overspan key",
"password": true
},
{
"id": "overspan_api_key",
"type": "promptString",
"description": "Overspan api key",
"password": true
},
{
"id": "overspan_api_url",
"type": "promptString",
"description": "Overspan api url",
"password": true
},
{
"id": "your_key",
"type": "promptString",
"description": "Your key",
"password": true
}
]
}{
"mcpServers": {
"overspan": {
"command": "npx",
"args": [
"-y",
"overspan-mcp@latest"
],
"env": {
"OVERSPAN_KEY": "<overspan_key>",
"OVERSPAN_API_KEY": "<overspan_api_key>",
"OVERSPAN_API_URL": "https://...",
"YOUR_KEY": "<your_key>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y overspan-mcpversion 0.1.2
What it does
This server provides access to OpenStreetMap data via the Overpass API through an MCP interface. It requires a paid Overspan API key and lets AI assistants query, search, and count geographic features in OpenStreetMap with usage tracking.
- Find restaurants, shops, or other amenities within a radius of a given location.
- Retrieve all features of a specific type (buildings, roads, parks) within a geographic bounding box.
- Count how many features match certain criteria in an area before retrieving the full dataset to manage query costs.
Tools this server exposes
| Tool | Does |
|---|---|
| overpass_query | Run raw Overpass QL queries for full access to OpenStreetMap data. |
| find_nearby | Search for features matching tag filters within a radius of a point. |
| features_in_bbox | Retrieve features matching tag filters inside a bounding box. |
| count_features | Count matching features in an area without retrieving them, using less quota. |
| get_usage | Check API key tier, limits, monthly quota used, and recent requests without consuming quota. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.