# Countries

> Countries is a freemium MCP server for web search and scraping. MCP server giving AI clients country lookups by name, code, region, language or currency. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/countries
- **Repository:** https://github.com/pipeworx-io/mcp-countries
- **MCP Registry name:** io.github.pipeworx-io/countries
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

The README describes this as a thin gateway endpoint: five country-data tools backed by the REST Countries dataset, reached through the Pipeworx gateway rather than run locally. Searches can return official names, capitals, populations, areas, languages, currencies, flag emoji and land borders, so a question like which countries border a given nation can be answered in one call.

The server is available as a hosted streamable-HTTP endpoint or as an npm stdio bridge that forwards calls to that same endpoint. Its own docs note that each connection also lists shared gateway meta-tools such as ask_pipeworx, so the tool count a client sees is larger than the five pack tools.

It suits developers and agent builders who need reference country facts inside an assistant or script without maintaining a dataset of their own. Anonymous use is capped daily, and a free Pipeworx account raises the limit.

## Features

- **Country search by name:** Finds countries by name and returns capital, population, area, languages, currencies, flag and land borders.
- **Lookup by ISO code:** Returns full country details for a two- or three-letter ISO code such as US or FRA.
- **Regional listings:** Lists every country within a region such as Africa, Europe or Asia.
- **Language and currency filters:** Finds countries where a language is spoken or where a given currency is used.
- **Hosted or stdio connection:** Connects over streamable HTTP or runs as an npm stdio bridge that forwards to the same gateway.

## Good for

- Letting an assistant answer questions about borders, capitals or populations
- Finding all countries that use a particular currency or language for a dataset
- Resolving ISO country codes to full names and regional groupings in an app
- Adding reference country data to an agent without building a separate data source

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http countries https://gateway.pipeworx.io/countries/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/countries/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "countries": {
      "url": "https://gateway.pipeworx.io/countries/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "countries": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/countries/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "countries": {
      "serverUrl": "https://gateway.pipeworx.io/countries/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "countries": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/countries/mcp"
    }
  }
}
```

## Tools

- `search_countries`: Search for countries by name, returning official name, capital, region, population, area, languages, currencies, flag and land borders.
- `get_country_by_code`: Get country details by ISO code such as US or FRA.
- `countries_by_region`: List all countries in a region such as Africa, Europe or Asia.
- `countries_by_language`: Find countries where a language is spoken.
- `countries_by_currency`: Find countries using a currency such as EUR or USD.

## FAQ

### Is an API key required?

No. The README says calls are anonymous and capped daily without a key; a free Pipeworx account raises the cap to 200 calls a day.

### Which tools does the server expose?

Five pack tools: search_countries, get_country_by_code, countries_by_region, countries_by_language and countries_by_currency. The endpoint also lists shared gateway meta-tools.

### Can I run it locally?

The npm package is a local stdio bridge, but the README says it still needs network access to the Pipeworx gateway and has no offline mode.

### Is Countries free?

Countries has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Countries to Claude Code?

Run this command in your terminal: claude mcp add --transport http countries https://gateway.pipeworx.io/countries/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Trends](https://ai-powered.com/mcp/google-trends-3): Google Trends is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/countries
