How to Use the Brilliant Made MCP in Pydantic AI

Q: How do I initialize the Brilliant Made MCP toolset in Pydantic AI?

Install pydantic-ai-slimmcp via pip and import MCPToolset. Pass your Vinkius HTTP URL to the toolset, then add it to your agent constructor.

Build type-safe swag workflows with Pydantic AI, validating every Brilliant Made MCP Server tool call 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 Brilliant Made MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Swag Ordering with Pydantic AI

Your agent executes `create_order` and `cancel_order` with strict runtime validation to prevent malformed shipping payloads. Every argument passed to the API must match your Pydantic schemas, stopping database corruption before it happens. If the agent attempts to write an invalid zip code or an incorrect country format, the execution fails loudly. This guarantees your physical shipments are backed by clean, validated data.

Strict Inventory and Variant Validation

The agent checks stock by running `get_inventory_status` and `get_product_variant` to ensure data integrity. Pydantic AI parses the raw JSON response directly into typed Python objects, eliminating silent failures. You don't have to worry about the API returning unexpected null values or modified types. If the warehouse updates its schema, your agent catches the mismatch immediately during runtime.

Validated Gift Card Management

Your code calls `create_gift_card` and `list_gift_cards` to manage store credit without worrying about float precision errors. The framework validates that reward amounts match your exact integer or decimal requirements. By using the `MCPToolset` with your Vinkius HTTP endpoint, you connect your type-safe agent directly to the storefront via our MCP Server. This keeps your financial rewards predictable and fully audited.

Setup guide

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

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

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

Install `pydantic-ai-slim[mcp]` via pip and import `MCPToolset`. Pass your Vinkius HTTP URL to the toolset, then add it to your agent constructor.

The framework raises a validation error immediately. This prevents your agent from making decisions based on malformed inventory or order details.

Yes. The framework handles async MCP tool execution, allowing the agent to fetch lists using `list_products` and `list_orders` simultaneously.

This setup supports both Streamable HTTP and SSE transports. You just need to run your server externally and point the toolset to the correct endpoint.

Gift card codes and order data are validated locally in memory before transmission. The underlying network layer uses encrypted TLS tunnels, and the Vinkius sandbox never persists your API payloads.

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