Skip to main content
Glama

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.

PyPI version Python CI Downloads License: 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.

Related MCP server: Countries MCP Server

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.

Available Tools

6 tools
analyze_trendA

Analyze time-series trend with statistical insights.

Returns growth rates, volatility, trend direction, and more.

Inputs: economy (required), indicator (required), years, include_stats. Returns: result

compare_countriesB

Compare multiple countries across indicators.

Inputs: economies (required), indicators (required), years, normalize. Returns: result

get_dataC

Fetch World Bank data with auto-correction. Set labels=True for human-readable country names.

Inputs: economies (required), indicator_code (required), years, labels. Returns: result

plot_chartC

Generate chart with FT style. Advanced: region (latam/africa/europe), bbox, bins, category_labels for map_categorical.

Inputs: data_json (required), chart_type (required), bbox, bins, +4 more. Returns: result

rank_countriesB

Rank countries by indicator value.

Inputs: indicator (required), top_n, region. Returns: result

search_indicatorsC

Search for World Bank indicators using Smart Ranking.

Inputs: query (required), limit, database_id. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: searching indicators, fetching data, plotting, comparing, analyzing trends, and ranking. No two tools appear to do the same thing.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in lowercase snake_case (search_indicators, get_data, plot_chart, compare_countries, analyze_trend, rank_countries). The naming is uniform and predictable.

    Tool Count5/5

    With 6 tools, the server is well-scoped for a World Bank data analysis context. Each tool covers a distinct aspect of the workflow without being excessive or minimal.

    Completeness4/5

    The surface covers discovery, data retrieval, visualization, comparison, trend analysis, and ranking, which is solid. A minor gap is the lack of explicit country metadata or list endpoints, but this can often be worked around with known country codes.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that interfaces with the WorldBank API to retrieve economic and labor market data such as GDP and employment indicators. It allows LLMs to query global development statistics including unemployment rates, labor force participation, and sectoral employment data.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes World Bank development data and country information via MCP resources and tools, enabling AI agents to query historical indicators and live API data.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides access to World Bank economic and country data without an API key, allowing users to search countries, fetch indicator time series, and compare latest values.
      5
      MIT