> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vistazo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# World Bank

> Global development data & indicators

Global development indicators — population, GDP, life expectancy, CO₂, and thousands more, for every country and year.

Data from World Bank Open Data (CC BY 4.0). Upstream API: [data360.worldbank.org](https://data360.worldbank.org/).

**Endpoint** `https://mcp.vistazo.ai/worldbank/mcp`

| Tool                                            | What it does           |           |
| ----------------------------------------------- | ---------------------- | --------- |
| [`search_indicators`](#search_indicators)       | Search indicators      | Read-only |
| [`list_indicators`](#list_indicators)           | List indicators        | Read-only |
| [`get_metadata`](#get_metadata)                 | Get indicator metadata | Read-only |
| [`get_disaggregation`](#get_disaggregation)     | Get disaggregation     | Read-only |
| [`find_codelist_value`](#find_codelist_value)   | Find codelist value    | Read-only |
| [`expand_country_group`](#expand_country_group) | Expand country group   | Read-only |
| [`get_data`](#get_data)                         | Get indicator data     | Read-only |
| [`rank_countries`](#rank_countries)             | Rank countries         | Read-only |

## search\_indicators

`Read-only` · `Reaches outside Vistazo`

Search World Bank indicators by keyword (e.g. "GDP per capita", "life expectancy"). Returns matching indicators with their id, database\_id, definition, and coverage — the entry point for every other tool. Optionally verify a country is covered.

## list\_indicators

`Read-only` · `Reaches outside Vistazo`

List the indicator ids in a database, paginated (limit/offset, default 200 per page; the response carries the full count and has\_more). Use search\_indicators first to find the database\_id — and prefer it for discovery, since large databases hold thousands of ids.

## get\_metadata

`Read-only` · `Reaches outside Vistazo`

Fetch an indicator's full metadata — definition, methodology, source, limitations. Use to understand exactly what a number measures before charting it.

## get\_disaggregation

`Read-only` · `Reaches outside Vistazo`

List the dimensions available for an indicator — which years have data (TIME\_PERIOD), how many countries (REF\_AREA), and breakdowns like SEX/AGE. Call this before get\_data to know valid years and filters. REF\_AREA is summarized as a count plus a short sample; to check whether a specific country is present, pass `contains` (e.g. "italy") to search that codelist by code or name.

## find\_codelist\_value

`Read-only` · `Reaches outside Vistazo`

Translate a human name into the standardized code the API needs — e.g. "Kenya" → "KEN", "European Union" → "EUU", "female" → "F". Returns ranked matches (preferring codes get\_data actually accepts); use the top id.

## expand\_country\_group

`Read-only` · `Reaches outside Vistazo`

Expand a World Bank group code into its member countries — e.g. "SAS" (South Asia) or "LIC" (Low income) → the ISO3 codes. Use to turn a region/income/lending group into countries for get\_data or rank\_countries. Pre-computed aggregates (e.g. "EUU", "WLD") can't be expanded but are flagged as usable directly.

## get\_data

`Read-only` · `Reaches outside Vistazo`

Fetch the actual time-series observations for an indicator. Returns one row per country-year (ref\_area, time\_period, obs\_value) — chart-ready. Rows come back newest first, so `limit` drops the OLDEST rows — fetching a wide year range with a small limit reliably yields the most recent observations. Breakdowns default to totals unless you filter. Call get\_disaggregation first to learn valid years and filters.

## rank\_countries

`Read-only` · `Reaches outside Vistazo`

Rank countries by an indicator value for a year — leaderboards and top/bottom lists. Rank the whole world, a group (via country\_group like "SAS"), or an explicit set (country\_codes). Returns rank, country, value, and percentile.