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.
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:
searchdataconfig
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.
Metadata
Release files for wbgapi360 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| wbgapi360-0.3.2.tar.gz | 54.9 kB | Without provenance | Details for wbgapi360-0.3.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wbgapi360-0.3.2-py3-none-any.whl | Python 3 | none | any | Details for wbgapi360-0.3.2-py3-none-any.whl |
Total release size: 103.7 kB
Release files / wbgapi360-0.3.2.tar.gz
| Download URL | wbgapi360-0.3.2.tar.gz |
|---|---|
| Size | 54.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
94cac3e9f666e8af126a72682d2f07656b008a84c02ba1dd6d8b24435633f635
|
|
BLAKE2b-256 checksum How to use checksums |
6ec241f2e9878c30dfd65747c0503bfea18d85a15c92129b1b77513dec65d6f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Release files / wbgapi360-0.3.2-py3-none-any.whl
| Download URL | wbgapi360-0.3.2-py3-none-any.whl |
|---|---|
| Size | 48.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8dfa179b4a8878e36477ab9dff7e707e547d5213722acc539eaa2bc12c802a95
|
|
BLAKE2b-256 checksum How to use checksums |
f7ebbc773fb1d1ff973e57e1e0ded4ced4da5224699fe5cc661b037a0423ecf0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Security for wbgapi360 0.3.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.