
Countries
MCP server giving AI clients country lookups by name, code, region, language or currency
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Countries
Countries is a freemium MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http countries https://gateway.pipeworx.io/countries/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/countries/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"countries": {
"url": "https://gateway.pipeworx.io/countries/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"countries": {
"type": "http",
"url": "https://gateway.pipeworx.io/countries/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"countries": {
"serverUrl": "https://gateway.pipeworx.io/countries/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"countries": {
"type": "http",
"url": "https://gateway.pipeworx.io/countries/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium, from $49 a month
Free anonymous and free account tiers; paid credit-based usage and subscriptions above that.
Prices change. Check pipeworx.io before you buy.
Countries 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.