Worldbank Tools#

Configuration File: worldbank_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the worldbank_tools.json configuration file.

Available Tools#

WorldBank_get_country (Type: BaseRESTTool)#

Get metadata about a country from the World Bank database. Returns country name, ISO codes, world…

WorldBank_get_country tool specification

Tool Information:

  • Name: WorldBank_get_country

  • Type: BaseRESTTool

  • Description: Get metadata about a country from the World Bank database. Returns country name, ISO codes, world region, income level, lending type, capital city, and geographic coordinates. Essential for looking up country codes before querying World Bank indicators.

Parameters:

  • country (string) (required) ISO 3166-1 alpha-2 or alpha-3 country code (e.g., ‘US’ or ‘USA’ for United States, ‘GB’ or ‘GBR’ for UK, ‘DE’ or ‘DEU’ for Germany)

Example Usage:

query = {
    "name": "WorldBank_get_country",
    "arguments": {
        "country": "example_value"
    }
}
result = tu.run(query)

WorldBank_get_indicator (Type: BaseRESTTool)#

Get World Bank development indicator data for one or more countries over time. Returns economic, …

WorldBank_get_indicator tool specification

Tool Information:

  • Name: WorldBank_get_indicator

  • Type: BaseRESTTool

  • Description: Get World Bank development indicator data for one or more countries over time. Returns economic, health, education, and social development metrics from the World Development Indicators (WDI) database. Covers 200+ countries with annual data going back to 1960s. Example indicators: NY.GDP.MKTP.CD (GDP current USD), SP.POP.TOTL (total population), SH.DYN.MORT (child mortality), SE.ADT.LITR.ZS (adult literacy rate), SP.DYN.LE00.IN (life expectancy), SH.MED.PHYS.ZS (physicians per 1000), EN.ATM.CO2E.PC (CO2 per capita), SL.UEM.TOTL.ZS (unemployment rate). Results are paginated server-side: the response reports ‘count’ (rows returned), ‘total_available’ (rows matching upstream) and a ‘truncated’ flag, and when truncated a ‘truncation_note’ explaining how to retrieve the rest via ‘per_page’/’page’.

Parameters:

  • country (string) (required) ISO 3166-1 alpha-3 country code (e.g., ‘USA’, ‘GBR’, ‘DEU’, ‘CHN’, ‘IND’, ‘BRA’) or ‘all’ for all countries, or semicolon-separated codes (e.g., ‘USA;GBR;DEU’)

  • indicator (string) (required) World Bank indicator code (e.g., ‘NY.GDP.MKTP.CD’ for GDP, ‘SP.POP.TOTL’ for population, ‘SH.DYN.MORT’ for child mortality, ‘SE.ADT.LITR.ZS’ for literacy)

  • mrv ([‘integer’, ‘null’]) (optional) Most recent values - number of most recent years to return (e.g., 5 for last 5 years). Default returns all available years.

  • date ([‘string’, ‘null’]) (optional) Year or year range to filter data (e.g., ‘2020’, ‘2015:2023’ for a range)

  • per_page ([‘integer’, ‘null’]) (optional) Rows returned per request (default 1000, maximum 32500). One row is one country-year observation, so a panel of N countries over Y years needs per_page >= N*Y. Raise this when the response reports truncated=true.

  • page ([‘integer’, ‘null’]) (optional) 1-based page number of the result set (default 1). Only needed when a result exceeds per_page: the response reports total_available and pages so you can fetch the remaining pages.

Example Usage:

query = {
    "name": "WorldBank_get_indicator",
    "arguments": {
        "country": "example_value",
        "indicator": "example_value"
    }
}
result = tu.run(query)

WorldBank_search_indicators (Type: WorldBankIndicatorSearchTool)#

Search the World Development Indicators (WDI, ~1,500 indicators covering health, education, econo…

WorldBank_search_indicators tool specification

Tool Information:

  • Name: WorldBank_search_indicators

  • Type: WorldBankIndicatorSearchTool

  • Description: Search the World Development Indicators (WDI, ~1,500 indicators covering health, education, economy, environment, infrastructure, poverty and more) by keyword. Every word of the query must appear in the indicator’s name, code or description; name matches rank first. Returns indicator codes, names, descriptions, units and the source database, as [metadata, indicators] with metadata.total = number of matches. Use it to discover indicator codes for WorldBank_get_indicator. Only the WDI database is searched, not the other ~29,000 indicators in World Bank’s other databases.

Parameters:

  • query (string) (required) Search words; all must occur in the indicator name, code or description (e.g., ‘GDP’, ‘mortality’, ‘literacy’, ‘CO2’, ‘life expectancy’).

  • per_page ([‘integer’, ‘null’]) (optional) Number of results to return (default 10, max 1000)

Example Usage:

query = {
    "name": "WorldBank_search_indicators",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)