How do I use worldbank-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@worldbank-mcp Get GDP for the United States" 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.

worldbank-mcp

by tianyuio

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

World Bank MCP 🌐

npm version License: MIT GitHub issues

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

Related MCP server: World Bank Data360 MCP Server

📦 Installation

Install globally with npm

npm install -g worldbank-mcp

Run instantly with npx

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:

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

Run instantly with npx:

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

Run directly with node:

{
  "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

{
  "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

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

3. Search Indicators

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

4. Get Economic Data

{
  "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)"
  }
}

{
  "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

{
  "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

{
  "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

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

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

worldbank-mcp-server A
io.github.cyanheads
Query 29,500+ World Bank development indicators for 200+ countries across 60+ years.
Government Data Open Data Research & Data
923
World Bank IndicatorsOAuth
io.github.Taru0208
Access World Bank development indicators for 200+ countries.
Government Data Open Data Research & Data
2
worlduank A
io.github.pipeworx-io
World Bank MCP — wraps the World Bank Data API v2 (free, no auth)
Government Data Open Data Research & Data
372
World Bank & FRED Macro A
io.github.guptaprakhariitr
Macro indicators from World Bank, FRED, IMF, and OECD via unified query surface.
Finance Open Data
521

Related MCP Servers

World Bank MCP Server
Government Data Open Data
anshumax
F
license
B
quality
D
maintenance
Enables AI assistants to interact with the World Bank open data API, allowing for listing and analysis of indicators across available countries.
Updated 9 days ago (2026-09-04 13:31 UTC)
1
50
-
World Bank Data360 MCP Server
Government Data Open Data Research & Data
llnOrmll
A
license
A
quality
D
maintenance
Enables 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.
Updated 8 months ago (2026-01-27 08:21 UTC)
5
1
MIT
mcp-worldbank
Open Data Research & Data Government Data
pipeworx-io
A
license
Not graded
quality
C
maintenance
Enables AI agents to access and query World Bank data (free, no auth) through natural language or direct tools, wrapping the World Bank Data API v2.
Updated 18 days ago (2026-08-26 17:50 UTC)
6 npm
MIT
world-bank-server
Finance Open Data
gu-dsan6725
F
license
Not graded
quality
D
maintenance
Exposes World Bank development data and country information via MCP resources and tools, enabling AI agents to query historical indicators and live API data.
Updated 7 months ago (2026-02-09 19:24 UTC)
-