OpenStreetMap MCP Server for Mastra AIGive Mastra AI instant access to 33 tools to Close Changeset, Close Note, Comment Note, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect OpenStreetMap through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The OpenStreetMap MCP Server for Mastra AI 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
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"openstreetmap": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "OpenStreetMap Agent",
instructions:
"You help users interact with OpenStreetMap " +
"using 33 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with OpenStreetMap?"
);
console.log(result.text);
}
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.
Mastra's agent abstraction provides a clean separation between LLM logic and OpenStreetMap tool infrastructure. Connect 33 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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 Mastra AI 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 Mastra AI
When Mastra AI 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 Mastra AI via MCP
Follow these steps to wire OpenStreetMap into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the OpenStreetMap MCP Server
Mastra AI provides unique advantages when paired with OpenStreetMap through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add OpenStreetMap without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every OpenStreetMap tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
OpenStreetMap + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the OpenStreetMap MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query OpenStreetMap, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed OpenStreetMap as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query OpenStreetMap on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using OpenStreetMap tools alongside other MCP servers
Example Prompts for OpenStreetMap in Mastra AI
Ready-to-use prompts you can give your Mastra AI 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 Mastra AI
Common issues when connecting OpenStreetMap to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpOpenStreetMap + Mastra AI FAQ
Common questions about integrating OpenStreetMap MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Medium Alternative
5 toolsManage your Medium profile — publish stories, audit publications, and contributors via AI.
OpenClassrooms
9 toolsMonitor student progress on OpenClassrooms — search courses, track diploma paths, review mentoring sessions, and verify certificates from any AI agent.
Kong Gateway
40 toolsManage your API Gateway infrastructure — list services, configure routes, and manage consumers or plugins directly from any AI agent.
Marketo
11 toolsAutomate marketing workflows via Marketo — manage leads, lists, campaigns, and programs.