MCPMCP Tools/Reference Data/list_states

list_states

Readreference:read

List the states / provinces / regions a location's stateIso can be. Global reference data — no clientId. Pass `country` (two-letter code, e.g. US) to get that country's complete list (the value to send is each entry's `code`). Without `country` all states are returned in pages: pass the previous `nextCursor` as `cursor` to continue. Filter with `search` or `type`.

Parameters
countrystringoptional
Two-letter ISO country code, e.g. US. Omit to list across all countries (paginated).
searchstringoptional
Match state code, name or alias (accent-insensitive)
typestringoptional
Subdivision type, e.g. state, province, prefecture
limitnumberoptional
Page size when `country` is omitted (1–1000, default 200)
cursorstringoptional
`nextCursor` from the previous page
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_states",
    "arguments": {}
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.