---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/world-economy
---
# World Economy

World Bank data: 16,000+ economic, social, and environmental indicators for every country from 1960 to present. Look up time series, compare countries, or search indicator codes. For economic research, country risk, and data journalism.

- **Version:** 0.02
- **Categories:** finance, data

## Skills (3)

### Get Indicator (`indicator`)

Get a specific economic indicator for a country over time. Common indicators: GDP (NY.GDP.MKTP.CD), population (SP.POP.TOTL), inflation (FP.CPI.TOTL.ZG), unemployment (SL.UEM.TOTL.ZS).

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `country` | string | Yes | ISO 3166-1 alpha-2 code like 'US', 'GB', or 'all' for world |
| `indicator` | string | Yes | Indicator code like 'NY.GDP.MKTP.CD' |
| `years` | number | No | Number of most recent years to return [default: 10] |

**Returns:** Time series of the requested indicator with year and value pairs

**Examples:**

*US GDP over the last 5 years:*

```json
{
  "country": "US",
  "indicator": "NY.GDP.MKTP.CD",
  "years": 5
}
```

### Compare Countries (`compare_countries`)

Compare an economic indicator across multiple countries for the most recent available year. Useful for benchmarking and cross-country analysis.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `countries` | string | Yes | Semicolon-separated ISO codes like 'US;GB;DE;JP' |
| `indicator` | string | Yes | Indicator code like 'NY.GDP.MKTP.CD' |

**Returns:** Comparison of the indicator across countries sorted by value descending

**Examples:**

*Compare GDP across G7 countries:*

```json
{
  "countries": "US;GB;DE;FR;JP;CA;IT",
  "indicator": "NY.GDP.MKTP.CD"
}
```

### Search Indicators (`search_indicators`)

Search for available economic indicators by keyword. There are 16,000+ indicators covering economics, health, education, environment, and more.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Keyword like 'gdp' or 'education' |
| `page_size` | number | No | Number of results to return [default: 10] |

**Returns:** List of matching economic indicators with codes, names, and descriptions

**Examples:**

*Find indicators about education:*

```json
{
  "query": "education"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call world-economy indicator --country US --indicator NY.GDP.MKTP.CD --years 5

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"world-economy","skill":"indicator","input":{"country":"US","indicator":"NY.GDP.MKTP.CD","years":5}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### How do I find the right indicator code?

Use `search_indicators` by keyword first. It helps you locate the exact World Bank code before pulling a time series.

### Can I track one country over time?

Yes. Use `indicator` with a country and a code like GDP, population, or inflation to get a year-by-year series.

### Can I compare multiple countries on one metric?

Use `compare_countries` with one indicator and a semicolon-separated list of countries like `US;GB;DE`.

### Can I get the world aggregate instead of a single country?

Yes. Pass `all` as the country when you want the global series for an indicator.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs