How to Use the Blackbaud MCP in OpenAI Agents SDK

Q: Can I use the OpenAI Agents SDK to batch update Blackbaud constituents?

Yes, you can script iterative calls to updateconstituent within your agent loop. Just be mindful of the API rate limits.

Connect Blackbaud to your OpenAI Agents SDK pipeline for immediate, safe record updates.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Blackbaud MCP to OpenAI Agents SDK

Create your Vinkius account to connect Blackbaud to OpenAI Agents SDK 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 Blackbaud with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate constituent records

Your agent manages donor profiles without manual entry. Use `create_constituent` and `update_constituent` to push changes directly into your database. These tools plug into your existing agent logic. The OpenAI Agents SDK handles the heavy lifting, ensuring every record change is tracked and validated.

Handle gifts in your agent workflow

Stop jumping between tabs to log donations. Call `create_gift` to register contributions as they happen, then use `get_gift` to confirm the transaction details. This MCP Server keeps your data current. Your agent processes these tasks in the background, freeing you to focus on fundraising strategy.

Access school data directly

Your agent pulls academic context to inform donor interactions. Use `list_academic_sections` and `list_school_users` to see exactly who is in which class. This visibility helps your team tailor outreach. It's built for production-grade agent systems that require precise, verified data.

Setup guide

Set up Blackbaud MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Blackbaud tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Blackbaud tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Blackbaud tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Blackbaud Agent",
            instructions="You have access to Blackbaud tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Blackbaud. 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 Blackbaud 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 Blackbaud MCP in OpenAI Agents SDK

Vinkius manages the secure connection via a single endpoint token. Your agent only accesses the specific tools you authorize, keeping your data locked down.

Yes, you can script iterative calls to `update_constituent` within your agent loop. Just be mindful of the API rate limits.

Vinkius handles the underlying auth handshake. You just provide the token and your agent starts calling the available tools immediately.

The MCP protocol provides clear error logs. You can trace these in the OpenAI dashboard to debug the specific tool failure.

The server operates in a zero-trust sandbox. Only the specific constituent records your agent requests are ever accessed.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.