MCP ServerStreamable HTTP · v1.1.0

Statistics of the World MCP server

Use 17 read-only tools to browse 337 public country indicators, compare source readings, retrieve higher-frequency series, and check economic release dates. Free access is available up to 1,000 requests/day; paid keys raise throughput without removing sources.

Get free API key →GET /api/mcp (discovery)

Quickstart

1.Start with the public endpoint below. No key is required for up to 1,000 requests/day per IP.
2.Add a remote connector in Claude, or save the Cursor configuration shown below. Enable the server’s tools in your client.
3.Ask: "Compare GDP per capita between Vietnam and Indonesia."

Connection

These examples use anonymous access. Clients that support custom headers, including Cursor, can send an X-API-Key header for a larger allowance. Get a key from pricing; keep it out of public configuration files. Claude uses its remote connector setup; Team and Enterprise organizations may require an owner to add the connector first.

Claude (remote connector)

Customize → Connectors → + → Add custom connector

https://statisticsoftheworld.com/api/mcp

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (user)

{
  "mcpServers": {
    "sotw": {
      "url": "https://statisticsoftheworld.com/api/mcp"
    }
  }
}

Programmatic (raw JSON-RPC)

POST https://statisticsoftheworld.com/api/mcp

curl -s -X POST https://statisticsoftheworld.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_country_overview",
      "arguments": { "country_id": "VNM" }
    }
  }'

Client setup references: Claude remote connectors · Cursor MCP configuration.

Tiers

Tier	Rate limit	Price	Auth	Use case
Hobby	1,000 req/day per IP	Free	No key	Testing · personal agents
Developer	1,000 req/day	Free	Free key	Personal projects + usage dashboard
Data Pro	10,000 req/day	$29/mo	Paid key	Bulk data · recurring analysis
API Pro	50,000 req/day	$49/mo	Pro key	Production apps · agent workflows
Enterprise	Custom	Custom	Custom key	Contracted delivery · support

All tiers see the same tools and public read catalog. The `X-API-Key` header determines the request allowance. Source-specific reuse and redistribution notices remain attached to the data.

Tools available (17)

search_data	Search annual statistics, qualified economic definitions, other source time series, market instruments and company financials, retaining their distinct identities and terms.
get_economic_data	Read exact economic definitions, country histories, quality flags and evidence. Use recorded archive pins or request a reproducible export manifest.
get_onchain_quotes	Read current reviewed pool prices or perpetual midpoints with source times, units and quality status.
get_market_history	Read forward sampled market histories. Missing slots, unavailable prices and definition versions remain explicit.
get_company_facts	Read SEC company-reported facts with exact decimal values, fiscal durations, filing dates and acquisition evidence.
get_data_status	Check country-level macro coverage and freshness, source import ages and observed public request performance.
get_country_overview	All key statistics for one country (GDP, population, life expectancy, inflation, unemployment, debt, +AI narrative).
get_indicator_ranking	Rank countries by a published indicator. Top N or bottom N.
get_historical_data	20+ years of time-series for a country × indicator.
compare_countries	Compare 2–10 countries on selected published indicators.
search_indicators	Find the right indicator ID by keyword.
get_available_indicators	List the 337-indicator public catalog, optionally filtered by category.
get_country_list	List all 217 countries and territories, plus the World aggregate, with region, income level, capital.
get_series_data	Read daily, weekly and monthly series with source, frequency, reference periods and reuse information.
list_series	Discover the higher-frequency series catalog, including units, sources and licenses.
compare_sources	Compare latest source readings, or supply country_id and year (exact or common) for the 10-concept, 20-economy recorded-state pilot. Optional as_of, revision and processing_version pin its inputs.
get_release_calendar	Read scheduled data releases and central-bank decisions with links to the institutions’ published schedules.

Data sources

IMF World Economic Outlook

World Bank WDI

WHO Global Health Observatory

Tool responses include the providers that contributed to that result. Reuse rights vary by provider; WHO data follows the terms attached to its dataset and publishing service.