DocumentationNatural Language Search · Places · Studio →
Developer automation
Use the CLI and remote MCP with your existing API key.
AI Assistant
Business includes 1,000 shared AI operations per monthly billing period. No rollover or automatic overage charges.
A successful search uses 1 AI operation and 2 standard API credits.
AI Search
osrmroute search --json '{"q":"Find cafes near Berlin", "ai":true}'AI Studio
osrmroute style-preview --json '{"prompt":"A calm dark map with blue water", "ai":true}'OSRMRoute CLI
Install the source package from our website; Node.js 24 or newer. npm registry publication is separate.
Terminal
npm install -g https://osrmroute.com/downloads/osrmroute-cli-1.0.1.tgz
export OSRMROUTE_API_KEY="YOUR_KEY"
osrmroute geocode --json '{"q":"Berlin"}'
osrmroute search --json '{"q":"cafes near Berlin within 2 km"}'
osrmroute styles
osrmroute --helpRemote MCP
Stateless Streamable HTTP. Configure the endpoint and an Authorization Bearer header in a compatible client. No OAuth discovery or SSE subscriptions.
Normal API scopes, credit charges and limits apply. Studio requires an explicit studio scope. MCP tools cannot publish or delete resources.
Streamable HTTP
Endpoint: https://osrmroute.com/api/mcp
Authorization: Bearer $OSRMROUTE_API_KEY
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-06-18initialize
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "example",
"version": "1.0.0"
}
}
}tools/call
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "natural_search",
"arguments": {
"q": "cafes near Berlin"
}
}
}Available MCP tools
place_detailsget_routedistance_matrixreverse_geocodeautocomplete_addressget_timezoneget_isochroneoptimize_routegeocode_addressnatural_searchsuggest_addressesretrieve_placestructured_geocodeplaces_along_routestatic_maplist_styleslist_datasetspreview_style