Open Datasets
World cities, countries and other open datasets with filters, licence and attribution.
Static Knowledge Base: open, commercially reusable datasets (world cities, countries, ISHOB topics) by page, by id or by facet filter, with licence and attribution. Free catalogue: /v1/datasets.
What agents use it for
- Reference data for agents (cities, countries)
- Filter by country or facet
- Commercially reusable data with attribution
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Dataset key from /v1/datasets, e.g. world-cities, countries, archive-topics |
page | integer | no | Page number (default 0) |
id | string | no | Return one record by id |
country_code | string | no | Facet filter (world-cities), e.g. FR |
continent | string | no | Facet filter (countries), e.g. Europe |
Call it
{
"name": "get_dataset",
"arguments": {
"key": "world-cities",
"country_code": "FR"
}
}curl -i "https://api.ishob.com/v1/dataset/world-cities?country_code=FR"
Paid with x402: the first call returns HTTP 402 with the price; an x402 client (for example @x402/fetch or @x402/mcp) signs a USDC payment and retries. Calls that fail are not charged.
Connect the MCP server: setup for Claude, Cursor and other clients.