wbgapi360

<div align="center">

wbgapi360

World Bank Data API client with two interfaces: A synchronous Python API for analysts, and a Model Context Protocol (MCP) server for AI agents.

    

</div>

---

What You Get

• Smart indicator discovery (search) with heuristic ranking.
• High-level data retrieval (get_data) with code normalization.
• Publication-style charts (plot) with optional visual dependencies.
• MCP tools for search, data access, comparisons, trend analysis, rankings, and chart generation.

Installation

pip install wbgapi360

Optional extras:

# Visualization support (matplotlib + seaborn)
pip install "wbgapi360[visual]"

# Mapping support (geopandas + matplotlib)
pip install "wbgapi360[map]"

Python API (Analysts)

import wbgapi360 as wb

# 1) Search indicators
results = wb.search("inflation")
for r in results[:3]:
    print(f"[{r['code']}] {r['name']}")

# 2) Fetch data
df = wb.get_data(
    indicator="NY.GDP.MKTP.KD.ZG",
    economies=["USA", "CHN", "PER"],
    years=10
)
print(df.head())

# 3) Plot (requires: pip install "wbgapi360[visual]")
wb.plot(
    chart_type="trend",
    data=df,
    title="GDP Growth",
    subtitle="Annual %"
)

MCP Server (AI Agents)

Run the server

After installation:

wbgapi360

From repository source:

python -m wbgapi360.mcp.server

Claude Desktop example

{
  "mcpServers": {
    "worldbank": {
      "command": "wbgapi360",
      "args": []
    }
  }
}

MCP tools

| Tool | Description | | :--- | :--- | | search_indicators | Semantic search for indicator codes. | | get_data | Retrieve time series data for one or many countries. | | compare_countries | Compare countries across one or many indicators. | | analyze_trend | Return trend statistics (growth, volatility, direction). | | rank_countries | Rank countries for an indicator globally or by region. | | plot_chart | Generate chart images from JSON payloads. |

CLI (Developer Utility)

A separate CLI is provided for manual testing and quick queries:

wbgapi360-cli --help

Commands:

• search
• data
• config

Development

pip install -e ".[dev,visual]"
python -m pytest -q tests

Project Notes

Unofficial client

This software is an independent open-source project. It is not affiliated with The World Bank Group.

Attribution

wbgapi360 is inspired by Tim Herzog's original wbgapi project and extends it with MCP support and AI-focused workflows.

Author

Maykol Medrano Applied Economist / Policy Data Scientist Email: mmedrano2@uc.cl

License

MIT. See LICENSE.