Countries

live Geography

World country data — search by name, ISO code, region, language, or currency via REST Countries API

5 tools

0ms auth

free tier 50 calls/day

Tools

search_countries required: query

Search for countries by name. Returns common name, official name, capital, region, subregion, population, area, languages, currencies, and flag emoji.

Parameters

Name Type Description

query req string Country name to search for (partial matches are supported)

▶ Try it

Response

get_country_by_code required: code

Get full country information by ISO 3166-1 alpha-2 (e.g. "US") or alpha-3 (e.g. "USA") code.

Parameters

Name Type Description

code req string ISO 3166-1 alpha-2 or alpha-3 country code

▶ Try it

Response

countries_by_region required: region

List all countries in a geographic region with name, capital, population, and flag.

Parameters

Name Type Description

region req string Region name — one of: africa, americas, asia, europe, oceania

▶ Try it

Response

countries_by_language required: language

Find all countries where a given language is spoken. Returns name, capital, region, and population.

Parameters

Name Type Description

language req string Language name (e.g. "spanish", "french", "arabic")

▶ Try it

Response

countries_by_currency required: currency

Find all countries that use a given currency. Returns name, capital, and region.

Parameters

Name Type Description

currency req string Currency code or name (e.g. "eur", "usd", "dollar")

▶ Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

curl -X POST https://gateway.pipeworx.io/countries/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

curl -X POST https://gateway.pipeworx.io/countries/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_countries","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_countries", {"query":"example"});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("world country data — search by name, iso code, region, language, or currency via rest countries api");

Related packs

Other Pipeworx packs in the same categories (Geography):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-countries": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/countries/mcp"
      ]
    }
  }
}