---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/country-data
---
# Country Data

Structured facts for every country. Look up any country by name, ISO code, or currency for capital, population, languages, timezones, borders, and flags. Search by region or language, or compare two countries side by side.

- **Version:** 0.02
- **Categories:** data

## Skills (3)

### Country Lookup (`lookup`)

Get comprehensive data for a country by name, ISO code, or currency code. Returns capital, population, languages, currencies, region, timezones, borders, and flag.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Country name, ISO 3166-1 alpha-2/3 code, or currency code like "US", "USA", "United States", "USD" |

**Returns:** Comprehensive country data including capital, population, languages, currencies, timezones, borders, flags, and map links

**Examples:**

*Look up country data for Japan:*

```json
{
  "query": "Japan"
}
```

### Search Countries (`search`)

Search for countries by name, region, language, or currency. Returns matching countries with key information for comparison and filtering.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search term (country name, region, language, or currency depending on filter_by) |
| `filter_by` | string | No | What to search by: "name", "region", "language", or "currency" (default "name") (name, region, language, currency) [default: "name"] |

**Returns:** List of matching countries with name, capital, population, region, and flag emoji

**Examples:**

*Find countries in Europe:*

```json
{
  "query": "europe",
  "filter_by": "region"
}
```

### Compare Countries (`compare`)

Side-by-side comparison of two countries across key metrics including population, area, GDP, languages, currencies, and timezones.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `country_a` | string | Yes | First country name or code to compare |
| `country_b` | string | Yes | Second country name or code to compare |

**Returns:** Side-by-side comparison of two countries including population, area, languages, currencies, and timezones

**Examples:**

*Compare USA and China:*

```json
{
  "country_a": "US",
  "country_b": "CN"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call country-data lookup --query Japan

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"country-data","skill":"lookup","input":{"query":"Japan"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I look up a country by name, code, or currency?

Yes. Use `lookup` with a country name, ISO alpha-2 or alpha-3 code, or even a currency code like `USD`.

### Can I compare two countries side by side?

Use `compare` to see population, area, languages, currencies, and timezones for two countries in one view.

### Can I search for countries by region, language, or currency?

Yes. Use `search` and set `filter_by` to `region`, `language`, or `currency` depending on what you need.

### What kind of details does a lookup return?

Expect core country facts such as capital, population, languages, currencies, region, timezones, borders, and flag data.

---

## 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