Is an API Key required for REST Countries?

No. REST Countries is a free and open service. This server works out of the box without any static credentials required.

Can the agent search for countries by currency?

Yes. Use the `get_countries_by_currency` tool providing the currency code (e.g., 'EUR'). Your agent will return all countries using that specific currency instantly.

Is population data included?

Yes. Every country record retrieved by your agent includes the most recent official population count available in the database.

REST Countries MCP Server for OpenAI Agents SDK 6 tools — connect in under 2 minutes

Name: REST Countries
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 6 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect REST Countries through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="REST Countries Assistant",
            instructions=(
                "You help users interact with REST Countries. "
                "You have access to 6 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from REST Countries"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About REST Countries MCP Server

Empower your AI agent to orchestrate your entire global research workflow with REST Countries, the authoritative source for geographic and geopolitical data. By connecting REST Countries to your agent, you transform complex demographic searches into a natural conversation. Your agent can instantly search for countries, audit currency distributions, and retrieve language metadata without you ever touching a technical database. Whether you are conducting market expansion research or building global applications, your agent acts as a real-time geographic consultant, ensuring your data is always comprehensive and well-categorized.

The OpenAI Agents SDK auto-discovers all 6 tools from REST Countries through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries REST Countries, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Country Auditing — Search for any country by its common or official name and retrieve detailed metadata, including capitals and population counts.
Regional Oversight — Browse countries by region or subregion to maintain a clear view of global geographic distributions.
Economic Intelligence — Query countries by currency to understand the reach of specific financial systems instantly.
Linguistic Discovery — Retrieve lists of countries that speak specific languages to assist in localization planning.
Spatial Discovery — Retrieve official flags and geographic coordinates for any country ID to maintain visual and spatial context.

The REST Countries MCP Server exposes 6 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect REST Countries to OpenAI Agents SDK via MCP

Follow these steps to integrate the REST Countries MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 6 tools from REST Countries

Why Use OpenAI Agents SDK with the REST Countries MCP Server

OpenAI Agents SDK provides unique advantages when paired with REST Countries through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

REST Countries + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the REST Countries MCP Server delivers measurable value.

Automated workflows: build agents that query REST Countries, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries REST Countries, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through REST Countries tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query REST Countries to resolve tickets, look up records, and update statuses without human intervention

REST Countries MCP Tools for OpenAI Agents SDK (6)

These 6 tools become available when you connect REST Countries to OpenAI Agents SDK via MCP:

get_all_countries

Get a list of all countries in the world

get_countries_by_currency

List countries that use a specific currency

get_countries_by_language

List countries that speak a specific language

get_countries_by_region

List countries in a specific region or subregion

get_country_by_code

Search for a country by its ISO alpha-2 or alpha-3 code

get_country_by_name

Search for a country by its common or official name

Example Prompts for REST Countries in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with REST Countries immediately.

"Search for the country 'Brazil' using REST Countries."

"List all countries in the region 'Europe'."

"Which countries speak 'Spanish'?"

Troubleshooting REST Countries MCP Server with OpenAI Agents SDK

Common issues when connecting REST Countries to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

REST Countries + OpenAI Agents SDK FAQ

Common questions about integrating REST Countries MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.