How to Use the Salsa Engage MCP in Pydantic AI

Q: Can I verify my Salsa Engage credentials using Pydantic AI?

The getaccountinfo tool retrieves your authenticated account details safely from the MCP Server. Pydantic AI parses this response into a typed schema so your agent can verify access rights securely.

Q: How do I track offline donations safely?

You run listofflinedonations to get a structured list of physical contributions. The framework validates every transaction amount and date against your strict data models.

Build type-safe fundraising agents using Pydantic AI to guarantee clean Salsa Engage data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Salsa Engage MCP to Pydantic AI

Create your Vinkius account to connect Salsa Engage to Pydantic AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Salsa Engage with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Salsa Engage metrics at runtime

The `get_engagement_metrics` tool delivers structured campaign performance data directly to your type-safe agent. This tool ensures that every click rate and open rate matches your exact Python schemas. If the API returns unexpected null values or modified fields, Pydantic AI raises a validation error immediately. You catch database inconsistencies before they corrupt your production reports.

Type-safe group management via MCP Server

The `list_supporter_groups` tool returns your active donor lists with strict type safety. This tool lets your agent inspect group names, IDs, and sizes without risk of parsing failures. Your agent uses these typed models to safely decide which groups need immediate attention. Integrating this MCP Server ensures your donor segments are formatted correctly before any automated outreach begins.

Update supporter profiles with strict schema checks

The `upsert_supporter_profile` tool modifies donor contact details using validated Python inputs. This tool prevents malformed email addresses or incomplete phone numbers from entering your database. Because your agent operates under strict validation guardrails, bad data gets rejected at the boundary. Your team avoids the headache of cleaning up broken database records later.

Setup guide

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

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

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

Instantiate the unified MCP toolset class with your Vinkius server URL. Pass that instance into the toolsets parameter of your agent to register all twelve endpoints.

Your agent will raise a runtime validation error instantly instead of failing silently. This loud failure prevents your application from processing corrupted donor records or incorrect metrics.

The `get_account_info` tool retrieves your authenticated account details safely from the MCP Server. Pydantic AI parses this response into a typed schema so your agent can verify access rights securely.

You run `list_offline_donations` to get a structured list of physical contributions. The framework validates every transaction amount and date against your strict data models.

Your API tokens are managed entirely by Vinkius on a secure, zero-trust infrastructure. Supporter profiles and engagement metrics pass through encrypted channels and are never stored on Vinkius servers.

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