`get_indicator`

Pack: worldbank · Endpoint: https://gateway.pipeworx.io/worldbank/mcp

Get World Bank time-series data — economic, social, and development statistics — for ANY country worldwide (Spain, Brazil, Germany, Nigeria, Japan, etc.). PREFER for “unemployment rate in ”, ” inflation rate”, “GDP of ”, ” population / life expectancy / poverty rate / CO2 emissions”. Pass the ISO country code + a World Bank indicator code; common ones: GDP=NY.GDP.MKTP.CD, GDP per capita=NY.GDP.PCAP.CD, inflation=FP.CPI.TOTL.ZG, unemployment=SL.UEM.TOTL.ZS, population=SP.POP.TOTL, life expectancy=SP.DYN.LE00.IN, poverty rate=SI.POV.DDAY, literacy=SE.ADT.LITR.ZS, CO2 per capita=EN.GHG.CO2.PC.CE. (Annual data — a national statistics office may have fresher monthly figures.)

Parameters

Name	Type	Required	Description
`country_code`	string	yes	ISO country code (e.g., “US”, “GBR”, “CN”)
`indicator`	string	yes	World Bank indicator code (e.g., “NY.GDP.MKTP.CD”, “SP.POP.TOTL”)
`date_range`	string	no	Year range in format “start:end” (default: 2015:2024). Example: “2000:2023”

Example call

Arguments

{
  "country_code": "CN",
  "indicator": "NY.GDP.MKTP.CD"
}

curl

curl -X POST https://gateway.pipeworx.io/worldbank/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_indicator","arguments":{"country_code":"CN","indicator":"NY.GDP.MKTP.CD"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_indicator', {
  "country_code": "CN",
  "indicator": "NY.GDP.MKTP.CD"
});

More examples

{
  "country_code": "IN",
  "indicator": "SP.POP.TOTL",
  "date_range": "2000:2023"
}

Response shape

Always returns: country, country_id, indicator_id, indicator_name, date_range, total_records, last_updated, data

Field	Type	Description
`country`	string	Country name or code
`country_id`	string \| null	World Bank country ID
`indicator_id`	string	World Bank indicator code
`indicator_name`	string \| null	Full indicator name/description
`date_range`	string	Requested date range in start:end format
`total_records`	number	Total number of records available
`last_updated`	string \| null	Last update timestamp from World Bank API
`data`	array	Time-series data points sorted by year descending

Full JSON Schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name or code"
    },
    "country_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "World Bank country ID"
    },
    "indicator_id": {
      "type": "string",
      "description": "World Bank indicator code"
    },
    "indicator_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full indicator name/description"
    },
    "date_range": {
      "type": "string",
      "description": "Requested date range in start:end format"
    },
    "total_records": {
      "type": "number",
      "description": "Total number of records available"
    },
    "last_updated": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last update timestamp from World Bank API"
    },
    "data": {
      "type": "array",
      "description": "Time-series data points sorted by year descending",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": [
              "string",
              "null"
            ],
            "description": "Year of the observation"
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Indicator value for the year"
          }
        }
      }
    }
  },
  "required": [
    "country",
    "country_id",
    "indicator_id",
    "indicator_name",
    "date_range",
    "total_records",
    "last_updated",
    "data"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "worldbank": {
      "url": "https://gateway.pipeworx.io/worldbank/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_indicator