How to Use the Emma MCP in Pydantic AI

Q: How do I initialize the Emma MCP Server inside Pydantic AI?

Install the pydantic-ai-slimmcp package. Create an MCPToolset pointing to your HTTP endpoint. Pass that directly to your agent's toolsets array to expose the endpoints.

Q: How is subscriber PII protected during validation?

Processing getmember payloads involves handling raw email addresses and names. The Vinkius infrastructure routes this through a stateless, zero-trust container. Authentication requires only one endpoint token, and no customer data touches persistent disk storage.

Bring type-safe Emma email marketing operations to Pydantic AI via this 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 Emma MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe campaign tracking

The Emma MCP Server exposes your email performance data via `get_mailing_stats` and `list_mailings` with strict runtime validation. When your agent calls these endpoints, Pydantic AI forces the response into your predefined schemas. If the API returns a string instead of a float for an open rate, the agent fails loudly. You never deal with silent data corruption. Checking `list_automations` guarantees you get exactly the expected array structure back. The framework ensures your application logic only processes clean, verified metrics.

Validate subscriber data

Fetching users requires precision, so the `list_members` and `get_member` tools pull contact records directly into your agent's memory. Before the agent acts on this data, Pydantic AI confirms every required field exists. Mapping custom schemas is straightforward. By running `list_fields`, your agent discovers the exact shape of your subscriber attributes. It dynamically adjusts its validation models to match your specific account setup.

Manage groups via MCP Server

Modifying your list structure uses `create_group` and `list_groups`. The agent reads the current state, validates the proposed changes, and executes the creation request. You get predictable, repeatable segmentation. Cleanup tasks are equally rigid. The `delete_group` tool removes the organizational container while leaving the members safe. You can also monitor your event streams by hitting `list_webhooks` to ensure your external integrations are working.

Setup guide

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

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

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

Install the `pydantic-ai-slim[mcp]` package. Create an `MCPToolset` pointing to your HTTP endpoint. Pass that directly to your agent's `toolsets` array to expose the endpoints.

Yes. That is the whole point of this framework. If the endpoint returns an unexpected null value for a subscriber, the validation layer throws an error before your agent can hallucinate a fix.

It is safe for your contacts. The endpoint deletes the group entity itself, not the users assigned to it. They simply revert to being unassigned members on your main list.

You certainly can. Because the framework is model-agnostic, you can route the MCP tool calls through OpenAI, Anthropic, or a local model running on your own hardware.

Processing `get_member` payloads involves handling raw email addresses and names. The Vinkius infrastructure routes this through a stateless, zero-trust container. Authentication requires only one endpoint token, and no customer data touches persistent disk 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