# Worldbank MCP

> Worldbank MCP is an open-source MCP server for analytics and data. MCP server giving AI clients query access to World Bank Open Data indicators. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/tianyuio/worldbank-mcp
- **MCP Registry name:** io.github.tianyuio/worldbank-mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Model Context Protocol server that queries the World Bank Open Data API, covering country metadata, indicator search and economic, social, education and health series for individual countries.

It runs over stdio and can be launched with npm or npx, then registered in MCP clients such as Claude Desktop, Cursor or Cherry Studio. Each tool takes a country code and an indicator from a fixed list, with an optional number of years that defaults to ten.

The server suits researchers, analysts and developers who want an assistant to pull development statistics such as GDP, life expectancy or immunization rates directly from World Bank data rather than copying figures by hand. The registry entry lists an API key environment variable, which the README does not explain.

## Features

- **Country directory lookup:** Lists World Bank countries and returns details for a given country code, with optional region and income-level filters.
- **Indicator keyword search:** Searches available World Bank indicators by keyword to find series codes before querying data.
- **Economic series queries:** Retrieves GDP, GNI, inflation, unemployment, FDI and trade share figures for a country over a set number of years.
- **Social and education data:** Covers population, life expectancy, birth and death rates, internet users, literacy and school enrollment indicators.
- **Health and nutrition data:** Provides health spending, physician and bed counts, immunization, HIV prevalence and tuberculosis incidence.

## Good for

- Let an AI assistant compare GDP per capita across countries over the last decade
- Pull life expectancy or immunization trends for a country for a briefing
- Gather education spending and enrollment figures for policy research
- Check unemployment and inflation series while drafting economic summaries

## Install

### Claude Code (Terminal)

```sh
claude mcp add worldbank-mcp --env YOUR_API_KEY='<YOUR_API_KEY>' -- npx -y worldbank-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "worldbank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "worldbank-mcp"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "worldbank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "worldbank-mcp"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "worldbank-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "worldbank-mcp"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "worldbank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "worldbank-mcp"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "worldbank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "worldbank-mcp"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get-countries`: Get all countries supported by World Bank
- `get-country-info`: Get detailed information for a specific country
- `search-indicators`: Search for available indicators
- `get-economic-data`: Get economic data for a country
- `get-social-data`: Get social development data for a country
- `get-education-data`: Get education data for a country
- `get-health-data`: Get health and nutrition data for a country

## FAQ

### How do I install the World Bank MCP server?

The README gives two options: install globally with npm install -g worldbank-mcp, or run it on demand with npx worldbank-mcp.

### Which indicators are supported?

The README lists economic, social, education, and health and nutrition indicator codes, such as GDP, LIFE_EXPECTANCY and HIV_PREVALENCE.

### What license is it released under?

The README states the project is licensed under the MIT License.

### Is Worldbank MCP free?

Yes. Worldbank MCP is open source, so you can use and self-host it for free.

### How do I add Worldbank MCP to Claude Code?

Run this command in your terminal: claude mcp add worldbank-mcp --env YOUR_API_KEY='<YOUR_API_KEY>' -- npx -y worldbank-mcp

### What are the best alternatives to Worldbank MCP?

The closest alternatives to Worldbank MCP are Statistics of the World, Nigeria UN SDG MCP by Wycord, Country Macro Indicators (World Bank), World Monitor and Nigeria IMF WEO MCP by Wycord.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Statistics of the World](https://ai-powered.com/mcp/statistics-of-the-world): Statistics of the World is a freemium MCP server for analytics and data.
- [Nigeria UN SDG MCP by Wycord](https://ai-powered.com/mcp/nigeria-un-sdg-mcp-by-wycord): Nigeria UN SDG MCP by Wycord is an open-source MCP server for analytics and data.
- [Country Macro Indicators (World Bank)](https://ai-powered.com/mcp/country-macro-indicators-world-bank): Country Macro Indicators (World Bank) is a paid MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Nigeria IMF WEO MCP by Wycord](https://ai-powered.com/mcp/nigeria-imf-weo-mcp-by-wycord): Nigeria IMF WEO MCP by Wycord is an open-source MCP server for finance and payments.
- [Switzerland MCP 🇨🇭](https://ai-powered.com/mcp/switzerland-mcp): Switzerland MCP 🇨🇭 is an open-source MCP server for maps and travel.
- [Morocco Hcp Statistics](https://ai-powered.com/mcp/morocco-hcp-statistics): Morocco Hcp Statistics is a freemium MCP server for analytics and data.
- [MCP Server Discovery — new model-context-protocol repos ($0.01/query)](https://ai-powered.com/mcp/mcp-server-discovery-new-model-context-protocol-repos-0-01-q): MCP Server Discovery — new model-context-protocol repos ($0.01/query) is a paid MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/worldbank-mcp
