How to Use the GivingFuel MCP in Mastra AI

Q: How do I restrict Mastra AI from editing sensitive donor profiles in GivingFuel?

You can use Mastra's requireToolApproval configuration to require human authorization before the agent reads or processes data from listcrmcontacts. This keeps your donor profiles secure.

Build automated workflows to reconcile GivingFuel donation data using Mastra AI's resilient agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GivingFuel MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient GivingFuel reconciliation loops with Mastra AI

The `verify_api_connection` tool serves as the entry gate for your Mastra AI workflow, confirming credentials before executing heavy database queries. Once verified, the agent uses `list_financial_transactions` to pull successful charges. If a transaction fails, Mastra's workflow engine triggers conditional branching to alert your finance team. To handle transient network drops, Mastra AI applies automatic retries with exponential backoff when executing `filter_orders_by_status`. This MCP Server setup ensures that your automated ledger reconciliation never fails silently. Bottom line: you get a bulletproof back-office sync that recovers on its own.

Track Mastra AI peer-to-peer campaigns automatically

The `list_peer_campaigns` tool allows your Mastra AI agent to pull active peer-to-peer fundraising efforts. By setting up a recurring workflow, the agent monitors these campaigns and correlates them with incoming orders via `list_recent_donations`. If campaign activity spikes, the workflow can automatically elevate the priority of specific pages. You define this logic using Mastra's TypeScript-native workflow engine, which maps the outputs of individual MCP tools to subsequent steps. If a campaign hits its goal, the agent can trigger external integrations without requiring human intervention, keeping your peer-to-peer coordinators updated.

Trigger donor retention sequences via Mastra AI

The `list_crm_contacts` tool exposes donor history to Mastra AI, enabling the agent to evaluate donor lifetime value. By analyzing orders retrieved through `list_donation_orders`, the agent determines if a donor has lapsed. The TypeScript-native workflow then schedules a follow-up action based on the donor's historical giving patterns. This multi-step process runs entirely on Vinkius's secure, managed infrastructure, meaning your GivingFuel API keys are never hardcoded in your deployment. Mastra's human-in-the-loop feature, `requireToolApproval`, can halt the workflow before sending emails, giving your team final veto power over AI-generated messages.

Setup guide

Set up GivingFuel 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 GivingFuel 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: "givingfuel-mcp-client",
  servers: {
    "givingfuel-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent GivingFuel 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 GivingFuel. 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 GivingFuel 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 GivingFuel MCP in Mastra AI

Initialize the MCP client with your Vinkius URL and register `verify_api_connection` in your agent's toolset. The agent executes this tool at the start of any workflow to confirm the GivingFuel API is responsive.

Yes, Mastra AI's workflow engine includes built-in exponential backoff. If a call to `list_donation_orders` or `filter_orders_by_date` fails due to rate limits, the workflow retries the operation automatically.

You can use Mastra's `requireToolApproval` configuration to require human authorization before the agent reads or processes data from `list_crm_contacts`. This keeps your donor profiles secure.

Mastra AI automatically detects the transport protocol, supporting both Streamable HTTP and SSE. It connects to your managed GivingFuel server hosted on Vinkius using a single secure endpoint token.

Mastra AI processes data ephemeral-by-default, while Vinkius runs the MCP Server in a zero-trust V8 isolate sandbox. GivingFuel donation orders fetched via `list_donation_orders` are processed in memory and 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