{"name":"statistics-of-the-world","version":"1.1.0","description":"MCP server exposing 337 country indicators for 217 countries from IMF, World Bank, UN, and WHO. Paid keys increase throughput without removing public sources. Responses include source-specific attribution; provider reuse terms vary by series.","indicatorCount":337,"protocol":"MCP Streamable HTTP","tools":[{"name":"search_data","description":"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."},{"name":"get_company_facts","description":"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."},{"name":"get_data_status","description":"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."},{"name":"get_market_history","description":"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."},{"name":"get_economic_data","description":"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."},{"name":"get_onchain_quotes","description":"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."},{"name":"get_country_overview","description":"Get all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more."},{"name":"get_indicator_ranking","description":"Rank countries by an indicator available to the caller's tier. Supports top N and bottom N queries."},{"name":"get_historical_data","description":"Get historical time series (20+ years) for a country and indicator pair."},{"name":"compare_countries","description":"Compare 2-10 countries on selected indicators."},{"name":"search_indicators","description":"Search for indicators by keyword. Use when you need to find the right indicator ID."},{"name":"get_available_indicators","description":"List all available indicators grouped by category."},{"name":"get_country_list","description":"List all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital)."},{"name":"get_series_data","description":"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."},{"name":"list_series","description":"List the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each."},{"name":"compare_sources","description":"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."},{"name":"get_release_calendar","description":"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."}],"auth":{"method":"X-API-Key header (omit it to use the free hobby tier anonymously)","hobby":{"rateLimit":"1,000 requests/day","price":"Free","key":"optional (anonymous per-IP, or use a free key for a usage dashboard)","signup":"https://statisticsoftheworld.com/pricing"},"production":{"tier":"pro","rateLimit":"50,000 requests/day","price":"$49 USD/month","attributionIncluded":true,"reuse":"Paid responses retain the public read catalog; attribution and provider-specific reuse terms are included.","signup":"https://statisticsoftheworld.com/pricing"},"enterprise":{"rateLimit":"Unlimited","price":"Custom","contact":"api@statisticsoftheworld.com"}},"usage":{"endpoint":"POST https://statisticsoftheworld.com/api/mcp","transport":"Streamable HTTP (JSON-RPC 2.0)","headers":{"X-API-Key":"sotw_... (optional for free tier; required above 1K/day)"},"example":{"method":"tools/call","params":{"name":"get_country_overview","arguments":{"country_id":"USA"}}},"claudeDesktop":"See https://statisticsoftheworld.com/mcp for setup instructions."},"pricing":"https://statisticsoftheworld.com/pricing","docs":"https://statisticsoftheworld.com/mcp"}