How to Use the AiMasher MCP in Pydantic AI

Q: How do I check my AiMasher connection?

Run checkaimasherstatus as a diagnostic tool in your agent loop. It pings the API and confirms your credentials are valid before you start generating assets.

Build typed content pipelines in Pydantic AI by connecting the AiMasher MCP Server to your Python agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AiMasher MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Strict content generation for Pydantic AI

Trigger `generate_content` directly within your agent logic. Since you use Pydantic AI, the tool response gets validated against your models immediately. Catch bad data before it hits your database. If the API returns garbage, your agent crashes fast instead of passing corrupted strings downstream.

Manage campaigns inside your Pydantic AI agent

Call `create_campaign` or `get_campaign` to pull active project details into your Python environment. You handle the campaign lifecycle without leaving your code editor. Keep your logic clean by mapping these tool outputs to your local types. It keeps your agent state predictable and your data structures sound.

Query AiMasher templates with your MCP Server

Use `list_templates` and `get_template` to fetch your pre-defined assets. This lets your agent pull the right format based on the current user intent. Your Pydantic AI models receive the exact schema they expect. No guessing, no runtime type errors, just data flowing exactly how you defined it.

Setup guide

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

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

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

Install the MCP toolset package and point it at your Vinkius endpoint. You then pass the toolset into your agent constructor to make the tools available for execution.

Yes, it's the main benefit. Because Pydantic AI validates every response against your schemas, any deviation in the AiMasher output triggers a hard error.

Absolutely. You define your Pydantic models, and the MCP server maps the API data directly into those classes, ensuring your agent logic stays type-safe.

Run `check_aimasher_status` as a diagnostic tool in your agent loop. It pings the API and confirms your credentials are valid before you start generating assets.

Your Pydantic AI agent only retrieves the campaign records and generated outputs you explicitly request. The server operates in a isolated sandbox where your API keys stay encrypted and never leave the environment.

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