geocode
Pack: ban-fr · Endpoint: https://gateway.pipeworx.io/ban-fr/mcp
Forward-geocode a French address, street, locality or commune. Returns scored GeoJSON matches (score 0-1) with label, coordinates, postcode, citycode (INSEE) and context. France only.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | yes | Free-text query, e.g. “8 bd du port” or “rue de la paix paris”. |
limit | number | no | Max results (default 5, server caps at 20). |
type | string | no | Restrict to a feature type. |
postcode | string | no | Filter by 5-digit postal code, e.g. “95000”. |
citycode | string | no | Filter by INSEE commune code, e.g. “95127”. |
autocomplete | boolean | no | Treat q as a partial/autocomplete prefix (default false). |
lat | number | no | Latitude to bias/prioritise results geographically (pair with lon). |
lon | number | no | Longitude to bias/prioritise results geographically (pair with lat). |
Example call
curl -X POST https://gateway.pipeworx.io/ban-fr/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geocode","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"ban-fr": {
"url": "https://gateway.pipeworx.io/ban-fr/mcp"
}
}
}See Getting Started for client-specific install steps.