490+ economic & demographic indicators for 218 countries from IMF, World Bank, UN, FRED.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional API key. Anonymous access is rate-limited to 1,000 requests/day per IP. Get a free key (same limit, usage dashboard) or upgrade to Pro/Business at https://statisticsoftheworld.com/pricing.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Compare 2-10 countries on selected indicators.
List of country codes (max 10)
Indicator IDs to compare (default: GDP, population, life expectancy, etc.)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Compare 2-10 countries on selected indicators.
| Argument | Type | Description |
|---|---|---|
| country_ids* | array | List of country codes (max 10) |
| indicator_ids | array | Indicator IDs to compare (default: GDP, population, life expectancy, etc.) |
{
"type": "object",
"required": [
"country_ids"
],
"properties": {
"country_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of country codes (max 10)"
},
"indicator_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Indicator IDs to compare (default: GDP, population, life expectancy, etc.)"
}
}
}Compare source readings. Default mode returns latest IMF, World Bank and UN readings with their own years. For the 20-economy, 10-concept research pilot, provide country_id and year (exact year or common) to compare IMF and World Bank in the same period, inspect definition mismatches and retrieve recorded-state provenance. Optional as_of and revision pin SOTW stored state, not publisher availability.
| Argument | Type | Description |
|---|---|---|
| year | any | Opt into the research pilot: exact year or latest common past year. Requires country_id. |
| as_of | string | Optional SOTW recording cutoff: date at UTC midnight or ISO timestamp with timezone. Publisher availability is not established. |
| revision | string | Archive transaction watermark returned by an earlier comparison. Requires as_of. |
| country_id | string | Optional ISO3 code to return a single country instead of all |
| indicator_id* | string | Concept key, e.g. IMF.NGDPD (GDP), IMF.NGDPDPC (GDP per capita), IMF.NGDP_RPCH (real growth) |
| processing_version | string | Pin the comparison processing contract. |
{
"type": "object",
"required": [
"indicator_id"
],
"properties": {
"year": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 1960
},
{
"enum": [
"common"
],
"type": "string"
}
],
"description": "Opt into the research pilot: exact year or latest common past year. Requires country_id."
},
"as_of": {
"type": "string",
"description": "Optional SOTW recording cutoff: date at UTC midnight or ISO timestamp with timezone. Publisher availability is not established."
},
"revision": {
"type": "string",
"description": "Archive transaction watermark returned by an earlier comparison. Requires as_of."
},
"country_id": {
"type": "string",
"description": "Optional ISO3 code to return a single country instead of all"
},
"indicator_id": {
"type": "string",
"description": "Concept key, e.g. IMF.NGDPD (GDP), IMF.NGDPDPC (GDP per capita), IMF.NGDP_RPCH (real growth)"
},
"processing_version": {
"enum": [
"source-comparison-v1"
],
"type": "string",
"description": "Pin the comparison processing contract."
}
}
}List all available indicators grouped by category.
| Argument | Type | Description |
|---|---|---|
| category | string | Optional: filter by category name |
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "Optional: filter by category name"
}
}
}Read the reviewed SEC company catalog, or exact issuer/concept facts with exact decimal strings, fiscal contexts, filing dates, units and immutable acquisition evidence. Publication pins guard current registry coherence; they do not reconstruct a full historical filing snapshot. No inferred quarters or currency conversions.
| Argument | Type | Description |
|---|---|---|
| to | string | |
| cik | string | |
| tag | string | |
| from | string | |
| limit | integer | |
| evidence | string | |
| filed_to | string | |
| filed_from | string | |
| publication | string |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"cik": {
"type": "string",
"pattern": "^[0-9]{10}$"
},
"tag": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"evidence": {
"type": "string"
},
"filed_to": {
"type": "string"
},
"filed_from": {
"type": "string"
},
"publication": {
"type": "string"
}
},
"additionalProperties": false
}List all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital).
| Argument | Type | Description |
|---|---|---|
| region | string | Optional: filter by region |
{
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "Optional: filter by region"
}
}
}Get all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more.
| Argument | Type | Description |
|---|---|---|
| country_id* | string | ISO 3166-1 alpha-3 code (e.g., USA, CAN, GBR, CHN, JPN, DEU) |
{
"type": "object",
"required": [
"country_id"
],
"properties": {
"country_id": {
"type": "string",
"description": "ISO 3166-1 alpha-3 code (e.g., USA, CAN, GBR, CHN, JPN, DEU)"
}
}
}Inspect reviewed macro country-level freshness, source import ages and separately measured public operating probes. matrix=true returns actual definition/geography pairs. Reference-age screens are not publisher deadlines. A single VPS observer is not external uptime monitoring.
| Argument | Type | Description |
|---|---|---|
| geo | string | |
| matrix | boolean | |
| series_id | string |
{
"type": "object",
"properties": {
"geo": {
"type": "string"
},
"matrix": {
"type": "boolean"
},
"series_id": {
"type": "string"
}
},
"additionalProperties": false
}Read reviewed GDP, inflation, jobs, trade, production, energy and credit packs with exact definitions, complete source flags, national qualifiers and observation-bound evidence. Set catalog=true to browse; otherwise provide an exact series_id and latest=true for its complete geography cohort or geo for history. Unreliable publisher values are withheld with raw_value retained. Reference periods and source publishing schedules vary.
| Argument | Type | Description |
|---|---|---|
| to | string | |
| geo | string | |
| from | string | |
| as_of | string | Exact timestamp with timezone, up to six fractional digits. SOTW recorded transactions only. |
| limit | integer | |
| format | string | |
| latest | boolean | |
| catalog | boolean | |
| recorded | boolean | |
| revision | string | Positive bigint string returned by recorded_state. Preserve as text. |
Get historical time series (20+ years) for a country and indicator pair.
| Argument | Type | Description |
|---|---|---|
| country_id* | string | ISO 3166-1 alpha-3 code |
| indicator_id* | string | Indicator ID |
{
"type": "object",
"required": [
"indicator_id",
"country_id"
],
"properties": {
"country_id": {
"type": "string",
"description": "ISO 3166-1 alpha-3 code"
},
"indicator_id": {
"type": "string",
"description": "Indicator ID"
}
}
}Rank countries by an indicator available to the caller's tier. Supports top N and bottom N queries.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of results (default 10) |
| order | string | "desc" for highest first, "asc" for lowest first |
| indicator_id* | string | Indicator ID. GDP accepts IMF.NGDPD or the World Bank original NY.GDP.MKTP.CD; also e.g. SP.POP.TOTL for population, FP.CPI.TOTL.ZG for inflation. Call get_available_indicators or search_indicators to browse the listed catalog. |
{
"type": "object",
"required": [
"indicator_id"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of results (default 10)"
},
"order": {
"enum": [
"desc",
"asc"
],
"type": "string",
"description": "\"desc\" for highest first, \"asc\" for lowest first"
},
"indicator_id": {
"type": "string",
"description": "Indicator ID. GDP accepts IMF.NGDPD or the World Bank original NY.GDP.MKTP.CD; also e.g. SP.POP.TOTL for population, FP.CPI.TOTL.ZG for inflation. Call get_available_indicators or search_indicators to browse the listed catalog."
}
}
}Read forward sampled pool states or perpetual midpoints, including quiet/unavailable states and separate definition versions. These are sampled quotes rather than trades or cash-security OHLC. Requires exact market, symbol and UTC from/to timestamps, maximum 31 days. No history is inferred before collection began.
| Argument | Type | Description |
|---|---|---|
| to* | string | |
| from* | string | |
| limit | integer | |
| market* | string | |
| symbol* | string |
{
"type": "object",
"required": [
"market",
"symbol",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 5000,
"minimum": 1
},
"market": {
"enum": [
"pools",
"derivatives"
],
"type": "string"
},
"symbol": {
"type": "string"
}
},
"additionalProperties": false
}Read SOTW-computed public onchain prices. market=pools (default) reads Uniswap/Raydium/PancakeSwap token pools in USDC (BNB uses Binance-Peg USD Coin). market=derivatives reads Hyperliquid perpetual bid/ask midpoints with original units, source time, spread and depth checks. Instruments are distinct from linked cash securities, bullion benchmarks, indices and official yields. Unavailable prices are null. Set catalog=true to list reviewed contracts without source reads.
| Argument | Type | Description |
|---|---|---|
| market | string | |
| catalog | boolean | |
| symbols | array | Case-sensitive token symbols (PAXG, AAPLx, SLVon) or exact perpetual IDs (xyz:SILVER, xyz:CL, para:10Y). |
| category | string |
{
"type": "object",
"properties": {
"market": {
"enum": [
"pools",
"derivatives"
],
"type": "string",
"default": "pools"
},
"catalog": {
"type": "boolean"
},
"symbols": {
"type": "array",
"items": {
"type": "string"
},
"description": "Case-sensitive token symbols (PAXG, AAPLx, SLVon) or exact perpetual IDs (xyz:SILVER, xyz:CL, para:10Y)."
},
"category": {
"enum": [
"crypto",
"stablecoin",
"tokenized-gold",
"tokenized-equity",
"tokenized-etf",
"equities",
"etfs",
"commodities",
"currencies",
"indices",
"rates"
],
"type": "string"
}
}
}Institutional release schedules with primary source URLs. Date-passed status does not confirm publication. Related series readings are current stored values for the period each release covers (periodBasis says how it was chosen); they may have been revised since, and their match to the figure published that day is not verified.
| Argument | Type | Description |
|---|---|---|
| to | string | End date YYYY-MM-DD (default: +180 days) |
| from | string | Start date YYYY-MM-DD (default: today) |
| limit | number | Max events (default 100) |
| country | string | Optional: US, CA, EU, or Global |
| institution | string | Optional: ECB, BOC, BEA, BLS, EUROSTAT, IMF, G7, G20 |
| report_type | string | Optional: policy_decision, data_release, flagship_report, or meeting |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "End date YYYY-MM-DD (default: +180 days)"
},
"from": {
"type": "string",
"description": "Start date YYYY-MM-DD (default: today)"
},
"limit": {
"type": "number",
"description": "Max events (default 100)"
},
"country": {
"type": "string",
"description": "Optional: US, CA, EU, or Global"
},
"institution": {
"type": "string",
"description": "Optional: ECB, BOC, BEA, BLS, EUROSTAT, IMF, G7, G20"
},
"report_type": {
"type": "string",
"description": "Optional: policy_decision, data_release, flagship_report, or meeting"
}
}
}High-frequency (daily/weekly/monthly) series: US Treasury yield curve (UST.YC.3M … UST.YC.30Y), SOFR/EFFR/OBFR, CORRA and GoC yields, central bank policy rates for ~38 economies (BIS.CBPOL.M/D), monthly CPI inflation for ~190 countries (IMF.CPI.YOY.M, IMF.CPI.FOOD.YOY.M), monthly 10-year government bond yields for 40+ countries (OECD.IRLT.10Y), monthly unemployment (ILO.UNEMP.RT.M, EUROSTAT.UNEMP.RT.M), Eurostat HICP/industrial production/retail (EUROSTAT.*.M), monthly electricity (EMBER.ELEC.*.M), and daily shipping chokepoint transits plus weekly port trade volumes (PORTWATCH.*). Call list_series to browse. Every response carries source licence and attribution.
| Argument | Type | Description |
|---|---|---|
| geo | string | ISO3 country code (e.g. USA, DEU). Omit with latest=true for a cross-country view. |
| from | string | Start date YYYY-MM-DD |
| limit | number | Max observations (default 120, maximum 2000). The response sets truncated=true when more observations match. |
| latest | boolean | true: newest stored observation for every geography. Do not combine with geo, from or limit; reference periods can differ. |
| series_id* | string | Series ID, e.g. UST.YC.10Y, OECD.IRLT.10Y, ILO.UNEMP.RT.M |
{
"type": "object",
"required": [
"series_id"
],
"properties": {
"geo": {
"type": "string",
"description": "ISO3 country code (e.g. USA, DEU). Omit with latest=true for a cross-country view."
},
"from": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"limit": {
"type": "number",
"description": "Max observations (default 120, maximum 2000). The response sets truncated=true when more observations match."
},
"latest": {
"type": "boolean",
"description": "true: newest stored observation for every geography. Do not combine with geo, from or limit; reference periods can differ."
},
"series_id": {
"type": "string",
"description": "Series ID, e.g. UST.YC.10Y, OECD.IRLT.10Y, ILO.UNEMP.RT.M"
}
}
}List the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each.
No arguments.
{
"type": "object",
"properties": {}
}Search annual indicators, qualified economic definitions, other source time series, onchain instruments and companies. Preserve kind, exact identity, units and source terms. geo filters historical source membership in economic and series results; it does not establish freshness or reviewed national definitions. Retain version when paging.
| Argument | Type | Description |
|---|---|---|
| geo | string | |
| kind | string | |
| page | integer | |
| limit | integer | |
| query | string | |
| market | string | |
| source | string | |
| version | string |
{
"type": "object",
"properties": {
"geo": {
"type": "string"
},
"kind": {
"enum": [
"annual",
"economic",
"series",
"onchain",
"company"
],
"type": "string"
},
"page": {
"type": "integer",
"minimum": 1
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string"
},
"market": {
"enum": [
"pools",
"derivatives"
],
"type": "string"
},
"source": {
"type": "string"
},
"version": {
"type": "string"
}
},
"additionalProperties": false
}Search for indicators by keyword. Use when you need to find the right indicator ID.
| Argument | Type | Description |
|---|---|---|
| query* | string | Search term (e.g., "gdp", "population", "education", "co2") |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search term (e.g., \"gdp\", \"population\", \"education\", \"co2\")"
}
}
}| series_id | string |
| generation | string |
{
"type": "object",
"properties": {
"to": {
"type": "string"
},
"geo": {
"type": "string"
},
"from": {
"type": "string"
},
"as_of": {
"type": "string",
"description": "Exact timestamp with timezone, up to six fractional digits. SOTW recorded transactions only."
},
"limit": {
"type": "integer",
"maximum": 20000,
"minimum": 1
},
"format": {
"enum": [
"json",
"manifest"
],
"type": "string"
},
"latest": {
"type": "boolean"
},
"catalog": {
"type": "boolean"
},
"recorded": {
"type": "boolean"
},
"revision": {
"type": "string",
"description": "Positive bigint string returned by recorded_state. Preserve as text."
},
"series_id": {
"type": "string"
},
"generation": {
"type": "string"
}
},
"additionalProperties": false
}