World Bank Indicators MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@World Bank Indicators MCP Server compare latest GDP of USA and China"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
World Bank Indicators MCP Server
Read-only Model Context Protocol server for country and economic data from the World Bank Indicators API. No API key or credentials are required. This independent project is not affiliated with or endorsed by the World Bank Group.
Tools
Tool | Use |
| Resolve country codes by name, region, or income level. |
| Read an indicator definition, source, and topics. |
| Fetch a paginated time series for up to 20 countries. |
| Compare latest non-empty indicator values across countries. |
| Read latest GDP, growth, population, inflation, and unemployment data. |
Every tool has bounded input and structured output schemas plus read-only MCP annotations. HTTP, network, timeout, and malformed-response failures return bounded tool errors without writing protocol noise to stdout.
Related MCP server: World Bank Data360 MCP Server
Requirements
Node.js 20 or newer.
Network access to
https://api.worldbank.org.
Run With npx
After npm publication, run the pinned package without cloning:
npx -y world-bank-indicators-mcp@0.1.0The process is a stdio MCP server. Direct terminal use waits silently for JSON-RPC input.
For source development after GitHub publication:
git clone https://github.com/ryanngit/world-bank-indicators-mcp.git
cd world-bank-indicators-mcp
npm ci
npm run verify
npm run build
node .\dist\src\index.jsClaude Desktop
Add this entry to Claude Desktop configuration. It uses the future pinned npm release and needs no local source path or environment variables.
{
"mcpServers": {
"world-bank-indicators": {
"command": "npx",
"args": ["-y", "world-bank-indicators-mcp@0.1.0"]
}
}
}Configuration locations:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Save the file and restart Claude Desktop. On Windows, if Claude cannot resolve
npx, use "command": "cmd" and prepend "/c", "npx" to args.
Examples
Resolve country codes:
{
"name": "find_countries",
"arguments": {
"query": "united",
"limit": 10
}
}Compare latest reported GDP values:
{
"name": "compare_countries",
"arguments": {
"countries": ["CAN", "MEX", "USA"],
"indicator": "NY.GDP.MKTP.CD"
}
}Read a bounded time series page:
{
"name": "get_indicator_data",
"arguments": {
"countries": ["IND", "CHN"],
"indicator": "SP.POP.TOTL",
"startYear": 2015,
"endYear": 2023,
"page": 1,
"pageSize": 100
}
}get_indicator_data returns page, pages, perPage, and total metadata.
Use page to retrieve later result pages.
Development
npm run typecheck
npm test
npm run verify
npm audit --audit-level=high
npm pack --dry-run --jsonTests use Node's built-in test runner and deterministic fetch fixtures. They do not require live World Bank access. Package tests guard repository and license metadata against unresolved publication markers.
For an optional local protocol check with
mcp-smoke:
git clone --branch v0.1.0 --depth 1 https://github.com/ryanngit/mcp-smoke.git .mcp-smoke
python .\.mcp-smoke\mcp_smoke.py check --out .\mcp-smoke-out --server-name world-bank-indicators --overwrite -- node .\dist\src\index.jsData Attribution
Data and indicator metadata come from the World Bank Indicators API. The software license in this repository does not relicense World Bank data. Review the World Bank dataset terms and each indicator's source metadata before redistribution or production use.
Limitations
Live values can be revised, delayed, or absent for some country-year pairs.
Latest non-empty observations can come from different years by country.
Requests have a 10-second full-response timeout and no retry or cache layer.
find_countriesexcludes aggregate regions by default; setincludeAggregatesto include them.Inputs allow at most 20 countries, 100 years per request, 1,000 records per page, and page numbers through 10,000.
get_country_profilealways returns five fixed metrics. Missing values usestatus: "missing"with nullyearandvalue.
Support
Search or open a reproducible report in GitHub Issues. Include server version, Node.js version, tool name, sanitized input, and error text. Do not include credentials or private conversation content.
License
MIT. Copyright (c) 2026 ryanngit.
Available Tools
5 toolscompare_countriesCompare CountriesARead-onlyIdempotent
Compare latest non-empty value for one indicator across 2 to 20 countries.
Inputs: countries (required), indicator (required). Returns: count, values, indicator
find_countriesFind CountriesARead-onlyIdempotent
Find World Bank country codes by name, region, or income level.
Inputs: limit, query, region, incomeLevel, +1 more. Returns: count, query, countries
get_country_profileGet Country ProfileBRead-onlyIdempotent
Get country metadata plus latest GDP, growth, population, inflation, and unemployment values.
Inputs: country (required). Returns: country, metrics
get_indicator_dataGet Indicator DataBRead-onlyIdempotent
Get a paginated annual indicator time series for up to 20 countries and a bounded year range.
Inputs: endYear (required), countries (required), indicator (required), startYear (required), +2 more. Returns: page, observations
get_indicator_metadataGet Indicator MetadataARead-onlyIdempotent
Get definition, source, and topics for an exact World Bank indicator code.
Inputs: indicator (required). Returns: indicator
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a broadly distinct purpose: metadata lookup, country lookup, time-series data, cross-country comparison, and country profile. get_indicator_data and compare_countries overlap somewhat since both return indicator values, but the former is explicitly a bounded time series while the latter is a latest-value comparison.
All tool names follow a consistent verb_noun snake_case pattern: get_, find_, and compare_ prefixes with clear objects. There are no mixed conventions or vague verbs.
Five tools is a well-scoped size for a World Bank indicators server. Each tool covers a clear need without redundancy or bloat.
The core workflows of finding countries, retrieving indicator metadata, fetching time series, comparing countries, and getting a profile are covered. The main gap is that there is no way to search or discover indicators by keyword, topic, or text; only exact indicator codes are supported.
Related MCP Connectors
Access World Bank development indicators for 200+ countries.
Query 29,500+ World Bank development indicators for 200+ countries across 60+ years.
Dive into the wealth of information provided by the World Bank with our zero-auth API. Instantly
Unofficial World Bank MCP — wraps the World Bank Data API v2 (free, no auth)
Related MCP Servers
- FlicenseBqualityCmaintenanceEnables AI assistants to interact with the World Bank open data API, allowing for listing and analysis of indicators across available countries.150-
- AlicenseAqualityDmaintenanceEnables access to World Bank Data360 API with 1000+ economic and social indicators across 200+ countries and 60+ years of historical data, allowing searches, temporal coverage checks, and filtered data retrieval through natural language queries.51MIT
- AlicenseNot gradedqualityDmaintenanceProvides query capabilities for global economic and social development data from the World Bank Open Data API.95 npm8MIT

Data360 MCP Serverofficial
FlicenseNot gradedqualityBmaintenanceProvides LLM agents direct access to World Bank development indicators, enabling search, validation, and retrieval of data on topics like GDP, poverty, and gender equality.45-