SkillAgentSearch skills...

worldbank-mcp-server

Query 29,500+ World Bank development indicators for 200+ countries across 60+ years via MCP. STDIO or Streamable HTTP.

Install / Use

claude mcp add cyanheads -- npx -y github:cyanheads/worldbank-mcp-server

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

80/100

Category

Marketing

Supported Platforms

Claude Code
Claude Desktop

Our assessment of worldbank-mcp-server

worldbank-mcp-server scores 80/100 on our quality scale, 583rd of 643 Marketing skills we index.

Its MCP Server is 18 KB long, well organised into 31 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 3 days ago, so worldbank-mcp-server is actively maintained.
  • Our last check on 2026-09-27 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-28. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

worldbank-mcp-server compared with similar skills

All 4 of these similar skills score higher than worldbank-mcp-server; compare them before choosing.

SkillScoreStarsUpdatedFormat
worldbank-mcp-server (this skill)by cyanheads8033d agoMCP Server
Agent-Reachby Panniantong100112.4k9d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install worldbank-mcp-server?
Run claude mcp add cyanheads -- npx -y github:cyanheads/worldbank-mcp-server. The install tabs above show the steps for each supported agent.
Which AI agents does worldbank-mcp-server work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is worldbank-mcp-server safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is worldbank-mcp-server still maintained?
The repository was last updated 3 days ago, so worldbank-mcp-server is actively maintained.
<div align="center"> <h1>@cyanheads/worldbank-mcp-server</h1> <p><b>Query 29,500+ World Bank development indicators for 200+ countries across 60+ years via MCP. STDIO or Streamable HTTP.</b> <div>9 Tools • 2 Resources</div> </p> </div> <div align="center">

Version License MCP SDK npm TypeScript Bun

</div> <div align="center">

Install in Claude Desktop Install in Cursor Install in VS Code

Framework

Public Hosted Server: https://worldbank.caseyjhand.com/mcp

</div>

Overview

World Bank Open Data across three separate upstream APIs — development indicators, poverty and inequality estimates, and the Bank's lending portfolio. Search the 29,500+ indicator catalog, query country-level time series, pull poverty and inequality metrics from the Poverty and Inequality Platform, and search active and historical lending projects from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

| Tool | Description | |:---|:---| | worldbank_list_topics | List all 21 World Bank thematic topics with descriptions | | worldbank_list_sources | List 70+ World Bank data sources (datasets) with pagination | | worldbank_list_countries | List countries and regional aggregates with ISO codes, region, income level, lending type, and coordinates, filterable by region, income level, and lending type | | worldbank_get_country | Fetch full metadata for a specific country or aggregate by ISO2, ISO3, or aggregate code | | worldbank_search_indicators | Search the 29,500+ indicator catalog by keyword, topic, or source | | worldbank_get_indicator | Fetch complete metadata for a single indicator: name, description, source, unit, and topics | | worldbank_get_data | Query indicator values for one or more countries across a time range, the most recent N periods, or each country's latest N non-empty values, annually, quarterly, or monthly | | worldbank_get_poverty | Poverty headcount, gap, and severity at any poverty line for economies and PIP's regional, income-group, and lending-group aggregates, plus the Gini coefficient and decile shares, from the Poverty and Inequality Platform | | worldbank_search_projects | Search the World Bank lending portfolio by text, country, region, status, financing window, and board approval date |

Resources

| Resource | Description | |:---|:---| | worldbank://indicator/{indicatorId} | Indicator metadata by ID — name, description, source, unit, and topics | | worldbank://country/{countryCode} | Country metadata by ISO2, ISO3, or aggregate code — region, income level, capital, coordinates |

Capability reference

worldbank_list_topics <sub>tool</sub>

  • No input required — returns the complete fixed taxonomy of 21 thematic topics
  • Topic IDs (e.g. 1 Agriculture, 3 Economy & Growth) feed topic_id on worldbank_search_indicators

worldbank_list_sources <sub>tool</sub>

  • Paginated list of the 70+ World Bank data sources (datasets); up to 100 per page
  • Each entry carries ID, name, short code, last-updated date, and data/metadata availability
  • Source IDs (e.g. 2 for World Development Indicators) feed source_id on worldbank_search_indicators

worldbank_list_countries <sub>tool</sub>

  • Filters by region code (EAS, SSF, … plus membership groupings such as AFE, EUU, LDC), income level (LIC, LMC, UMC, HIC), and lending type (IDX, IBD, IDB, LNX), combined by AND; up to 150 per page (~50 KB)
  • Returns ISO codes, region, income level, lending type, capital, and coordinates; an invalid region or income code is a typed invalid_filter error
  • Individual countries only by default — include_aggregates=true adds regional, income-group, and world aggregates, flagged isAggregate

worldbank_get_country <sub>tool</sub>

  • Accepts one ISO2 (US), ISO3 (USA), or World Bank aggregate code (EAS, HIC, WLD) — all or a list is rejected as multiple_countries
  • Returns region, income level, lending type, capital, and coordinates
  • Typed country_not_found error with a recovery hint pointing to worldbank_list_countries

