OpenStreetMap MCP Server for Vercel AI SDKGive Vercel AI SDK instant access to 33 tools to Close Changeset, Close Note, Comment Note, and more
GDPR Free for SubscribersThe Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect OpenStreetMap through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
Ask AI about this MCP Server for Vercel AI SDK
The OpenStreetMap MCP Server for Vercel AI 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
Geminiimport { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using OpenStreetMap, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
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 Vercel AI SDK gives every OpenStreetMap tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 33 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
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 Vercel AI 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 Vercel AI SDK
When Vercel AI 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 Vercel AI SDK via MCP
Follow these steps to wire OpenStreetMap into Vercel AI SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @ai-sdk/mcp ai @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the script
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Vercel AI SDK with the OpenStreetMap MCP Server
Vercel AI SDK provides unique advantages when paired with OpenStreetMap through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same OpenStreetMap integration everywhere
Built-in streaming UI primitives let you display OpenStreetMap tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
OpenStreetMap + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the OpenStreetMap MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query OpenStreetMap in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate OpenStreetMap tools and return structured JSON responses to any frontend
Chatbots with tool use: embed OpenStreetMap capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with OpenStreetMap through natural language queries
Example Prompts for OpenStreetMap in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI 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 Vercel AI SDK
Common issues when connecting OpenStreetMap to Vercel AI SDK through Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpOpenStreetMap + Vercel AI SDK FAQ
Common questions about integrating OpenStreetMap MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Explore More MCP Servers
View all →
Couchbase (Vector & NoSQL)
7 toolsManage vector search and NoSQL via Couchbase — execute N1QL queries, perform KNN vector searches, and audit documents directly from any AI agent.
Airbnb
12 toolsSearch and manage Airbnb listings, experiences, reservations, and pricing directly from any AI agent.
Coding.net
10 toolsAll-in-one DevOps platform — manage projects, repositories, and issues via AI.
Bird (MessageBird)
10 toolsUnified communications platform for SMS, WhatsApp, Email, and Voice — manage conversations and contacts at scale.