How to Use the FundraisingBox MCP in Mastra AI

Q: How do I configure Mastra AI with the FundraisingBox MCP Server?

Instantiate a new MCPClient and pass your Vinkius URL in the servers object. Mastra auto-detects the transport layer and exposes the tools to your agent.

Q: Can Mastra AI require human approval for FundraisingBox actions?

Yes. You can configure requireToolApproval on specific operations. The workflow pauses and waits for an admin to click approve before proceeding.

Q: How do I find specific contributors?

Give your workflow access to the searchdonors tool. The agent constructs the query parameters based on incoming webhook data to locate the exact match.

Q: How does this integration handle sensitive contributor profiles?

The getdonor tool retrieves physical addresses and contact details. The MCP connection secures these requests through ephemeral zero-trust execution, meaning the runtime environment vanishes the moment the data transfers.

Build complex donation workflows and handle API failures gracefully using Mastra AI and FundraisingBox.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FundraisingBox MCP to Mastra AI

Create your Vinkius account to connect FundraisingBox to Mastra 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 FundraisingBox with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated receipt reconciliation

The `list_receipts` tool pulls recent tax documents into your Mastra AI workflow engine. You set up a scheduled run that grabs the previous day's batch and checks for missing entries. If a receipt failed to generate, the workflow branches automatically. It triggers a retry loop with exponential backoff until the document appears in the system.

Reliable donor sync pipelines

The `list_donors` tool extracts your entire contributor base for external synchronization. Mastra handles the pagination state, pulling batches sequentially without overwhelming the endpoint. When a timeout occurs, the agent pauses. It waits for the specified window before resuming the exact page request, ensuring zero dropped records during large exports.

Conditional campaign alerts

The `get_campaign` tool checks specific funding targets against your custom thresholds. You write a Mastra workflow that runs hourly to evaluate the current raised amount. If the goal hits 100%, the agent routes the logic to a notification step. It stops querying the MCP Server and fires off an alert to your Slack channel.

Setup guide

Set up FundraisingBox MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All FundraisingBox tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "fundraisingbox-mcp-client",
  servers: {
    "fundraisingbox-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "FundraisingBox Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to FundraisingBox tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent FundraisingBox transactions"
);
console.log(result.text);

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 FundraisingBox. 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 FundraisingBox 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 FundraisingBox MCP in Mastra AI

Instantiate a new `MCPClient` and pass your Vinkius URL in the servers object. Mastra auto-detects the transport layer and exposes the tools to your agent.

Yes. You can configure `requireToolApproval` on specific operations. The workflow pauses and waits for an admin to click approve before proceeding.

The framework catches the 429 error automatically. It applies exponential backoff and retries the tool call until the API accepts the request.

Give your workflow access to the `search_donors` tool. The agent constructs the query parameters based on incoming webhook data to locate the exact match.

The `get_donor` tool retrieves physical addresses and contact details. The MCP connection secures these requests through ephemeral zero-trust execution, meaning the runtime environment vanishes the moment the data transfers.

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