How to Use the GiveWP MCP in Mastra AI

Q: How can I build a donor-lookup workflow with GiveWP and Mastra AI?

Configure an agent with access to finddonorhistory and listrecentdonations. The agent can then run sequential steps to locate a donor and pull their entire giving history in one execution.

Build reliable multi-step fundraising workflows with Mastra AI and live GiveWP metrics.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GiveWP MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate donor outreach using this MCP Server

This MCP Server lets Mastra AI run targeted workflows based on donor behaviors. The framework calls `find_donor_history` to analyze past contributions and determine which donors need a follow-up. If a recurring donor slips, the agent triggers a recovery sequence. It uses `list_plugin_donors` to segment inactive supporters and queue up personalized email drafts.

Execute conditional campaign audits with Mastra AI

This GiveWP integration sets up automated monitors that track your fundraising goals using `get_form_performance`. The workflow engine uses this tool to check if a specific form is meeting its daily targets. If performance drops below your threshold, the agent branches to notify your marketing team. It extracts metadata via `get_form_details` to pinpoint which campaign settings require immediate attention.

Run scheduled donation reconciliation loops

This tool suite automates your weekly book-keeping tasks without writing custom cron jobs. The framework executes `list_plugin_donations` to compile every transaction processed over the last seven days. It then calls `get_plugin_stats` to verify that your WordPress database matches your external accounting logs. The MCP Server's built-in retry logic ensures temporary network drops never ruin your financial reports.

Setup guide

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

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

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

Import the client from the package and register the MCP Server in your agent configuration. You can then expose `list_donation_forms` directly to your agent's execution loop.

Yes, the framework handles temporary network issues using exponential backoff. If `verify_api_connection` fails during initialization, your workflow automatically retries before throwing an error.

Configure an agent with access to `find_donor_history` and `list_recent_donations`. The agent can then run sequential steps to locate a donor and pull their entire giving history in one execution.

Yes, you can require manual approval before your workflow processes sensitive commands. This prevents the agent from exporting data via `list_plugin_donors` without an administrator's sign-off.

Your donor records and transaction histories remain strictly inside your WordPress database. The integration routes queries through an encrypted, memory-isolated sandbox that discards payload data immediately after execution.

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