# World Bank Countries MCP MCP

> The World Bank Countries MCP gives your agent a master taxonomy for global metadata. It lets you look up country ISO codes, identify specific economic income levels (like High or Low Income), and group countries into official geographic regions. Essential for anyone building data pipelines that need consistent international location data.

## Overview
- **Category:** brain-trust
- **Price:** Free
- **Tags:** geographic-data, iso-standards, country-metadata, economic-classification, taxonomy, global-data

## Description

Need reliable geo-data for anything from financial modeling to global supply chains? This MCP gives your agent the World Bank's full map of country metadata. Instead of guessing codes or relying on incomplete datasets, you get precise ISO standards and classifications.

It lets you pull massive lists of countries and their capitals right out of the gate. You can also classify economies, figuring out if a nation is High Income (HIC) or Lower Middle Income based on established global metrics. Plus, it handles regional grouping, letting you filter by defined blocks like 'East Asia & Pacific' or 'Latin America & Caribbean.'

Building complex automations across multiple systems requires absolute data trust. That’s where Vinkius comes in. Every time your agent pulls a country code or checks an income level using this MCP, the action is recorded with a cryptographically signed audit trail. You always know exactly what happened and when it happened. This makes it perfect for high-stakes economic analysis.

## Tools

### list_countries
Generates a comprehensive list of World Bank countries, including their capital and ISO code.

### search_regions
Provides defined World Bank geographic regions for grouping nations by macro-area.

### search_income_levels
Lists world bank income levels (e.g., HIC, LIC) to classify a country's economic status.

## Prompt Examples

**Prompt:** 
```
List all high-income countries in East Asia.
```

**Response:** 
```
🌍 **High-Income Countries: East Asia**

Japan (JPN), South Korea (KOR), Singapore (SGP), Hong Kong SAR (HKG), and Macao SAR (MAC) are classified as High Income Countries (HIC) in the East Asia & Pacific region by the World Bank.
```

**Prompt:** 
```
What are the World Bank geographic regions?
```

**Response:** 
```
🌍 **World Bank Regions**

1. East Asia & Pacific
2. Europe & Central Asia
3. Latin America & Caribbean
4. Middle East & North Africa
5. North America
6. South Asia
7. Sub-Saharan Africa
```

**Prompt:** 
```
Show me the income level classification for all South American countries.
```

**Response:** 
```
🌍 **Income Levels: South America**

Upper-Middle Income: Brazil, Colombia, Peru, Argentina, Ecuador, Paraguay. High Income: Chile, Uruguay. Lower-Middle Income: Bolivia. The classification is based on GNI per capita thresholds set by the World Bank annually.
```

## Capabilities

### List all World Bank countries
Retrieve complete lists of country names, their official ISO codes, and capital cities.

### Determine income classifications by level
Filter a list of countries based on specific economic thresholds, like High Income Country (HIC) or Low Income Country (LIC).

### Find established geographic regions
Group countries into recognized World Bank macro-regions such as the Middle East & North Africa or Sub-Saharan Africa.

## Use Cases

### Mapping a new market entry strategy
An analyst needs to compare all potential markets in Central America, but they need to make sure the list only includes countries classified as 'Upper-Middle Income'. They use `search_regions` first to narrow down the area, then use `search_income_levels` on that subset to get a clean, actionable list for their team.

### Cleaning a messy spreadsheet dataset
A data engineer inherits a massive CSV file with country names and inconsistent codes. They run the agent using `list_countries` to validate every single name against the master World Bank list, ensuring 100% clean ISO standards before loading it into the database.

### Building an international finance dashboard
A financial model requires aggregating data only from countries in a specific region (e.g., East Asia) that also meet a minimum income threshold (HIC). The agent chains `search_regions` and `search_income_levels` to build a filtered, precise dataset for the dashboard.

### Validating international aid eligibility
A non-profit needs to process grant applications. They use the MCP to verify if an applicant's country is officially classified as Lower Income (LIC) and belongs to a specific region, ensuring compliance with funding rules.

## Benefits

- Need to filter data? The `list_countries` tool gives you the raw, accurate list of countries needed for any dataset.
- Stop guessing a country's economic status. Use `search_income_levels` to automatically check if a nation is classified as HIC or LIC based on world metrics.
- Structure your analysis by geography. The `search_regions` tool lets you group nations into official blocks like Latin America & Caribbean.
- The data integrity is locked down. Every single call records an immutable, cryptographically signed audit trail through Vinkius, so you never lose track of how the numbers were derived.
- Build complex pipelines by chaining this MCP with others in the catalog. You can combine geo-data with messaging or billing data into one automated flow.

## How It Works

The bottom line is you get standardized, reliable country data without needing to manage complex API keys or configuration files.

1. You subscribe to the MCP and connect it to your agent from any compatible client.
2. Your agent makes a call, asking for specific geo-data, like 'all HIC countries in Asia.'
3. The MCP returns structured metadata containing ISO codes, region tags, and income levels that your agent can use immediately.

## Frequently Asked Questions

**How do I get started?**
Our World Bank Open Data servers require absolutely zero authentication. You do not need to register, get an API key, or setup webhooks. Just instantly connect and your AI agent can begin querying decades of global data.

**Can it map complex regions without hardcoding ISO values?**
Yes! Your agent queries the `/country` endpoint to dynamically resolve geographic mappings in real time, no static lists required.

**Does it classify nations into income tiers?**
Yes. Use the income-level resolution tools so your AI can immediately segregate advanced economies from developing nations based on precise World Bank thresholds.

**What is the scale of the data I can access?**
You have direct access to 64 years of historical data covering 196+ sovereign states and global regional aggregates, powered directly by the World Bank's robust open data initiatives.

**What security measures protect credentials when running list_countries?**
Your keys never sit on disk, period. Credentials pass through a zero-trust proxy and are only used while in transit for every tool call. This keeps your data secure from the moment you connect to Vinkius.

**Can I call search_regions repeatedly, and are there any rate limits?**
Vinkius handles traffic management across all MCPs. While we don't publish hard limits, the platform monitors usage patterns. This ensures stable execution whether you make a single call or run complex automations.

**Does the result of search_income_levels provide enough detail for programmatic use?**
Yes, the data is returned in a clean, structured JSON format. You can immediately parse and integrate this output directly into your code or automated data pipelines without needing complex cleanup.

**If list_countries encounters an error, how is that failure reported?**
Every tool call generates a cryptographically signed audit trail. If something goes wrong, you receive precise feedback detailing the exact point of failure, making debugging and refining your agent logic straightforward.