geocode_search
Pack: openrouteservice · Endpoint: https://gateway.pipeworx.io/openrouteservice/mcp
“Geocode [address]” / “find [city] coordinates” / “search for places named [X]” / “where is [landmark]” — geocode an address or place name to coordinates via Pelias (OpenStreetMap-backed). Returns ranked candidates with lat/lng, address components, layer (venue/street/locality/region). Use as a free alternative to Mapbox/Google geocoding, or when you want OpenStreetMap-curated data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
text | string | yes | |
sources | string | no | |
layers | string | no | |
size | number | no | |
focus_lat | number | no | |
focus_lon | number | no |
Example call
Arguments
{
"text": "Berlin"
}
curl
curl -X POST https://gateway.pipeworx.io/openrouteservice/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geocode_search","arguments":{"text":"Berlin"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('geocode_search', {
"text": "Berlin"
});
More examples
{
"text": "restaurant",
"focus_lon": 8.681495,
"focus_lat": 49.41461,
"size": 10
}
Response shape
Full JSON Schema
{
"type": "object",
"description": "Geocoding search response from OpenRouteService (Pelias)"
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"openrouteservice": {
"url": "https://gateway.pipeworx.io/openrouteservice/mcp"
}
}
}
See Getting Started for client-specific install steps.