Statistics of the World

com.statisticsoftheworld/sotw

Connects Claude Desktop, Cursor, Cline, or any MCP client to 443 economic and demographic indicators across 218 countries, pulling from IMF, World Bank, UN, FRED, and OECD. You get seven tools: country overviews with AI narratives, indicator rankings, historical time series going back 20+ years, multi-country comparisons, indicator search, and full country lists. Every response includes source attribution and data vintage so your agent can cite properly. Free tier gives you 1,000 requests per day with no API key required for testing, or grab a free developer key for tracking. Reach for this when you need your agent to answer GDP, inflation, population, or debt questions with real, attributed data instead of hallucinating numbers.

tools: 17
auth: Secret needed
transport: HTTP
last updated: Oct 27, 2026

Open website

Install

From registry metadata

$ npx add-mcp https://statisticsoftheworld.com/api/mcp --name sotw --header 'X-API-Key: ${X_API_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http sotw https://statisticsoftheworld.com/api/mcp --header 'X-API-Key: YOUR_X_API_KEY'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 17 tools

Verified live against the running server on Nov 6, 2026.

search_dataSearch 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 freshnes...8 params

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 freshnes...

Parameters* required

geostring

kindstring

one of annual · economic · series · onchain · company

limitinteger

marketstring

one of pools · derivatives

pageinteger

querystring

sourcestring

versionstring

get_company_factsRead 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 snapsho...9 params

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 snapsho...

Parameters* required

cikstring

evidencestring

filed_fromstring

filed_tostring

fromstring

limitinteger

publicationstring

tagstring

tostring

get_data_statusInspect 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.3 params

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.

Parameters* required

geostring

matrixboolean

series_idstring

get_market_historyRead 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 histor...5 params

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 histor...

Parameters* required

from*string

limitinteger

market*string

one of pools · derivatives

symbol*string

to*string

get_economic_dataRead 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 g...12 params

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 g...

Parameters* required

as_ofstring

Exact timestamp with timezone, up to six fractional digits. SOTW recorded transactions only.

catalogboolean

formatstring

one of json · manifest

fromstring

generationstring

geostring

latestboolean

limitinteger

recordedboolean

revisionstring

Positive bigint string returned by recorded_state. Preserve as text.

series_idstring

tostring

get_onchain_quotesRead 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. I...4 params

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. I...

Parameters* required

catalogboolean

categorystring

one of crypto · stablecoin · tokenized-gold · tokenized-equity · tokenized-etf · equities

marketstring

one of pools · derivativesdefault: pools

symbolsarray

Case-sensitive token symbols (PAXG, AAPLx, SLVon) or exact perpetual IDs (xyz:SILVER, xyz:CL, para:10Y).

get_country_overviewGet all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more.1 params

Get all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more.

Parameters* required

country_id*string

ISO 3166-1 alpha-3 code (e.g., USA, CAN, GBR, CHN, JPN, DEU)

get_indicator_rankingRank countries by an indicator available to the caller's tier. Supports top N and bottom N queries.3 params

Rank countries by an indicator available to the caller's tier. Supports top N and bottom N queries.

Parameters* required

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...

limitnumber

Number of results (default 10)

orderstring

"desc" for highest first, "asc" for lowest firstone of desc · asc

get_historical_dataGet historical time series (20+ years) for a country and indicator pair.2 params

Get historical time series (20+ years) for a country and indicator pair.

Parameters* required

country_id*string

ISO 3166-1 alpha-3 code

indicator_id*string

Indicator ID

compare_countriesCompare 2-10 countries on selected indicators.2 params

Compare 2-10 countries on selected indicators.

Parameters* required

country_ids*array

List of country codes (max 10)

indicator_idsarray

Indicator IDs to compare (default: GDP, population, life expectancy, etc.)

search_indicatorsSearch for indicators by keyword. Use when you need to find the right indicator ID.1 params

Search for indicators by keyword. Use when you need to find the right indicator ID.

Parameters* required

query*string

Search term (e.g., "gdp", "population", "education", "co2")

get_available_indicatorsList all available indicators grouped by category.1 params

List all available indicators grouped by category.

Parameters* required

categorystring

Optional: filter by category name

get_country_listList all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital).1 params

List all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital).

Parameters* required

regionstring

Optional: filter by region

get_series_dataHigh-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), mont...5 params

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), mont...

Parameters* required

fromstring

Start date YYYY-MM-DD

geostring

ISO3 country code (e.g. USA, DEU). Omit with latest=true for a cross-country view.

latestboolean

true: newest stored observation for every geography. Do not combine with geo, from or limit; reference periods can differ.

limitnumber

Max observations (default 120, maximum 2000). The response sets truncated=true when more observations match.

series_id*string

Series ID, e.g. UST.YC.10Y, OECD.IRLT.10Y, ILO.UNEMP.RT.M

list_seriesList the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each.

List the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each.

No parameters. Call it with no arguments.

compare_sourcesCompare 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 mis...6 params

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 mis...

Parameters* required

as_ofstring

Optional SOTW recording cutoff: date at UTC midnight or ISO timestamp with timezone. Publisher availability is not established.

country_idstring

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_versionstring

Pin the comparison processing contract.one of source-comparison-v1

revisionstring

Archive transaction watermark returned by an earlier comparison. Requires as_of.

yearvalue

Opt into the research pilot: exact year or latest common past year. Requires country_id.

get_release_calendarInstitutional 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 mat...6 params

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 mat...

Parameters* required

countrystring

Optional: US, CA, EU, or Global

fromstring

Start date YYYY-MM-DD (default: today)

institutionstring

Optional: ECB, BOC, BEA, BLS, EUROSTAT, IMF, G7, G20

limitnumber

Max events (default 100)

report_typestring

Optional: policy_decision, data_release, flagship_report, or meeting

tostring