OpenStreetMap Connector for AI agents.

33 live capabilities

Query and edit geographic data for open-source maps and GIS analysis.

Live agent request OpenStreetMap / Connector

Waiting for input…

AI Agent

Why people use OpenStreetMap

OpenStreetMap for GIS Data Auditing and Map Management

With this Connector, you just tell your agent what area you want to look at. It pulls the raw nodes and ways for you, letting you focus on the analysis instead of the data entry.

What Vinkius changes

You get a direct bridge between your AI and the world's largest open-source geographic database.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Regional Data Audit

A GIS analyst needs to check road names in a specific city.
Real-world use case 02

Bulk Map Contribution

A contributor wants to update 50 building footprints.
Real-world use case 03

History Research

A researcher wants to see how a park boundary has shifted.

Complete set · 33capabilities

The complete OpenStreetMap capability set.

These are the exact actions your AI can choose when you ask it to work with OpenStreetMap.

Capability set01 / 09

01—04

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

01 Capability
Close changeset
Closes an open changeset. This finalizes your edits and submits them for review by the community.
02 Capability
Close note
Closes an existing map note. This is useful for cleaning up your notes once you have finished a task.
03 Capability
Comment note
Adds a comment to a map note. Use this to add extra context to your saved map notes.
04 Capability
Create changeset
Creates a new changeset to group your edits. This is essential for contributing your changes to the community.

Capability set02 / 09

05—08

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

05 Capability
Create element
Creates a new node, way, or relation. This lets you add new points of interest or roads to the map.
06 Capability
Create note
Creates a new map note. Use this to save specific details about a location for later reference.
07 Capability
Delete element
Deletes a node, way, or relation from the map. Use this to remove outdated or incorrect geographic data.
08 Capability
Download changeset
Downloads a changeset in OsmChange format. This is great for local backups or further data processing.

Capability set03 / 09

09—12

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

09 Capability
Get auth user details
Fetches details for the currently authenticated user. Use this to check your current session status.
10 Capability
Get changeset
Reads the details of a specific changeset by its ID. This allows you to inspect the contents of a specific group of edits.
11 Capability
Get element history
Pulls the version history for a node, way, or relation. Use this to see how a specific map feature has changed over time.
12 Capability
Get element
Reads a specific node, way, or relation by its ID. This retrieves the current properties of a single map element.

Capability set04 / 09

13—16

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

13 Capability
Get elements
Fetches multiple nodes, ways, or relations at once. This is faster when you need to pull a list of several map features.
14 Capability
Get gpx data
Downloads data for a specific GPS trace. Use this to retrieve raw coordinates for outdoor activities.
15 Capability
Get gpx metadata
Reads the metadata for a GPS trace. This provides the context and info for your uploaded outdoor traces.
16 Capability
Get inbox
Retrieves the authenticated user's message inbox. Use this to see private messages from other map contributors.

Capability set05 / 09

17—20

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

17 Capability
Get map data
Fetches map data for nodes, ways, and relations within a bounding box. This is the primary way to pull regional data.
18 Capability
Get message
Reads a specific message from your inbox. Use this to view the content of a single private message.
19 Capability
Get note
Reads a specific map note by its ID. Use this to retrieve the details of a saved note.
20 Capability
Get permissions
Checks the OAuth permissions for the authenticated user. Use this to verify what actions your agent can perform.

Capability set06 / 09

21—24

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

21 Capability
Get user preferences
Fetches the preferences for the authenticated user. This allows your agent to see your personal settings.
22 Capability
Get user
Fetches details for a specific user. Use this to look up information about other community members.
23 Capability
List notes
Lists all map notes within a specific bounding box. This helps you find notes related to a specific geographic area.
24 Capability
List user gpx
Lists all GPS traces for the authenticated user. Use this to manage your collection of outdoor activities.

Capability set07 / 09

25—27

3 capabilities in this set.

Part of 33 available through OpenStreetMap.

25 Capability
Query changesets
Queries changesets using specific filters like user or time. This is perfect for monitoring recent mapping activity.
26 Capability
Search notes
Searches for specific map notes. Use this to find a specific note when you only know part of its content.
27 Capability
Send message
Sends a private message to another user. Use this to coordinate with other map contributors.

Capability set08 / 09

28—30

3 capabilities in this set.

Part of 33 available through OpenStreetMap.

28 Capability
Update changeset
Updates the tags of an open changeset. This lets you refine the metadata of your current group of edits.
29 Capability
Update element
Updates an existing node, way, or relation. Use this to fix errors or add new tags to map features.
30 Capability
Update message status
Updates the read status of a message. This helps you track which private messages you have already seen.

Capability set09 / 09

31—33

3 capabilities in this set.

Part of 33 available through OpenStreetMap.

31 Capability
Upload gpx
Uploads a GPS trace in GPX format. Use this to share your outdoor routes with the community or your own records.
32 Capability
Delete message
Removes a message from your inbox. This helps you keep your private communications organized.
33 Capability
Get outbox
Retrieves the authenticated user's message outbox. This shows messages you have sent to other users.

Set up in minutes

One URL. Then ask OpenStreetMap to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use OpenStreetMap from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable OpenStreetMap for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap URL.
Step 03

Save and start

Save the connection and enable OpenStreetMap in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "openstreetmap": {
      "url": "https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap

Open Agent mode in chat and ask: "Using OpenStreetMap, help me...". 33 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "openstreetmap": {
      "url": "https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap

Ask Copilot: "Using OpenStreetMap, help me...". 33 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "openstreetmap": {
      "url": "https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap

Open Cascade and ask: "Using OpenStreetMap, help me...". 33 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "openstreetmap": {
      "url": "https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap

Ask Cline: "Using OpenStreetMap, help me...". 33 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add openstreetmap --transport http "https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/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 OpenStreetMap

Ask Claude: "Using OpenStreetMap, show me...". 33 tools are ready

Where the request belongs

Work OpenStreetMap can move forward.

Built around the request

This is for the GIS analyst tired of manual data exports, the open-source contributor who wants to automate map edits, and the developer building location-aware apps.

01

GIS Analyst

Audits regional map data for accuracy during a busy work week.

02

Open Source Contributor

Manages large-scale map edits and changeset metadata via chat.

03

Location Services Developer

Inspects map element metadata while building out new features.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 11 capabilities

Felt (Collaborative Maps)

Create and manage collaborative maps. upload geographic data, style layers, and manipulate map elements directly from any AI agent.

02 4 capabilities

Overpass

Access OpenStreetMap data via Overpass API. execute complex spatial queries, fetch raw map data, and monitor API status.

03 27 capabilities

Mapbox

Integrate Mapbox mapping and location services into your AI agent—access vector/raster tiles, static images, directions, and manage datasets.

04 6 capabilities

ArcGIS

Access GIS services via ArcGIS. geocode addresses, search places, get routes, check elevation and discover basemap styles from any AI agent.

05 16 capabilities

Overpass (OpenStreetMap)

Search OpenStreetMap data. find restaurants, shops, hospitals, schools, parks, ATMs and more worldwide.

06 10 capabilities

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 OpenStreetMap connected.

Before you connect

Questions about OpenStreetMap.

The practical details behind the request, access and result.

Can the OpenStreetMap MCP help me update map data?

Yes. You can create, update, and delete map elements like roads and points of interest directly through your AI agent.

Can I use the OpenStreetMap MCP to see the history of a specific building?

Yes. Your agent can pull the full version history for any map element to show you how it has changed over time.

Does the OpenStreetMap MCP work for GPS traces?

Yes. You can upload GPX files and retrieve metadata or raw data for GPS traces using the Connector.

How does the OpenStreetMap MCP handle map edits?

It lets you manage changesets, which group your edits together and provide metadata for the OpenStreetMap community.

Can I use the OpenStreetMap MCP to find data in a specific area?

Yes. You can query map data for any specific bounding box to get a list of nodes and ways in that region.

Is the OpenStreetMap MCP good for GIS analysts?

Yes. It helps GIS analysts extract raw data for analysis without needing to perform manual exports from the web interface.

How can I download map data for a specific region?

Use the get_map_data capability by providing a bounding box string (left, bottom, right, top). The agent will retrieve all nodes, ways, and relations within those coordinates.

Can I see who edited a specific road or building?

Yes! Use the get_element_history capability with the element type (node, way, or relation) and its ID. It will return the full version history, including timestamps and user information.

Is it possible to search for recent map updates in a city?

You can use query_changesets with a bbox (bounding box) parameter. This will list all changesets that intersect with that area, allowing you to inspect recent mapping activity.

One connection away

Give your agent a direct line to OpenStreetMap.

Connect OpenStreetMap once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available