# Mcp Wbgapi360

> Enterprise-grade Async Python Client for World Bank Data360 API with hybrid MCP support for AI Agents (Claude/OpenAI).

- **Type:** MCP server
- **Install:** `agentstack add mcp-maykolmedrano-mcp-wbgapi360`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MaykolMedrano](https://agentstack.voostack.com/s/maykolmedrano)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MaykolMedrano](https://github.com/MaykolMedrano)
- **Source:** https://github.com/MaykolMedrano/mcp_wbgapi360

## Install

```sh
agentstack add mcp-maykolmedrano-mcp-wbgapi360
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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.**

[](https://pypi.org/project/wbgapi360/)
[](https://www.python.org/downloads/)
[](https://github.com/MaykolMedrano/mcp_wbgapi360/actions/workflows/ci.yml)
[](https://pypi.org/project/wbgapi360/)
[](https://opensource.org/licenses/MIT)
  

---

## 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

```bash
pip install wbgapi360
```

Optional extras:

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

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

## Python API (Analysts)

```python
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:

```bash
wbgapi360
```

From repository source:

```bash
python -m wbgapi360.mcp.run
```

### Claude Desktop example

```json
{
  "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:

```bash
wbgapi360-cli --help
```

Commands:

- `search`
- `data`
- `config`

## Development

```bash
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](mailto:mmedrano2@uc.cl)

## License

MIT. See `LICENSE`.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MaykolMedrano](https://github.com/MaykolMedrano)
- **Source:** [MaykolMedrano/mcp_wbgapi360](https://github.com/MaykolMedrano/mcp_wbgapi360)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-maykolmedrano-mcp-wbgapi360
- Seller: https://agentstack.voostack.com/s/maykolmedrano
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.