# worldbank-mcp-server MCP server

Query 29,500+ World Bank development indicators for 200+ countries across 60+ years.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cyanheads-worldbank-mcp-server
- Repository: https://github.com/cyanheads/worldbank-mcp-server

## Install
- Command: `npx -y @cyanheads/worldbank-mcp-server`
- Endpoint: https://worldbank.caseyjhand.com/mcp
- Auth: Not captured

## Setup notes
- Package: Npm @cyanheads/worldbank-mcp-server v0.1.5
- Environment variable: MCP_LOG_LEVEL (default info)
- Environment variable: WORLDBANK_API_BASE_URL (default https://api.worldbank.org/v2)
- Environment variable: WORLDBANK_DEFAULT_PER_PAGE (default 50)
- Package: Npm @cyanheads/worldbank-mcp-server v0.1.5
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_HTTP_PORT (default 3010)
- Environment variable: MCP_HTTP_ENDPOINT_PATH (default /mcp)
- Environment variable: MCP_AUTH_MODE (default none)
- Environment variable: MCP_LOG_LEVEL (default info)
- Environment variable: WORLDBANK_API_BASE_URL (default https://api.worldbank.org/v2)
- Environment variable: WORLDBANK_DEFAULT_PER_PAGE (default 50)
- Remote endpoint: https://worldbank.caseyjhand.com/mcp

## Tools
- worldbank_list_topics (List World Bank Topics) - Lists all 21 World Bank thematic topics (Economy & Growth, Health, Education, etc.) with descriptions. Use to browse the indicator space or find a topic_id for worldbank_search_indicators. Endpoint: https://worldbank.caseyjhand.com/mcp
- worldbank_list_sources (List World Bank Data Sources) - Lists the 70+ World Bank data sources (datasets) such as World Development Indicators, IDS, and Doing Business. Returns source IDs and names for use as source_id in worldbank_search_indicators. Supports pagination. Endpoint: https://worldbank.caseyjhand.com/mcp
- worldbank_list_countries (List World Bank Countries) - Lists countries and regional aggregates with metadata: ISO codes, region, income level, capital, and coordinates. Filterable by region code (e.g. EAS, SSF, NAC) and income level (LIC, LMC, UMC, HIC). By default, excludes regional/income-group aggregate entries and returns individual countries only. Set include_aggregates=true to also see region, income group, and world aggregate entities. Endpoint: https://worldbank.caseyjhand.com/mcp
- worldbank_get_country (Get World Bank Country) - Fetches full metadata for a specific country or aggregate entity: region, income level, capital, coordinates, and lending type. Accepts ISO2 codes (US, DE), ISO3 codes (USA, DEU), or World Bank aggregate codes (EAS, HIC, WLD). Endpoint: https://worldbank.caseyjhand.com/mcp
- worldbank_search_indicators (Search World Bank Indicators) - Searches the 29,500+ World Bank indicator catalog by keyword, topic, or source. Returns indicator IDs and metadata for chaining into worldbank_get_data. At least one of query, topic_id, or source_id must be provided. When combined with topic_id or source_id, keyword filtering applies across all results in that topic or source. Use worldbank_list_topics for topic IDs, worldbank_list_sources for source IDs. Endpoint: https://worldbank.caseyjhand.com/mcp
- worldbank_get_indicator (Get World Bank Indicator) - Fetches complete metadata for a single World Bank indicator by its ID: name, description, source dataset, source organization, unit, and thematic topics. Use worldbank_search_indicators to discover indicator IDs if you only know the concept. Endpoint: https://worldbank.caseyjhand.com/mcp
- worldbank_get_data (Get World Bank Indicator Data) - Queries World Bank indicator values for one or more countries across a time range. The primary data-access tool — use worldbank_search_indicators to find indicator_id values. Returns observations with null values when data is not available for a country×year cell (common for sparse series). Specify either date_range (historical analysis) or mrv (most recent N values), not both. For "all" countries, use pagination (per_page up to 1000) since the API returns ~266 entries per indicator. Endpoint: https://worldbank.caseyjhand.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.cyanheads
- Version: 0.1.5
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 24, 2026
- Source: https://registry.modelcontextprotocol.io