OpenStreetMap MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 33 tools to Close Changeset, Close Note, Comment Note, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect OpenStreetMap through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The OpenStreetMap MCP Server for OpenAI Agents SDK is a standout in the Data Management category — giving your AI agent 33 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="OpenStreetMap Assistant",
instructions=(
"You help users interact with OpenStreetMap. "
"You have access to 33 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from OpenStreetMap"
)
print(result.final_output)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About OpenStreetMap MCP Server
Connect your AI agent to the world's largest open geographic database. This server enables full interaction with the OpenStreetMap API (v0.6), allowing you to query, create, and update geospatial data through natural conversation.
The OpenAI Agents SDK auto-discovers all 33 tools from OpenStreetMap through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries OpenStreetMap, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Map Data Retrieval — Fetch raw OSM data (nodes, ways, relations) within specific bounding boxes for analysis or visualization.
- Element Management — Create, read, update, or delete map elements including points of interest (nodes), roads (ways), and complex boundaries (relations).
- Changeset Workflows — Open, update, and close changesets to group your edits and provide meaningful metadata to the OSM community.
- Historical Analysis — Retrieve the full version history of any map element to track changes over time.
- Advanced Querying — Filter changesets by user, time range, or geographic area to monitor local mapping activity.
The OpenStreetMap MCP Server exposes 33 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 33 OpenStreetMap tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to OpenStreetMap through Vinkius, your AI agent gets direct access to every tool listed below — spanning geospatial, map-data, cartography, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Close changeset on OpenStreetMap
Close a changeset
Close note on OpenStreetMap
Close a map note
Comment note on OpenStreetMap
Add a comment to an existing map note
Create changeset on OpenStreetMap
Create a new changeset
Create element on OpenStreetMap
Create a new node, way, or relation
Create note on OpenStreetMap
Create a new map note
Delete element on OpenStreetMap
Delete a node, way, or relation
Delete message on OpenStreetMap
Delete a message
Download changeset on OpenStreetMap
Download a changeset in OsmChange format
Get auth user details on OpenStreetMap
Get details for the authenticated user
Get changeset on OpenStreetMap
Read a changeset by ID
Get element on OpenStreetMap
Read a node, way, or relation by ID
Get element history on OpenStreetMap
Get the history of a node, way, or relation
Get elements on OpenStreetMap
Multi-fetch nodes, ways, or relations
Get gpx data on OpenStreetMap
Download data for a GPS trace
Get gpx metadata on OpenStreetMap
Read metadata for a GPS trace
Get inbox on OpenStreetMap
Get the authenticated user's message inbox
Get map data on OpenStreetMap
Get map data (nodes, ways, relations) within a bounding box
Get message on OpenStreetMap
Read a specific message
Get note on OpenStreetMap
Read a map note by ID
Get outbox on OpenStreetMap
Get the authenticated user's message outbox
Get permissions on OpenStreetMap
Get OAuth permissions for the authenticated user
Get user on OpenStreetMap
Get details for a specific user
Get user preferences on OpenStreetMap
Get preferences for the authenticated user
List notes on OpenStreetMap
List map notes within a bounding box
List user gpx on OpenStreetMap
List GPS traces for the authenticated user
Query changesets on OpenStreetMap
Query changesets with filters
Search notes on OpenStreetMap
Search for map notes
Send message on OpenStreetMap
Send a private message to another user
Update changeset on OpenStreetMap
Update tags of an open changeset
Update element on OpenStreetMap
Update an existing node, way, or relation
Update message status on OpenStreetMap
Update the read status of a message
Upload gpx on OpenStreetMap
Upload a GPS trace (GPX)
Connect OpenStreetMap to OpenAI Agents SDK via MCP
Follow these steps to wire OpenStreetMap into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the OpenStreetMap MCP Server
OpenAI Agents SDK provides unique advantages when paired with OpenStreetMap through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
OpenStreetMap + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the OpenStreetMap MCP Server delivers measurable value.
Automated workflows: build agents that query OpenStreetMap, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries OpenStreetMap, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through OpenStreetMap tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query OpenStreetMap to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for OpenStreetMap in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with OpenStreetMap immediately.
"Get map data for the bounding box -0.15, 51.50, -0.10, 51.52 (Central London)."
"Show me the history of way ID 4225123."
"Find the 5 most recent closed changesets by user 'JohnDoe'."
Troubleshooting OpenStreetMap MCP Server with OpenAI Agents SDK
Common issues when connecting OpenStreetMap to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
OpenStreetMap + OpenAI Agents SDK FAQ
Common questions about integrating OpenStreetMap MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
GPTBots
8 toolsManage your conversational AI agents, workflows, and knowledge bases via AI.

Bugcrowd
10 toolsManage crowdsourced security via Bugcrowd — track submissions, programs, and targets directly from any AI agent.

Softinn
10 toolsOrchestrate Softinn Hotel PMS — manage reservations, rooms, and guest folios directly from any AI agent.

Storyblok
9 toolsConnect your AI to Storyblok. Manage content spaces, craft data stories, and orchestrate headless CMS elements effortlessly.
