How to Use the Braintree MCP in Pydantic AI

Q: How do I connect the Braintree MCP Server to a Pydantic AI agent?

Install the package with pip install "pydantic-ai-slimmcp". Initialize your connection using MCPToolset pointing to your Vinkius HTTP endpoint, and pass it to your Agent via the toolsets parameter.

Q: Is the deprecated MCPServerHTTP class still used?

No, you should use the unified MCPToolset class instead. The older HTTP classes are deprecated in favor of this cleaner, more resilient MCP connection method.

Build type-safe Braintree payment workflows verified at runtime by 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 Braintree MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Braintree transactions using Pydantic AI

`get_transaction` pulls raw transaction details from Braintree and validates the response against strict Python types defined in your Pydantic AI model. The Pydantic AI framework ensures that every field, from the transaction ID to the currency code, matches your expected schema before your code processes it. If Braintree's API returns an unexpected format or a missing field, this MCP Server setup raises a Pydantic AI validation error instantly. This prevents corrupt payment data from polluting your database or causing silent failures in your application.

Charge payment methods with runtime type safety

`charge_payment_method` executes charges using validated input models to prevent formatting errors. Your Pydantic AI agent ensures the Braintree token, amount, and customer ID conform to strict schemas before initiating the API call. If a user inputs bad payment data, the Pydantic AI validation layer catches it before sending the payload to Braintree. This saves you money on unnecessary API calls and transaction fees caused by malformed requests.

Process structured refunds and voids

`refund_transaction` issues partial or full refunds with strict validation on the refund amount. Your Pydantic AI agent verifies that the refund amount does not exceed the original Braintree transaction value before executing the tool. For un-settled charges, the Pydantic AI agent runs `void_transaction` to cancel the authorization. Every Braintree response is parsed into structured Pydantic models, giving you clean, typed objects to work with in your backend code.

Setup guide

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

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

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

Install the package with `pip install "pydantic-ai-slim[mcp]"`. Initialize your connection using `MCPToolset` pointing to your Vinkius HTTP endpoint, and pass it to your `Agent` via the `toolsets` parameter.

The framework raises a validation error immediately. Instead of proceeding with corrupted or hallucinated fields, Pydantic AI halts execution, allowing your application to handle the error safely.

Yes, you can define your own validation models for the output of `search_customers`. Pydantic AI will parse the raw JSON response from the server into your custom model, ensuring strict type compliance.

No, you should use the unified `MCPToolset` class instead. The older HTTP classes are deprecated in favor of this cleaner, more resilient MCP connection method.

Your sensitive payment keys and customer tokens are processed entirely in memory within a secure, ephemeral V8 isolate on Vinkius. This MCP gateway processes sensitive payment keys locally, and no sensitive payment details are ever written to disk or used for model training.

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