Statistics of the World

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

490+ economic & demographic indicators for 218 countries from IMF, World Bank, UN, FRED.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Statistics of the World": {
      "url": "https://statisticsoftheworld.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (17)

• search_data

  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.

  Parameters:

  • geo — string
  • kind — string
  • page — integer
  • limit — integer
  • query — string
  • market — string
  • source — string
  • version — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_company_facts

  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.

  Parameters:

  • to — string
  • cik — string
  • tag — string
  • from — string
  • limit — integer
  • evidence — string
  • filed_to — string
  • filed_from — string
  • publication — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_data_status

  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:

  • geo — string
  • matrix — boolean
  • series_id — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_market_history

  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.

  Parameters:

  • market (required) — string
  • symbol (required) — string
  • from (required) — string
  • to (required) — string
  • limit — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_economic_data

  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.

  Parameters:

  • 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.
  • series_id — string
  • generation — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_onchain_quotes

  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.

  Parameters:

  • 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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_country_overview

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

  Parameters:

  • country_id (required) — string — ISO 3166-1 alpha-3 code (e.g., USA, CAN, GBR, CHN, JPN, DEU)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_indicator_ranking

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

  Parameters:

  • indicator_id (required) — 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.
  • limit — number — Number of results (default 10)
  • order — string — "desc" for highest first, "asc" for lowest first

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_historical_data

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

  Parameters:

  • indicator_id (required) — string — Indicator ID
  • country_id (required) — string — ISO 3166-1 alpha-3 code

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• compare_countries

  Compare 2-10 countries on selected indicators.

  Parameters:

  • country_ids (required) — array — List of country codes (max 10)
  • indicator_ids — array — Indicator IDs to compare (default: GDP, population, life expectancy, etc.)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_indicators

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

  Parameters:

  • query (required) — string — Search term (e.g., "gdp", "population", "education", "co2")

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_available_indicators

  List all available indicators grouped by category.

  Parameters:

  • category — string — Optional: filter by category name

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_country_list

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

  Parameters:

  • region — string — Optional: filter by region

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_series_data

  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.

  Parameters:

  • series_id (required) — string — Series ID, e.g. UST.YC.10Y, OECD.IRLT.10Y, ILO.UNEMP.RT.M
  • 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.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_series

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• compare_sources

  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.

  Parameters:

  • indicator_id (required) — string — Concept key, e.g. IMF.NGDPD (GDP), IMF.NGDPDPC (GDP per capita), IMF.NGDP_RPCH (real growth)
  • year — 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
  • processing_version — string — Pin the comparison processing contract.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_release_calendar

  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.

  Parameters:

  • 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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.