`words_to_coords`

Pack: what3words · Endpoint: https://gateway.pipeworx.io/what3words/mcp

Convert a 3-word address (“filled.count.soap”) to a lat/lon centre + 3m×3m bounding box.

Parameters

Name	Type	Required	Description
`words`	string	yes	Three-word address (dot-separated)

Example call

Arguments

{
  "words": "filled.count.soap"
}

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":"words_to_coords","arguments":{"words":"filled.count.soap"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('words_to_coords', {
  "words": "filled.count.soap"
});

More examples

{
  "words": "index.home.raft"
}

Response shape

Always returns: words, latitude, longitude, square_sw, square_ne, country, nearest_place, map_url

Field	Type	Description
`words`	string	The 3-word address input
`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",
      "description": "The 3-word address input"
    },
    "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",
    "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.

words_to_coords