How to Use the Classy.org MCP in Pydantic AI

Q: How do I initialize the Classy.org MCP Server in Pydantic AI?

Install pydantic-ai-slimmcp and use the MCPToolset constructor with your Vinkius HTTP endpoint. Pass this toolset directly to your Agent's toolsets parameter to expose the tools.

Run type-safe Classy.org integrations in Pydantic AI with strict runtime schema validation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Classy.org MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate donor transaction data at runtime

The `list_donation_transactions` tool fetches recent financial records and validates them instantly against your Pydantic AI models. This prevents corrupted API payloads from breaking your downstream financial tracking or reporting pipelines. If the Classy API returns an unexpected null value or an altered date format, the framework raises a validation error immediately. You get clean, typed data structures instead of silent failures or weird agent behaviors.

Audit campaign metrics using Pydantic AI

The `get_campaign_details` tool retrieves structured metrics for your active fundraising efforts. By wrapping this MCP Server in a Pydantic AI toolset, you ensure every campaign goal, raised amount, and status field matches your expected Python types. This strict type checking extends to team-based data via `list_fundraising_teams`. Your agent can confidently calculate progress percentages knowing the underlying floats and integers are verified.

Track supporter profiles with absolute correctness

The `list_classy_members` tool pulls supporter profiles into your agent's context under strict schema enforcement. You can safely link these profiles to individual pages using `list_individual_fundraising_pages` without worrying about missing identifier fields. Your agent can inspect the live interaction history through `get_activity_feed` to flag high-value actions. Because every field is validated, your code won't crash when parsing complex, nested JSON payloads.

Setup guide

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

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

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

Install pydantic-ai-slim[mcp] and use the MCPToolset constructor with your Vinkius HTTP endpoint. Pass this toolset directly to your Agent's toolsets parameter to expose the tools.

It eliminates silent data corruption. When your agent calls list_classy_organizations, the framework validates the response against strict schemas, ensuring your agent never acts on malformed organization settings.

No, the server runs externally on Vinkius. Your local Python application simply connects to the hosted endpoint via the streamable HTTP transport, keeping your deployment footprint minimal.

Yes, Pydantic AI is model-agnostic. You can run these Classy tools with Anthropic, Gemini, or local models while maintaining the exact same runtime type validation.

Data is transmitted over encrypted HTTPS channels using the MCP standard directly to the Vinkius V8 isolate sandbox. Your donor transaction IDs and financial amounts are processed entirely in memory, and Vinkius deletes the sandbox state immediately after the tool execution finishes.

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