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.