How to Use the Freshcaller MCP in Pydantic AI

Q: How does Pydantic AI handle Freshcaller API responses?

It validates them. Every piece of data from tools like getcalldetails or listagents is parsed and checked against a Pydantic model. If the response doesn't match the schema, your code gets an error, not bad data.

Q: Can I build a Pydantic AI agent to monitor Freshcaller agent status?

Yes, that's a primary use case. Your agent can use the listagents and getagentdetails tools. Pydantic AI ensures the agent status, team ID, and other fields are always the correct type, so your monitoring logic is built on solid ground.

Q: Does this toolset let a Pydantic AI agent get Freshcaller call recordings?

It does. The agent can use getcallrecording to get a link to the audio file. Pydantic AI ensures the response contains a valid URL string, preventing errors if the API were to return something unexpected.

Q: How do I connect this MCP Server to my Pydantic AI agent?

It's simple. You'll use the MCPToolset class from the Pydantic AI library, passing in your Vinkius server URL. Then you add that toolset to your agent's toolsets list. This single MCPToolset object is the modern way to integrate any MCP Server.

Add type-safe Freshcaller tools to Pydantic AI. Build call center agents that don't fail silently.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshcaller MCP to Pydantic AI

Create your Vinkius account to connect Freshcaller 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 Freshcaller with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Process Call Data. Reliably.

This toolset lets your agent pull call information with `list_calls` and `get_call_details`. The key difference is Pydantic AI's runtime validation. Every response from the Freshcaller API is checked against a strict schema before your agent code sees it. If the API ever returns an unexpected field or a malformed response, your agent will raise a `ValidationError` immediately. No more silent data corruption or debugging weird behavior. You know the data is correct because Pydantic AI's MCP integration guarantees it.

Manage Agents with Confidence

When you ask your agent to `list_agents` or `get_agent_details`, you get exactly what you expect. Pydantic AI validates the agent and team structures returned by the Freshcaller server on every single call. This means your agent's logic for checking availability or routing work won't break because of a subtle API change. It builds a foundation of trust. If the data passes validation, it's safe to use.

Provision Numbers with Guardrails

Use your Pydantic AI agent to manage your phone number inventory without guesswork. The `list_my_numbers` tool gives you a validated list of what you currently own. You can trust the output to match the expected data model. When you need to add more numbers, `list_buyable_numbers` returns a structured list of options. The rigid type-checking ensures your provisioning scripts won't fail because of an unexpected data format from the API.

Setup guide

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

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

result = await agent.run("List recent Freshcaller 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 Freshcaller. 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 Freshcaller 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 Freshcaller MCP in Pydantic AI

It validates them. Every piece of data from tools like `get_call_details` or `list_agents` is parsed and checked against a Pydantic model. If the response doesn't match the schema, your code gets an error, not bad data.

Yes, that's a primary use case. Your agent can use the `list_agents` and `get_agent_details` tools. Pydantic AI ensures the agent status, team ID, and other fields are always the correct type, so your monitoring logic is built on solid ground.

It does. The agent can use `get_call_recording` to get a link to the audio file. Pydantic AI ensures the response contains a valid URL string, preventing errors if the API were to return something unexpected.

It's simple. You'll use the `MCPToolset` class from the Pydantic AI library, passing in your Vinkius server URL. Then you add that toolset to your agent's `toolsets` list. This single MCPToolset object is the modern way to integrate any MCP Server.

Yes. Security is handled in layers. Your data, like call details and export job statuses, is transmitted over HTTPS. The Vinkius server that handles the request is ephemeral and doesn't store anything. On top of that, Pydantic AI adds a layer of data integrity by validating the structure of every response before it even reaches your application logic.

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