An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect OpenStreetMap to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Edit and query the world's largest open map directly from your agent.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 33 capabilities

We ship only the actions that matter.

Capability set01 / 09

01-04

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 01

    Close note

    Closes a specific map note.

  2. 02

    Comment note

    Adds a comment to an existing map note.

  3. 03

    Create changeset

    Starts a new changeset to group your map edits.

  4. 04

    Create note

    Creates a new map note for the community.

Capability set02 / 09

05-08

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 05

    Delete element

    Removes a node, way, or relation from the map.

  2. 06

    Download changeset

    Downloads a changeset in OsmChange format.

  3. 07

    Get auth user details

    Retrieves details for the currently authenticated user.

  4. 08

    Get element

    Reads a single node, way, or relation by its ID.

Capability set03 / 09

09-12

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 09

    Get element history

    Fetches the version history for a specific map element.

  2. 10

    Get elements

    Fetches multiple nodes, ways, or relations at once.

  3. 11

    Get gpx data

    Downloads data for a specific GPS trace.

  4. 12

    Get gpx metadata

    Reads metadata associated with a GPS trace.

Capability set04 / 09

13-16

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 13

    Get inbox

    Accesses the authenticated user's message inbox.

  2. 14

    Get map data

    Retrieves map elements within a specified bounding box.

  3. 15

    Get message

    Reads a specific message from the inbox.

  4. 16

    Get permissions

    Checks the OAuth permissions for the authenticated user.

Capability set05 / 09

17-20

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 17

    Get user preferences

    Retrieves the preferences for the authenticated user.

  2. 18

    Get user

    Gets details for a specific OSM user.

  3. 19

    Search notes

    Searches for map notes based on your criteria.

  4. 20

    Send message

    Sends a private message to another OSM user.

Capability set06 / 09

21-24

4 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 21

    Update changeset

    Updates the tags on an open changeset.

  2. 22

    Update element

    Modifies an existing node, way, or relation.

  3. 23

    Upload gpx

    Uploads a GPX file as a GPS trace.

  4. 24

    Delete message

    Deletes a message from the inbox.

Capability set07 / 09

25-27

3 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 25

    Get outbox

    Accesses the authenticated user's sent messages.

  2. 26

    Close changeset

    Closes an active changeset.

  3. 27

    Create element

    Adds a new node, way, or relation to the map.

Capability set08 / 09

28-30

3 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 28

    Get changeset

    Reads the details of a specific changeset by ID.

  2. 29

    Get note

    Reads a specific map note by its ID.

  3. 30

    List notes

    Lists map notes found within a bounding box.

Capability set09 / 09

31-33

3 capabilities in this set.

Part of 33 available through OpenStreetMap.

  1. 31

    List user gpx

    Lists all GPS traces for the authenticated user.

  2. 32

    Query changesets

    Filters and queries changesets using specific criteria.

  3. 33

    Update message status

    Changes the read status of a message.

Real work

What teams actually run

01

Data Auditing

Check the history of a specific road or building to see when it was last modified.

02

Rapid Mapping

Create new nodes or ways to add missing points of interest to the map.

03

Regional Analysis

Fetch all map elements within a specific coordinate bounding box for study.

04

Trace Management

Upload GPX files to the map to contribute GPS track data.

Automate a task

Put OpenStreetMap to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

OpenStreetMap works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put OpenStreetMap to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1118ms average. Fast in production.

OpenStreetMap is checked daily against the live service.

Daily averagePeak 1332ms
Oct 3Today
Fastest day
831ms
Slowest day
1332ms
14-day trend
Improving-7%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 33 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of OpenStreetMap, so you can see the experience inside your AI.

It does not authenticate your account with OpenStreetMap. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

OpenStreetMap Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — OpenStreetMap capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "openstreetmap-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lYsdJXjQWE6aDpvmlzimYbbJoVMB0mBSaq4KoX0x/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up OpenStreetMap in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work OpenStreetMap owners hand off.

This MCP is built for anyone working with open-source geographic data who wants to bypass manual web interfaces.

  • 01

    GIS Analysts

    They use the agent to extract specific regional data without manual exports.

  • 02

    Open Source Contributors

    They automate map element creation and changeset management via chat.

  • 03

    Developers

    They inspect element metadata and history while building location-based apps.

FAQ

Questions OpenStreetMap owners ask.

  • 01

    How do I connect my OpenStreetMap account?

    You need to provide your OpenStreetMap OAuth Token to the MCP after subscribing on Vinkius.

  • 02

    Which AI clients can use this MCP?

    You can use this MCP with any compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I actually edit the map with my agent?

    Yes, you can create, update, or delete nodes, ways, and relations directly through your agent.

  • 04

    Does this MCP handle GPS data?

    Yes, it includes capabilities to upload GPX traces and download GPS data or metadata.

  • 05

    Can I manage my OSM messages?

    Yes, the MCP allows you to access your inbox, read messages, and send private messages to other users.

  • 06

    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.

  • 07

    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.

  • 08

    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.

Explore

More in Data Management

Suggestions

Connect OpenStreetMap to Claude, Cursor, ChatGPT & more