How to Use the REST Countries MCP in Pydantic AI

Ensure type-safe global data retrieval for Pydantic AI agents with the REST Countries MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect REST Countries MCP to Pydantic AI

Create your Vinkius account to connect REST Countries to Pydantic AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup REST Countries with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Type-safe country lookups for Pydantic AI

Pydantic AI demands strict schemas. This server returns data that validates against your models, preventing runtime errors. Use `get_country_by_code` to fetch details that match your predefined types. If the API structure shifts, your agent catches the mismatch immediately.

Fetch all countries with validation

Need a master list? Call `get_all_countries` to grab the global dataset. Your agent validates every record against your Pydantic model. It ensures no malformed data enters your logic.

Region-based queries for Pydantic AI

Narrow your search to specific geographic zones. `get_countries_by_region` returns data that your agent can handle safely. It enforces structure on every response. You never have to worry about silent data corruption.

Setup guide

Set up REST Countries MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "rest-countries-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to REST Countries tools.",
)

result = await agent.run("List recent REST Countries transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by REST Countries. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.