coords_to_words
Pack: what3words · Endpoint: https://gateway.pipeworx.io/what3words/mcp
Convert a lat/lon to a what3words 3-word address. Defaults to English; pass a 2-letter language code for other languages.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
latitude | number | yes | Latitude |
longitude | number | yes | Longitude |
language | string | no | 2-letter language code (default “en”) |
Example call
Arguments
{
"latitude": 51.520847,
"longitude": -0.195521
}
curl
curl -X POST https://gateway.pipeworx.io/what3words/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"coords_to_words","arguments":{"latitude":51.520847,"longitude":-0.195521}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('coords_to_words', {
"latitude": 51.520847,
"longitude": -0.195521
});
More examples
{
"latitude": 40.7128,
"longitude": -74.006,
"language": "es"
}
Response shape
Always returns: words, language, latitude, longitude, square_sw, square_ne, country, nearest_place, map_url
| Field | Type | Description |
|---|---|---|
words | string | null | The 3-word address (e.g., ‘filled.count.soap’) |
language | string | null | Language code used for the words |
latitude | number | null | Latitude of the 3m×3m square center |
longitude | number | null | Longitude of the 3m×3m square center |
square_sw | object | null | Southwest corner of bounding box |
square_ne | object | null | Northeast corner of bounding box |
country | string | null | Country name containing the address |
nearest_place | string | null | Nearest place name to the address |
map_url | string | null | URL to view the address on what3words map |
Full JSON Schema
{
"type": "object",
"properties": {
"words": {
"type": [
"string",
"null"
],
"description": "The 3-word address (e.g., 'filled.count.soap')"
},
"language": {
"type": [
"string",
"null"
],
"description": "Language code used for the words"
},
"latitude": {
"type": [
"number",
"null"
],
"description": "Latitude of the 3m×3m square center"
},
"longitude": {
"type": [
"number",
"null"
],
"description": "Longitude of the 3m×3m square center"
},
"square_sw": {
"type": [
"object",
"null"
],
"properties": {
"lat": {
"type": "number",
"description": "Southwest corner latitude"
},
"lng": {
"type": "number",
"description": "Southwest corner longitude"
}
},
"description": "Southwest corner of bounding box"
},
"square_ne": {
"type": [
"object",
"null"
],
"properties": {
"lat": {
"type": "number",
"description": "Northeast corner latitude"
},
"lng": {
"type": "number",
"description": "Northeast corner longitude"
}
},
"description": "Northeast corner of bounding box"
},
"country": {
"type": [
"string",
"null"
],
"description": "Country name containing the address"
},
"nearest_place": {
"type": [
"string",
"null"
],
"description": "Nearest place name to the address"
},
"map_url": {
"type": [
"string",
"null"
],
"description": "URL to view the address on what3words map"
}
},
"required": [
"words",
"language",
"latitude",
"longitude",
"square_sw",
"square_ne",
"country",
"nearest_place",
"map_url"
]
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"what3words": {
"url": "https://gateway.pipeworx.io/what3words/mcp"
}
}
}
See Getting Started for client-specific install steps.