Worldbank MCP README

World Bank MCP 🌐

World Bank Model Context Protocol service based on World Bank Open Data API, which provides query capabilities for global economic and social development data.

📋 Features

✅ Country information query
✅ Indicator search (education, health, environment, etc.)
✅ Economic data query (GDP, inflation, unemployment, etc.)
✅ Social development data query (population, life expectancy, internet usage, etc.)
✅ Education data query (literacy rate, school enrollment, etc.)
✅ Health and nutrition data query (hospitals, immunization, HIV prevalence, malnutrition, etc.)
✅ Real-time World Bank API integration
✅ Model Context Protocol compatibility

📦 Installation

Install globally with npm

Terminal

npm install -g worldbank-mcp

Run instantly with npx

Terminal

npx worldbank-mcp

💻 Usage in MCP Clients

To use this service in MCP-compatible clients (such as Claude Desktop, Cursor, Cherry Studio, etc.), you need to configure it as follows:

Configuration example:

Run with npm if you have installed it globally:

config.json

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

Run instantly with npx:

config.json

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

Run directly with node:

config.json

{
  "mcpServers": {
    "worldbank-mcp": {
      "name": "World Bank Data",
      "command": "node",
      "args": ["path/to/worldbank-mcp/build/index.js"],
      "description": "World Bank Open Data MCP Server"
    }
  }
}

Replace path/to/ with the actual path to your project directory.

🔧 MCP Tools

1. Get Countries List

config.json

{
  "name": "get-countries",
  "description": "Get all countries supported by World Bank",
  "parameters": {
    "region": "Filter by region (optional)",
    "incomeLevel": "Filter by income level (optional)"
  }
}

2. Get Country Information

config.json

{
  "name": "get-country-info", 
  "description": "Get detailed information for a specific country",
  "parameters": {
    "countryCode": "Country code (e.g.: CN, US)"
  }
}

3. Search Indicators

config.json

{
  "name": "search-indicators",
  "description": "Search for available indicators",
  "parameters": {
    "keyword": "Search keyword"
  }
}

4. Get Economic Data

config.json

{
  "name": "get-economic-data",
  "description": "Get economic data for a country",
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Economic indicator (GDP, GDP_GROWTH, GDP_PER_CAPITA, GNI, GNI_PER_CAPITA, EXPORTS_GDP, FDI_NET, INFLATION, UNEMPLOYMENT)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

5. Get Social Development Data

config.json

{
  "name": "get-social-data",
  "description": "Get social development data for a country", 
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Social indicator (POPULATION, LIFE_EXPECTANCY, BIRTH_RATE, DEATH_RATE, INTERNET_USERS)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

6. Get Education Data

config.json

{
  "name": "get-education-data",
  "description": "Get education data for a country", 
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Education indicator (LITERACY_RATE, SCHOOL_ENROLLMENT, SCHOOL_COMPLETION, TEACHERS_PRIMARY, EDUCATION_EXPENDITURE)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

7. Get Health and Nutrition Data

config.json

{
  "name": "get-health-data",
  "description": "Get health and nutrition data for a country", 
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Health indicator (HEALTH_EXPENDITURE, PHYSICIANS, HOSPITAL_BEDS, IMMUNIZATION, HIV_PREVALENCE, MALNUTRITION, TUBERCULOSIS)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

📖 Supported Indicators

Economic Indicators

Indicator Code	Description	Unit
GDP	Gross Domestic Product	Current US$
GDP_GROWTH	GDP growth rate	Annual %
GDP_PER_CAPITA	GDP per capita	Current US$
GNI	Gross National Income	Current US$
GNI_PER_CAPITA	GNI per capita	Current US$
EXPORTS_GDP	Exports of goods and services	% of GDP
FDI_NET	Foreign direct investment, net inflows	Current US$
INFLATION	Inflation rate	Annual %
UNEMPLOYMENT	Unemployment rate	% of total labor force

Social Indicators

Indicator Code	Description	Unit
POPULATION	Population, total	People
LIFE_EXPECTANCY	Life expectancy at birth	Years
BIRTH_RATE	Birth rate	per 1,000 people
DEATH_RATE	Death rate	per 1,000 people
INTERNET_USERS	Internet users	% of population

Education Indicators

Indicator Code	Description	Unit
LITERACY_RATE	Literacy rate	% of people ages 15 and above
SCHOOL_ENROLLMENT	School enrollment, primary	% gross
SCHOOL_COMPLETION	Primary completion rate	% of relevant age group
TEACHERS_PRIMARY	Teachers in primary education	Count
EDUCATION_EXPENDITURE	Government expenditure on education	% of GDP

Health and Nutrition Indicators

Indicator Code	Description	Unit
HEALTH_EXPENDITURE	Current health expenditure	% of GDP
PHYSICIANS	Physicians	per 1,000 people
HOSPITAL_BEDS	Hospital beds	per 1,000 people
IMMUNIZATION	Immunization, measles	% of children ages 12-23 months
HIV_PREVALENCE	Prevalence of HIV	% of population ages 15-49
MALNUTRITION	Prevalence of undernourishment	% of population
TUBERCULOSIS	Incidence of tuberculosis	per 100,000 people

Common Country Codes

Country	Code	Country	Code
China	CN	United States	US
Japan	JP	Germany	DE
United Kingdom	GB	France	FR
India	IN	Brazil	BR
Russia	RU	Australia	AU

Project Structure

Code

worldbank-mcp/
├── src/
│   ├── index.ts      # Main entry file
│   └── types.ts      # Type definitions
├── build/            # Compiled output
├── package.json      # Project configuration
├── tsconfig.json     # TypeScript configuration
└── README.md         # Documentation

Technology Stack

TypeScript - Type-safe development language
Model Context Protocol SDK - MCP protocol implementation
Axios - HTTP client
Zod - Data validation
Commander - Command-line tool

API Endpoints

Project uses World Bank Open Data API:

Base URL: https://api.worldbank.org/v2
Country data: /countries
Indicator data: /indicators
Country indicator data: /country/{code}/indicator/{id}

License

This project is licensed under the MIT License - see the LICENSE file for details.