worldbank_search_indicators <sub>tool</sub>

  • At least one of query, topic_id, or source_id; every keyword term must match the indicator ID, name, or description, in any order; up to 100 per page
  • Ranked exact ID/name matches first, then names starting with the phrase, then looser matches, then description-only ones; World Development Indicators series lead each tier, and a series leads its own breakdowns (SP.DYN.LE00.IN ahead of SP.DYN.LE00.FE.IN)
  • Each indicator ID appears once, with the first 150 characters of its description; worldbank_get_indicator returns the whole

worldbank_get_indicator <sub>tool</sub>

  • One indicator ID per call, made of letters, digits, ., _, or - — all, a list, or any other character is rejected
  • Returns description, unit, source dataset, source organization, and topics; HTML line breaks in the description are preserved, other markup is stripped
  • Typed indicator_not_found error pointing to worldbank_search_indicators

worldbank_get_data <sub>tool</sub>

  • countries as ISO2, ISO3, aggregate codes, WLD, or all alone; at most one of date_range (a year, quarter, or month, or a range of one type), mrv (the latest N periods across the countries), or mrnev (each country's own latest N values — Eritrea's GDP per capita at 2011, where mrv gives 2025 and null); frequency (annual, quarterly, monthly) picks the period form on series that publish several (CPTOTSAXN for Kenya, monthly, mrv: 3 → 2026M07–M05); up to 200 observations a page (~50 KB)
  • Rows carry both country codes, isAggregate, and value: null for a missing cell, with nullCount per page and lastUpdated, the source's data vintage; every date_range, mrv, and mrnev read is checked for another query's cached answer and re-read once, and one that fails twice is an upstream_inconsistent error rather than a served result
  • Indicators the standard endpoint doesn't serve (WDI Database Archives, PEFA, ICP, GDLD, International Debt Statistics: DSSI, Food Prices for Nutrition) come from their own dataset, disclosed in sourceScoped with the release, classification, sector, or counterpart area applied (dimension_value)

worldbank_get_poverty <sub>tool</sub>

  • Economies by ISO3 or ISO2 code, including those PIP publishes only as model estimates (AFG), plus PIP's aggregates: WLD, regions (SSF, AFE), income groups (LMIC/LMC), and lending groups (IDX, IDB, IBD, REST); year as a year, all, or MRV; any poverty_line, defaulting to the applied PPP vintage's international line; up to 70 estimates a page (~50 KB)
  • Headcount, gap, severity, and Watts index, plus the Gini coefficient, mean log deviation, polarization, and decile shares on survey rows; estimationType separates survey rows from gap-filled ones, whose inequality fields are null, and isAggregate flags aggregate rows
  • fill_gaps (default true) includes gap-filled years; welfare_type and reporting_level narrow economy results, and ppp_version picks the PPP vintage

worldbank_search_projects <sub>tool</sub>

  • Free-text query combined by AND with countries (ISO3, ISO2, or a World Bank regional code such as 3A), region, status, financial_type, and a board-approval window (approved_from/approved_to); up to 80 projects a page, newest approval first
  • Returns ID, name, country, region, status, dates, the commitment amount with its IBRD, IDA, and grant parts, financing windows, sectors, and a URL; countryCodes chain into the other tools, a bad code or unparseable query is a typed invalid_country_code / invalid_query error, and an empty result names the filter that emptied it
  • include_abstract (off by default) adds abstracts at 8 projects a page, each cut at 5,000 characters

worldbank://indicator/{indicatorId} <sub>resource</sub>

  • Indicator metadata as application/json — name, description, unit, source dataset, source organization, and topics
  • indicatorId comes from worldbank_search_indicators; an unknown ID returns a typed not-found error with a recovery hint, while an upstream outage or timeout keeps its own classification instead of reading as a bad ID

worldbank://country/{countryCode} <sub>resource</sub>

  • Country/aggregate metadata as application/json — ISO codes, region, income level, capital, coordinates
  • Accepts one ISO2, ISO3, or World Bank aggregate code — all or a list is rejected; an unknown code returns a typed not-found error, distinct from a transient upstream failure

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

World Bank-specific:

  • Full World Bank Open Data coverage across three separate upstream APIs — the Indicators API, the Poverty and Inequality Platform, and the Projects lending portfolio
  • 60+ years of development data (PIP coverage from 1963) across 29,500+ indicators for 200+ countries and regional aggregates
  • Client-side keyword search over the indicator catalog, since the upstream searchterm parameter doesn't filter
  • Null-value transparency — null observations and nullCount surfaced rather than silently dropped
  • isAggregate flag on every country/data row to distinguish individual countries from aggregate entities

Agent-friendly output:

  • Tool cross-references woven into descriptions — e.g. worldbank_search_indicators names worldbank_list_topics for topic IDs, worldbank_get_data names worldbank_search_indicators for indicator discovery
  • Structured error contracts with typed reason codes and actionable recovery hints on every tool
  • Consistent pagination metadata (totalCount, currentPage, totalPages) across all list/search/data tools, with a notice naming the pages that exist when a request runs past the end

Getting started

Public Hosted Instance

A public instance is available at `https://worldbank.cas

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3
CategoryMarketing
Updated3d ago
Forks0

Languages

TypeScript

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low