https://mcp.vistazo.ai/worldbank/mcp
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.