List Provinces or States for a Country
omnial/list-cities
Given an ISO 2-letter country code, returns the list of provinces, states, or major administrative divisions within that country, each with its name and division type. An unrecognized country code returns an empty result rather than an error.
Price
Up to $0.0137 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from AccuWeather.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/list-cities" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/list-cities" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/list-cities", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/list-cities", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0137 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"country_code"
],
"properties": {
"country_code": {
"type": "string",
"description": "ISO 2-letter country code, case-insensitive (e.g., 'tr', 'us', 'gb')"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The province, state, or division's name."
},
"type": {
"type": "string",
"description": "Typically the literal string 'Province/City'; other values are not documented."
}
},
"additionalProperties": true
},
"description": "One entry per province/state/major division. 51 entries observed for 'us' (50 states, the District of Columbia, and one non-state entry for a US territory/base) -- cardinality is whatever the country actually has, not fixed."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "Typically 'success'."
}
},
"description": "The province/state list. An unrecognized country code returns `{}` -- no field here is guaranteed present on every call.",
"additionalProperties": true
}