How to Use the Donately MCP in Mastra AI

Q: How do I register the Donately MCP Server tools in Mastra AI?

Create a new MCPClient pointing to your Vinkius server URL and fetch the tools using listTools. You can then spread these tools directly into your Mastra Agent's tool configuration array.

Q: How do I require manual approval in Mastra AI before updating a Donately subscription?

You can set the requireToolApproval flag on your Mastra agent when calling the getsubscription or related tools. This pauses the workflow until an admin reviews the proposed subscription change.

Q: How does Mastra AI handle rate limits when calling Donately list endpoints?

The framework's queue system throttles requests to listdonations to keep your API usage within Donately's limits. This prevents your automated reporting runs from crashing during high-volume giving days.

Build resilient, self-healing donor workflows using Mastra AI and this Donately MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Donately MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build multi-step donor workflows with Mastra AI

The `get_person` tool fetches specific donor contact details to trigger automated, multi-step onboarding sequences. If a new donor profile is detected, your Mastra agent can route their details to your email marketing system or CRM. Because Mastra supports conditional branching, you can check if a donor is new or returning. The workflow automatically branches to send a personalized thank-you note if the donor's ID doesn't show up in previous query logs.

Recover failed payments using Mastra workflow engines

The `list_subscriptions` tool scans your recurring donation plans to identify failed billing cycles or expired cards. Your agent can parse this list, isolate the failing accounts, and queue them for automated billing retries. Using the built-in retry mechanisms in this MCP Server, you can configure exponential backoff for failed API calls. This prevents your workflows from hitting Donately's rate limits while attempting to fetch updated subscription statuses.

Track peer-to-peer campaigns via Mastra agents

The `list_fundraisers` tool pulls active peer-to-peer campaigns so your agents can monitor individual fundraiser progress. If a fundraiser hits a milestone, the agent triggers a slack notification or an automated email. You can combine this with `get_fundraiser` to drill down into specific volunteer efforts. The agent manages the entire execution loop, ensuring that fundraiser data is updated across your internal tracking tools.

Setup guide

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

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

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

Create a new `MCPClient` pointing to your Vinkius server URL and fetch the tools using `listTools`. You can then spread these tools directly into your Mastra Agent's tool configuration array.

Yes, Mastra's workflow engine handles automatic retries with exponential backoff if the `create_donation` endpoint fails due to network issues. This ensures donation records are created reliably without manual intervention.

You can set the `requireToolApproval` flag on your Mastra agent when calling the `get_subscription` or related tools. This pauses the workflow until an admin reviews the proposed subscription change.

The framework's queue system throttles requests to `list_donations` to keep your API usage within Donately's limits. This prevents your automated reporting runs from crashing during high-volume giving days.

Your donor database records, including emails and subscription history, are handled within isolated V8 sandboxes. No personal identifiable information is saved on disk, maintaining strict compliance with privacy standards.

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