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-serverIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
MarketingSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| worldbank-mcp-server (this skill)by cyanheads | 80 | 3 | 3d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.4k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.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.
Skill content
View source on GitHubPublic 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.
1Agriculture,3Economy & Growth) feedtopic_idonworldbank_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.
2for World Development Indicators) feedsource_idonworldbank_search_indicators
worldbank_list_countries <sub>tool</sub>
- Filters by region code (
EAS,SSF, … plus membership groupings such asAFE,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_filtererror - Individual countries only by default —
include_aggregates=trueadds regional, income-group, and world aggregates, flaggedisAggregate
worldbank_get_country <sub>tool</sub>
- Accepts one ISO2 (
US), ISO3 (USA), or World Bank aggregate code (EAS,HIC,WLD) —allor a list is rejected asmultiple_countries - Returns region, income level, lending type, capital, and coordinates
- Typed
country_not_founderror with a recovery hint pointing toworldbank_list_countries
worldbank_search_indicators <sub>tool</sub>
- At least one of
query,topic_id, orsource_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.INahead ofSP.DYN.LE00.FE.IN) - Each indicator ID appears once, with the first 150 characters of its description;
worldbank_get_indicatorreturns 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_founderror pointing toworldbank_search_indicators
worldbank_get_data <sub>tool</sub>
countriesas ISO2, ISO3, aggregate codes,WLD, orallalone; at most one ofdate_range(a year, quarter, or month, or a range of one type),mrv(the latest N periods across the countries), ormrnev(each country's own latest N values — Eritrea's GDP per capita at 2011, wheremrvgives 2025 and null);frequency(annual,quarterly,monthly) picks the period form on series that publish several (CPTOTSAXNfor Kenya,monthly,mrv: 3→ 2026M07–M05); up to 200 observations a page (~50 KB)- Rows carry both country codes,
isAggregate, andvalue: nullfor a missing cell, withnullCountper page andlastUpdated, the source's data vintage; everydate_range,mrv, andmrnevread is checked for another query's cached answer and re-read once, and one that fails twice is anupstream_inconsistenterror 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
sourceScopedwith 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);yearas a year,all, orMRV; anypoverty_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;
estimationTypeseparates survey rows from gap-filled ones, whose inequality fields are null, andisAggregateflags aggregate rows fill_gaps(defaulttrue) includes gap-filled years;welfare_typeandreporting_levelnarrow economy results, andppp_versionpicks the PPP vintage
worldbank_search_projects <sub>tool</sub>
- Free-text
querycombined by AND withcountries(ISO3, ISO2, or a World Bank regional code such as3A),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;
countryCodeschain into the other tools, a bad code or unparseable query is a typedinvalid_country_code/invalid_queryerror, 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 indicatorIdcomes fromworldbank_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 —
allor 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
searchtermparameter doesn't filter - Null-value transparency —
nullobservations andnullCountsurfaced rather than silently dropped isAggregateflag 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_indicatorsnamesworldbank_list_topicsfor topic IDs,worldbank_get_datanamesworldbank_search_indicatorsfor indicator discovery - Structured error contracts with typed
reasoncodes and actionablerecoveryhints 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
Agent-Reach
112.4kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
