How to Use the Donorbox MCP in Pydantic AI

Q: How do I configure Donorbox with Pydantic AI?

Use the unified MCPToolset with your HTTP server URL and pass it to your agent's toolsets parameter. The MCP framework handles schema generation automatically.

Q: Does Pydantic AI support recurring plan adjustments?

Yes. The agent uses pauserecurringplan and resumerecurringplan to change plan states, validating the response schema on every call.

Q: Can the agent fetch account profiles?

Yes. The agent calls getaccountprofile to verify your organization's credentials and system status.

Execute type-safe Donorbox operations using Pydantic AI to guarantee zero silent failures in your giving pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Donorbox MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate donor creation at runtime

`create_new_donor` enforces strict validation rules on first names, last names, and email addresses before writing to your database. Pydantic AI intercepts incorrect formats and raises immediate validation errors instead of corrupting your CRM. This prevents your agent from passing malformed strings to the API. If the LLM tries to hallucinate a field, the runtime schema validation blocks the call instantly.

Type-safe MCP Server recurring plan management

`list_recurring_plans` and `cancel_recurring_plan` return structured Python models that match your exact schema expectations. Your agent processes subscription states without risking type mismatches or runtime crashes. Integrating this MCP Server ensures that billing changes are 100% predictable. You get compile-time confidence when handling financial transactions and donor agreements.

Query verified donation history safely

`list_donations` extracts transaction histories and filters them by email or campaign with strict type assertions. The agent parses the response into validated Pydantic models for immediate downstream processing. This setup eliminates the risk of silent data corruption in your reporting pipelines. Every integer, float, and date matches your system's strict requirements.

Setup guide

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

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

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

Use the unified `MCPToolset` with your HTTP server URL and pass it to your agent's toolsets parameter. The MCP framework handles schema generation automatically.

Yes. The agent uses `pause_recurring_plan` and `resume_recurring_plan` to change plan states, validating the response schema on every call.

It exposes structured tools that Pydantic AI validates at runtime. This saves you from writing manual serialization and error-handling code.

Yes. The agent calls `get_account_profile` to verify your organization's credentials and system status.

Recurring donation plans are parsed into temporary local structures that vanish immediately after validation. The runtime does not cache subscription IDs or billing cycles. All authentication tokens are managed externally in a zero-trust 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