geocode
Pack: geoapify · Endpoint: https://gateway.pipeworx.io/geoapify/mcp
Forward geocoding: convert an address, place name, or freeform location text into geographic coordinates (latitude/longitude). Returns matched candidates with formatted address, lat, lon, country, city, and postcode. Example: geocode({ text: “1600 Amphitheatre Parkway, Mountain View, CA” })
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
text | string | yes | Address, place name, or freeform location text to geocode, e.g. “Eiffel Tower, Paris” |
limit | number | no | Maximum number of results to return (default 5) |
_apiKey | string | no | Optional — your own Geoapify API key for higher limits; omit to use the shared Pipeworx key. |
Example call
Arguments
{
"text": "Eiffel Tower, Paris"
}
curl
curl -X POST https://gateway.pipeworx.io/geoapify/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geocode","arguments":{"text":"Eiffel Tower, Paris"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('geocode', {
"text": "Eiffel Tower, Paris"
});
More examples
{
"text": "1600 Amphitheatre Parkway, Mountain View, CA",
"limit": 3
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"geoapify": {
"url": "https://gateway.pipeworx.io/geoapify/mcp"
}
}
}
See Getting Started for client-specific install steps.