Worldbank MCP

What worldbank-mcp does

The worldbank-mcp MCP server exposes World Bank Open Data through the Model Context Protocol. It is intended for agents that need structured country and development data without implementing the World Bank API directly. Available data includes country metadata, economic measures such as GDP and unemployment, social measures such as population and life expectancy, education measures such as literacy and enrollment, and health or nutrition measures such as immunization and tuberculosis incidence.

The server uses the World Bank API at https://api.worldbank.org/v2. Its documented endpoints cover country lists, indicator discovery, and country-specific indicator records. Data requests use country codes such as US, CN, or IN.

How it works

The worldbank-mcp MCP server runs as a local command and communicates with an MCP client. A client can start it with the installed worldbank-mcp executable, with npx worldbank-mcp, or by invoking the compiled Node.js file. Requests are then handled through MCP tools, while the server uses HTTP calls to retrieve World Bank data.

Most category-specific queries accept a country code, an indicator, and an optional number of years. When the years value is omitted, the documented default is 10 years. Indicator search accepts a keyword, and country listing can be filtered by region or income level.

Setup and configuration

Install the package globally with:

npm install -g worldbank-mcp

Alternatively, run it without a global installation:

npx worldbank-mcp

An MCP client configuration can use either command:

{
  "mcpServers": {
    "worldbank-mcp": {
      "name": "World Bank Data",
      "command": "npx",
      "args": ["worldbank-mcp"],
      "description": "World Bank Open Data MCP Server"
    }
  }
}

For a local checkout, configure node with the path to build/index.js instead. The README gives examples for Claude Desktop and Cursor.

Tools and capabilities

The worldbank-mcp MCP server documents these tools:

• get-countries: Lists supported countries and optionally filters by region or income level.
• get-country-info: Returns details for one country from its country code.
• search-indicators: Finds available indicators using a keyword.
• get-economic-data: Queries GDP, GNI, exports, foreign investment, inflation, or unemployment data.
• get-social-data: Queries population, life expectancy, birth rate, death rate, or internet usage.
• get-education-data: Queries literacy, enrollment, completion, teacher, or education expenditure measures.
• get-health-data: Queries health expenditure, physicians, hospital beds, immunization, HIV, malnutrition, or tuberculosis measures.

These tools use predefined indicator groups rather than documenting an unrestricted indicator query interface.

Limitations and notes

Indicator availability and returned values come from the World Bank Open Data API, so the server does not define an independent dataset. No environment variables or API credentials are documented for setup. The project is licensed under MIT and is implemented with TypeScript, the MCP SDK, Axios, Zod, and Commander.