How to Use the Blackbaud MCP in Windsurf

Q: How does the Blackbaud MCP Server prevent duplicate profiles in Windsurf?

It uses getconstituent to search for existing records before running any write operations. Cascade automates this check, ensuring your database remains clean without manual intervention.

Q: Can I automate donation logging using Blackbaud and Windsurf?

Yes, Windsurf uses creategift to write transactions to your database. Cascade chains this with profile checks to ensure every contribution maps to the correct record.

Q: How do academic tools work in this Blackbaud integration for Windsurf?

Windsurf calls listacademicsections and listschoolusers to read classroom structures and student lists. Cascade uses these tools to sync school rosters directly from your sidebar.

Manage donors and academic records directly from Windsurf using Cascade's autonomous multi-step execution.

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 Windsurf

Create your Vinkius account to connect Blackbaud to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fast Donor Onboarding with Windsurf Cascade

The `create_constituent` tool lets Windsurf handle donor creation via MCP when a new prospect contacts your team. Cascade reads the incoming email context, builds the profile, and updates existing records without manual data entry. It then chains this action with `get_constituent` to double-check for duplicate profiles before executing the write. This prevents database clutter during busy fundraising seasons.

Automated Gift Recording inside Windsurf

The `create_gift` tool registers financial contributions directly from your development workspace. Cascade takes raw transaction logs, maps them to the correct donor ID, and logs the transaction. If the donor doesn't exist, Windsurf automatically triggers `create_constituent` first, then logs the transaction using `create_gift`. This autonomous chaining saves hours of manual CSV processing.

Sync School Rosters using Windsurf MCP Server

The `list_school_users` tool pulls student and teacher directories into your workspace. Cascade uses this list to map academic relationships and update educational records. By combining this with `list_academic_sections`, Windsurf builds a complete picture of classroom assignments. Your agent handles student enrollment updates without you opening a single browser tab.

Setup guide

Set up Blackbaud MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Blackbaud MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Blackbaud payment history." If connected, Cascade will call the Blackbaud tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "blackbaud-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

It uses `get_constituent` to search for existing records before running any write operations. Cascade automates this check, ensuring your database remains clean without manual intervention.

Yes, Windsurf uses `create_gift` to write transactions to your database. Cascade chains this with profile checks to ensure every contribution maps to the correct record.

Windsurf calls `list_academic_sections` and `list_school_users` to read classroom structures and student lists. Cascade uses these tools to sync school rosters directly from your sidebar.

No, Vinkius handles the underlying SKY API authentication. You provide a single endpoint token to Windsurf, and the platform manages the secure connection.

This MCP server runs inside a V8 isolate sandbox on Vinkius, which isolates your donor records and school user data from other network traffic. Every request is ephemeral, meaning your API payloads are never stored on disk.

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