How to Use the Dixa MCP in Pydantic AI

Q: How do I configure the Dixa MCP Server with Pydantic AI?

Install pydantic-ai-slimmcp and register your Vinkius HTTP endpoint using MCPToolset. Pass this toolset to your Agent constructor to enable type-safe MCP operations.

Q: Can I run parallel Dixa audits using Pydantic AI?

Yes. Your agent calls quickagentpresenceaudit to get a structured summary of active agents. Pydantic AI validates the status list, letting you safely map workloads to available staff.

Q: How do I retrieve open support tickets safely?

Use listopensupporttickets to fetch unassigned conversations. The framework validates the ticket structures at runtime, ensuring your agent only processes valid support records.

Build type-safe Dixa support workflows validated at runtime with Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dixa MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Dixa agent profiles using Pydantic AI

`get_agent_profile` fetches detailed agent performance metrics and parses them directly into typed Python models. If the API response structure changes, Pydantic AI raises a validation error immediately. By using this MCP Server, your agent makes decisions based on clean, guaranteed schemas instead of raw, unpredictable JSON. This strict validation prevents corrupt agent data from breaking your downstream routing logic.

Parse support queues with strict type safety

`list_service_queues` retrieves your active support channels with complete structural validation. Your code knows exactly what fields to expect before the agent even processes the payload. If you need to audit account limits, `get_service_account_metadata` returns validated quota usage. This ensures your code never attempts operations that exceed your current Dixa plan limits.

Search and extract conversations safely

`search_conversations_by_subject` allows your agent to find historical tickets using precise keyword matching. The returned list of threads is validated against runtime schemas to ensure data integrity. Your agent can then safely call `get_conversation_details` to read the messages. Because every field is typed, you can write clean Python code to manipulate the text without worrying about missing attributes.

Setup guide

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

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

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

Install `pydantic-ai-slim[mcp]` and register your Vinkius HTTP endpoint using `MCPToolset`. Pass this toolset to your `Agent` constructor to enable type-safe MCP operations.

The framework raises a validation error immediately rather than letting your agent make decisions based on malformed data. This keeps your support queues and agent assignments completely reliable.

Yes. Your agent calls `quick_agent_presence_audit` to get a structured summary of active agents. Pydantic AI validates the status list, letting you safely map workloads to available staff.

Use `list_open_support_tickets` to fetch unassigned conversations. The framework validates the ticket structures at runtime, ensuring your agent only processes valid support records.

Your API keys and support tickets are processed in an ephemeral V8 sandbox on Vinkius. Pydantic AI validates this data locally in your environment, meaning your sensitive customer conversations never touch persistent external storage.

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