How to Use the ExchangeRate- MCP in Pydantic AI

Q: How do I install the ExchangeRate- support for Pydantic AI?

You need the pydantic-ai-slimmcp package. Initialize the MCPToolset with your server URL and pass it to your agent instance.

Strictly type-safe currency data for Pydantic AI agents using the ExchangeRate- MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ExchangeRate- MCP to Pydantic AI

Create your Vinkius account to connect ExchangeRate- to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ExchangeRate- with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe currency lookups in Pydantic AI

Every response from `get_latest_rates` is validated against Pydantic models at runtime. If the API returns garbage, your agent catches it before it causes a downstream error. This prevents silent corruption in your agent's state. You get a reliable way to handle currency data that matches your project's strict type requirements.

Verify historical data with Pydantic AI

Request historical rates using `get_historical_data` and ensure the output matches your schema. It's the standard way to keep your agent's historical analysis consistent. Because the server enforces schema validation, you won't deal with missing fields or unexpected data types. It allows your agent to process complex time-series data with full confidence.

Control tool access in Pydantic AI

The `MCPToolset` allows you to manage the server connection while keeping your agent's tool set clean. It's built to support SSE and HTTP transports for maximum flexibility. Your agent remains model-agnostic, letting you swap out your LLM without changing how you handle currency data. It's a clean, modular approach to integrating external tools.

Setup guide

Set up ExchangeRate- 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": {
        "exchangerate-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent ExchangeRate- 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 ExchangeRate-API. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ExchangeRate- now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ExchangeRate- MCP in Pydantic AI

You need the `pydantic-ai-slim[mcp]` package. Initialize the `MCPToolset` with your server URL and pass it to your agent instance.

The agent will fail with a validation error. This prevents your system from acting on hallucinated or malformed data, which is critical for financial workflows.

Since it uses a dedicated HTTP or SSE transport, the connection is consistent. Vinkius manages the endpoint, so you don't have to worry about server-side downtime.

All connections are handled via a zero-trust architecture. Your authentication token is the only requirement, and all transit is encrypted by default.

No. The server only reads public currency rate data and your specific API quota. It has no access to your local databases or private user information.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript