How to Use the Brushfire MCP in Pydantic AI

Q: How do I initialize the Brushfire MCP Server in Pydantic AI?

Install pydantic-ai-slimmcp and use the unified MCPToolset pointing to your Vinkius HTTP endpoint. Pass this toolset directly to your Agent constructor to expose all ten tools like getaccountinfo.

Q: Can I use Pydantic AI to validate Brushfire attendee check-ins?

Yes. When your agent calls checkinattendee, the return value is parsed against strict schemas, ensuring you get a clean confirmation status back every time.

Build type-safe event agents with Pydantic AI that validate Brushfire attendee data and registrations at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brushfire MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe attendee updates with Pydantic AI

The `update_attendee` tool executes with strict schema validation to prevent malformed contact details from corrupting your registration database. If your agent tries to pass an invalid email format, Pydantic AI rejects it instantly before the API call is ever made. This strictness ensures that tools like `get_attendee` always return structured, predictable data models. You get clean Python objects instead of loose dictionaries, making your production code highly reliable.

Validated ticket sales tracking via this MCP Server

The `list_orders` tool tracks your event revenue by matching responses against strict validation schemas. This MCP Server ensures that every order ID, price, and timestamp matches your expected types exactly. If the API payload structure changes, your agent fails loudly rather than silently processing corrupted financial data. This makes monitoring your sales via `get_order` safe enough for automated accounting pipelines.

Runtime schema enforcement for event logistics

The `list_events` and `list_ticket_types` tools pull your schedules and ticket configurations with complete type safety through this MCP Server. Because Pydantic AI enforces schemas at runtime, your agent cannot hallucinate event IDs or ticket names. When checking in guests via `check_in_attendee`, the framework validates the attendee status immediately. This guarantees that your gate control logs remain 100% accurate throughout the event.

Setup guide

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

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

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

Install `pydantic-ai-slim[mcp]` and use the unified `MCPToolset` pointing to your Vinkius HTTP endpoint. Pass this toolset directly to your Agent constructor to expose all ten tools like `get_account_info`.

The framework will raise a validation error instantly. Instead of your agent hallucinating fields or continuing with bad data, the pipeline stops safely so you can debug the payload.

Yes. When your agent calls `check_in_attendee`, the return value is parsed against strict schemas, ensuring you get a clean confirmation status back every time.

Yes. The Vinkius-hosted MCP toolset supports streamable HTTP, which integrates cleanly with Pydantic AI's modern client architecture.

Your registration details and attendee lists are processed inside an ephemeral V8 sandbox. Vinkius never stores your data, and the type-validation layer ensures no raw, unverified payloads leak outside your local runtime MCP endpoints.

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