How to Use the Salsa Engage MCP in Mastra AI

Q: Does this MCP Server support human-in-the-loop approval with Mastra AI?

Yes. You can configure Mastra's requireToolApproval setting for sensitive actions. This forces the agent to pause and ask for permission before running tools like upsertsupportergroup to modify your database.

Build resilient non-profit workflows using Mastra AI to automate your Salsa Engage supporter updates and activities.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Salsa Engage MCP to Mastra AI

Create your Vinkius account to connect Salsa Engage to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Salsa Engage with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate donor workflows with Mastra AI

The `upsert_supporter_profile` tool acts as the primary data writer inside your Mastra AI workflows. When a supporter fills out an external form, Mastra catches the payload and triggers this tool to update Salsa Engage. If the write fails due to a network glitch, Mastra's built-in retry engine handles the backoff automatically. You can chain this with conditional logic to keep your database clean. For example, your agent checks the profile, and if specific criteria are met, it executes `assign_supporters_to_group` to segment them. This entire sequence runs as a background step, keeping your data synchronized without human intervention.

Resilient event tracking via Mastra AI MCP Server

The `list_engagement_activities` tool feeds clean event logs directly into your Mastra agent's decision loops. Your agent reviews these activities to flag inactive supporters or highlight high-value donors. Because Mastra supports strict schema validation, you never have to worry about poorly formatted activity logs crashing your pipeline. If your workflow detects a sudden drop in activity, it can trigger alert steps. Our workflow uses `list_configured_webhooks` to verify your external notifications are active before sounding the alarm. It keeps your operations running smoothly without manual checks.

Track offline donations automatically with Mastra AI

The `list_offline_donations` tool lets your Mastra workflows monitor manual checks and cash gifts through the MCP Server. Your Mastra agent runs this tool on a schedule to pull new offline records and compare them against your digital campaigns. This ensures your financial reports are accurate across all channels. Once the financial data is in, the workflow uses `get_engagement_metrics` to calculate your total campaign ROI. Mastra's workflow engine can then branch based on these metrics, sending a Slack alert if a campaign hits its target or queuing up a retry if numbers are low.

Setup guide

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

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

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

You register the MCP client using your Vinkius URL, then grab the tools using `mcpClient.listTools()`. From there, you spread those tools directly into your Mastra agent's tool configuration array so it can manage supporter records.

Yes. Mastra has built-in retries with exponential backoff. If `upsert_supporter_profile` hits a rate limit or a temporary network drop, Mastra pauses and retries the request automatically before throwing an error.

You use Mastra's workflow engine to chain steps together. For example, your workflow can call `list_supporters`, check their donation history, and then conditionally run `assign_supporters_to_group` only for donors who have contributed this quarter.

Yes. You can configure Mastra's `requireToolApproval` setting for sensitive actions. This forces the agent to pause and ask for permission before running tools like `upsert_supporter_group` to modify your database.

All communication runs through the Salsa Engage MCP Server via Vinkius's zero-trust gateway. Your offline donations and supporter profiles are processed within isolated sandboxes, ensuring your API credentials are never exposed to the agent framework.

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