Overpass API Connector for AI agents.
4 live capabilities
Query and extract real-world OpenStreetMap data for urban planning and GIS analysis.
Waiting for input…
Why people use Overpass API
Overpass for GIS Data Extraction
This Connector lets your agent do that heavy lifting for you. You just describe what you need in plain English, and the agent handles the query construction and data retrieval. You get the specific data you need without ever touching a query editor.
What Vinkius changes
You get a direct line to OpenStreetMap data using plain English.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Urban planning infrastructure audits
An urban planner asks their agent to find every bike lane in a specific zip code to identify gaps in the city network using execute_query.
- Real-world use case 02
Geographic research data extraction
A data scientist needs to find all pharmacies in a city for a health study and uses execute_query to get the coordinates.
- Real-world use case 03
GIS bounding box downloads
A GIS analyst needs to pull a large chunk of map data for a specific region and uses get_map to grab the raw XML.
Complete set · 4capabilities
The complete Overpass API capability set.
These are the exact actions your AI can choose when you ask it to work with Overpass API.
01—04
4 capabilities in this set.
Part of 4 available through Overpass API.
- 01 Capability
Get map
Fetches raw OSM map data for a specific bounding box. Use this to grab large chunks of map data for GIS processing.
- 02 Capability
Get status
Checks your current Overpass API rate limit and slot availability. Use this to see if you're about to get throttled.
- 03 Capability
Execute xapi
Runs legacy XAPI queries to return raw XML data. Use this when you need to support older query formats.
- 04 Capability
Execute query
Runs Overpass QL queries to return JSON data. This is your go-to for finding specific points of interest or features.
Set up in minutes
One URL. Then ask Overpass API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Overpass API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Overpass API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Overpass API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Overpass API URL.
- Step 03
Save and start
Save the connection and enable Overpass API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"overpass": {
"url": "https://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Overpass API
Open Agent mode in chat and ask: "Using Overpass API, help me...". 4 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"overpass": {
"url": "https://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Overpass API
Ask Copilot: "Using Overpass API, help me...". 4 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"overpass": {
"url": "https://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Overpass API
Open Cascade and ask: "Using Overpass API, help me...". 4 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"overpass": {
"url": "https://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Overpass API
Ask Cline: "Using Overpass API, help me...". 4 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add overpass --transport http "https://edge.vinkius.com/vk_preview_zzdgleuR8jSsqRIakxavJFmaXkwVJPywGnPhOsDn/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Overpass API
Ask Claude: "Using Overpass API, show me...". 4 tools are ready
Where the request belongs
Work Overpass API can move forward.
This is for GIS analysts, urban planners, and developers who are tired of manual data scraping and want to pull geographic features instantly.
GIS Analyst
You use this to automate the extraction of geographic features for research and modeling without writing manual queries.
Urban Planner
You use this to quickly query city infrastructure like bike lanes, parks, or public transport nodes.
Developer
You use this to integrate real-world map data into your applications without building complex API wrappers.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsOpenStreetMap
Access and edit OpenStreetMap data. manage changesets, query map elements, and retrieve geospatial data directly from any AI agent.
Overpass (OpenStreetMap)
Search OpenStreetMap data. find restaurants, shops, hospitals, schools, parks, ATMs and more worldwide.
Felt (Collaborative Maps)
Create and manage collaborative maps. upload geographic data, style layers, and manipulate map elements directly from any AI agent.
ArcGIS
Access GIS services via ArcGIS. geocode addresses, search places, get routes, check elevation and discover basemap styles from any AI agent.
Mapbox
Integrate Mapbox mapping and location services into your AI agent—access vector/raster tiles, static images, directions, and manage datasets.
CARTO
Empower your AI agents to execute spatial SQL, generate routes, create driving isolines, and bulk geocode directly on CARTO.
Bring your own AI
Change the model, client or framework. Keep Overpass API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Overpass API.
The practical details behind the request, access and result.
Can Overpass MCP find specific buildings?
Yes, it can find any point of interest that is mapped on OpenStreetMap, including specific buildings, shops, and landmarks.
Does Overpass MCP work for any city?
It works globally. As long as the data is available in OpenStreetMap, your agent can query it for any city or region.
Can I use Overpass MCP to get raw map files?
Yes, you can use the bounding box capability to fetch raw map data for specific geographic areas to use in your own GIS software.
Is Overpass MCP good for urban planning?
It's excellent for urban planning. You can quickly pull data on bike lanes, parks, and public transport nodes across different cities.
How does Overpass MCP handle API limits?
It includes a status capability that lets your agent check your current slot availability and rate limits so you don't get blocked during heavy use.
Can I use it to find pharmacies near me?
Yes, you can ask your agent to find pharmacies within a certain radius of your coordinates, and it will pull the results from the map data.
How do I find all restaurants in a specific city using this server?
You can ask the agent to use the execute_query capability with an Overpass QL string, for example: [out:json];area[name='Berlin'];node(area)[amenity=restaurant];out;. The agent will handle the execution and present the results.
Can I download raw map data for a specific coordinate range?
Yes. Use the get_map capability and provide the bounding box coordinates in the format min_lon,min_lat,max_lon,max_lat. This will return the raw OSM data for that area.
What should I do if the API returns a rate limit error?
Run the get_status capability. It will show you how many slots are available and if there is a cooldown period active for your IP address.
One connection away
Give your agent a direct line to Overpass API.
Connect Overpass API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available