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

NameTypeRequiredDescription
latitudenumberyesLatitude
longitudenumberyesLongitude
languagestringno2-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

FieldTypeDescription
wordsstring | nullThe 3-word address (e.g., ‘filled.count.soap’)
languagestring | nullLanguage code used for the words
latitudenumber | nullLatitude of the 3m×3m square center
longitudenumber | nullLongitude of the 3m×3m square center
square_swobject | nullSouthwest corner of bounding box
square_neobject | nullNortheast corner of bounding box
countrystring | nullCountry name containing the address
nearest_placestring | nullNearest place name to the address
map_urlstring | nullURL 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.

Regenerated from source · build July 6, 2026