# Statistics of the World

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

- name: com.statisticsoftheworld/sotw
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 89/100
- quality: 63/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.statisticsoftheworld%2Fsotw
- tools: https://api.protogrid.dev/v1/servers/com.statisticsoftheworld%2Fsotw/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "sotw": {
      "type": "http",
      "url": "https://statisticsoftheworld.com/api/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% ~updated-174d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 63/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_release_calendar (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_data (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_market_history (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,683 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 12 tool changes in 30 days
- fail `stability.rug_pull`: 3 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 17, about 2,683 tokens to load them all
- tool set hash: 18229e16203d8f8eb3c4382f12830217
- tools last changed: 2026-10-19T09:47:23.147Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.statisticsoftheworld/sotw.svg)](https://protogrid.dev/servers/com.statisticsoftheworld/sotw)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `get_release_calendar` changed (description) **meaning changed**
  - before: Institutional release schedules with primary source URLs. Date-passed status does not confirm publication. Related series readings retain their own reference periods and current values; their match to the scheduled release is not verified.
  - after: 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.
- 2026-10-13 `get_series_data` changed (inputSchema)
- 2026-10-12 `get_economic_data` changed (inputSchema)
- 2026-10-12 `get_market_history` added
  - 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.
- 2026-10-12 `get_data_status` added
  - 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.
- 2026-10-12 `get_company_facts` added
  - 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.
- 2026-10-12 `search_data` added
  - 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.
- 2026-10-11 `get_country_list` changed (description)
  - before: List all 218 countries with metadata (region, income level, capital).
  - after: List all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital).
- 2026-10-11 `get_onchain_quotes` changed (description, inputSchema) **meaning changed**
  - before: Read SOTW-computed Uniswap/Raydium pool prices for reviewed crypto, stablecoins, gold tokens and tokenized stocks/ETFs. Quote currency is USDC, not assumed USD. Instruments are distinct from underlying equities, indices and bullion benchmarks. Includes observation time and source proof; unavailable values are null. Set catalog=true to list enrolled symbols without reading prices.
  - after: 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.
- 2026-10-11 `get_economic_data` added
  - 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.

Full history: https://api.protogrid.dev/v1/servers/com.statisticsoftheworld%2Fsotw/changes

## Remotes

- https://statisticsoftheworld.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (17)

- `compare_countries`: Compare 2-10 countries on selected indicators.
- `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.
- `get_available_indicators`: List all available indicators grouped by category.
- `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.
- `get_country_list`: List all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital).
- `get_country_overview`: Get all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more.
- `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.
- `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.
- `get_historical_data`: Get historical time series (20+ years) for a country and indicator pair.
- `get_indicator_ranking`: Rank countries by an indicator available to the caller's tier. Supports top N and bottom N queries.
- `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.
- `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.
- `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.
- `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.
- `list_series`: List the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each.
- `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.
- `search_indicators`: Search for indicators by keyword. Use when you need to find the right indicator ID.