How to Use the Donorbox MCP in Windsurf

Q: How does Windsurf handle Donorbox API failures?

Windsurf runs checkapihealth to check your Donorbox connection status before Cascade executes complex multi-step updates. If the Donorbox API goes down, the Windsurf agent stops the sequence to prevent partial data updates.

Q: Can Windsurf update recurring Donorbox subscriptions?

Yes, Windsurf uses cancelrecurringplan or pauserecurringplan to alter Donorbox giving schedules instantly. You just tell the Windsurf Cascade agent what the donor requested, and it finds the Donorbox plan and executes the change.

Q: Can I search for Donorbox transactions inside Windsurf?

Yes, Windsurf calls listdonations to filter Donorbox records by donor email or campaign name. This lets you pull precise Donorbox transaction records without leaving your active Windsurf workspace.

Q: How do I configure this Donorbox MCP Server in Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file to register the tool. Once saved, the Windsurf client connects to the Donorbox server instantly.

Pause recurring donor plans and update campaign details without leaving your Windsurf workspace.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf Cascade Chains Donorbox Updates

Windsurf's Cascade agent executes `pause_recurring_plan` to stop a Donorbox monthly gift immediately when a supporter requests a break. This Windsurf automation reads the incoming support ticket context, identifies the correct Donorbox account, and halts the plan without making you click through a web dashboard. If the Donorbox contributor changes their mind, Windsurf uses `resume_recurring_plan` to reactivate their giving schedule. This keeps your Windsurf workflow moving fast and prevents accidental Donorbox churn by handling requests the second they hit your inbox.

Cascade Multi-Step Donorbox Management

Windsurf runs `create_new_donor` to register a new Donorbox supporter with just a name and email. Cascade chains this tool with `update_donor_info` to append phone numbers to the Donorbox record in a single command sequence. When a Donorbox profile changes, this Windsurf MCP Server runs `update_donor_info` to modify the contact record. You get clean Donorbox database records inside Windsurf without manual copy-pasting.

Monitor Donorbox Campaigns in Windsurf

Windsurf pulls recent Donorbox transactions using `list_donations` to track active campaign metrics. Cascade uses this Donorbox data to build instant markdown summaries of your daily fundraising progress inside your workspace. To track active initiatives, Windsurf calls `list_fundraising_campaigns` to load the current Donorbox campaign list. You see exactly how your Donorbox donation pages are performing without leaving your Windsurf workspace.

Setup guide

Set up Donorbox 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 Donorbox 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 Donorbox payment history." If connected, Cascade will call the Donorbox tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "donorbox-alternative-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 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 Windsurf

Windsurf runs `check_api_health` to check your Donorbox connection status before Cascade executes complex multi-step updates. If the Donorbox API goes down, the Windsurf agent stops the sequence to prevent partial data updates.

Yes, Windsurf uses `cancel_recurring_plan` or `pause_recurring_plan` to alter Donorbox giving schedules instantly. You just tell the Windsurf Cascade agent what the donor requested, and it finds the Donorbox plan and executes the change.

Yes, Windsurf calls `list_donations` to filter Donorbox records by donor email or campaign name. This lets you pull precise Donorbox transaction records without leaving your active Windsurf workspace.

Edit your `~/.codeium/windsurf/mcp_config.json` file to register the tool. Once saved, the Windsurf client connects to the Donorbox server instantly.

Your Donorbox donor names, emails, and transaction amounts remain secure because this MCP Server runs in a sandboxed V8 isolate. Vinkius handles the Donorbox authentication token directly, meaning your raw API keys are never exposed to the Windsurf agent.

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