Worldbank Mcp

io.github.tianyuioPublished by GitHub account tianyuiov1.0.1Updated Oct 24, 2026

World Bank Open Data MCP Server

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that queries World Bank Open Data so an assistant can look up countries and economic, social, education and health indicators.

What you can do
List and filter World Bank countries by region or income level, and fetch details for a specific country code. Search available indicators by keyword. Retrieve multi-year economic data such as GDP, inflation and unemployment. Retrieve social, education and health data such as population, literacy, enrollment, life expectancy and immunization. All figures come from live World Bank Open Data API calls.
When to use it
Useful when you want an assistant to pull official development statistics for a country or compare indicators across countries without leaving the chat, for research, reports or background context.
Requirements
Runs locally as a Node.js process, installed globally via npm or run with npx. Needs network access to the World Bank Open Data API. The manifest declares a required secret environment variable named YOUR_API_KEY, though the README shows no key in its configuration examples.
Before you install
The manifest requires an environment variable named YOUR_API_KEY, but the README does not explain what it is for or where to obtain it; confirm this before supplying any credential. Queries are sent to the public World Bank API. The server is read-only and does not modify data.

Installation

In SourceWeft

  1. Open Worldbank Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

📦 Installation

Install globally with npm

bash
npm install -g worldbank-mcp

Run instantly with npx

bash
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:

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

Run instantly with npx:

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

Run directly with node:

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

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

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

3. Search Indicators

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

4. Get Economic Data

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

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

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

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 CodeDescriptionUnit
GDPGross Domestic ProductCurrent US$
GDP_GROWTHGDP growth rateAnnual %
GDP_PER_CAPITAGDP per capitaCurrent US$
GNIGross National IncomeCurrent US$
GNI_PER_CAPITAGNI per capitaCurrent US$
EXPORTS_GDPExports of goods and services% of GDP
FDI_NETForeign direct investment, net inflowsCurrent US$
INFLATIONInflation rateAnnual %
UNEMPLOYMENTUnemployment rate% of total labor force

Social Indicators

Indicator CodeDescriptionUnit
POPULATIONPopulation, totalPeople
LIFE_EXPECTANCYLife expectancy at birthYears
BIRTH_RATEBirth rateper 1,000 people
DEATH_RATEDeath rateper 1,000 people
INTERNET_USERSInternet users% of population

Education Indicators

Indicator CodeDescriptionUnit
LITERACY_RATELiteracy rate% of people ages 15 and above
SCHOOL_ENROLLMENTSchool enrollment, primary% gross
SCHOOL_COMPLETIONPrimary completion rate% of relevant age group
TEACHERS_PRIMARYTeachers in primary educationCount
EDUCATION_EXPENDITUREGovernment expenditure on education% of GDP

Health and Nutrition Indicators

Indicator CodeDescriptionUnit
HEALTH_EXPENDITURECurrent health expenditure% of GDP
PHYSICIANSPhysiciansper 1,000 people
HOSPITAL_BEDSHospital bedsper 1,000 people
IMMUNIZATIONImmunization, measles% of children ages 12-23 months
HIV_PREVALENCEPrevalence of HIV% of population ages 15-49
MALNUTRITIONPrevalence of undernourishment% of population
TUBERCULOSISIncidence of tuberculosisper 100,000 people

Common Country Codes

CountryCodeCountryCode
ChinaCNUnited StatesUS
JapanJPGermanyDE
United KingdomGBFranceFR
IndiaINBrazilBR
RussiaRUAustraliaAU

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.

Source: README.md at commit 254cc78

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts