How to Use the GaggleAMP MCP in Mastra AI

Q: How do I register the GaggleAMP MCP Server with Mastra AI?

You initialize the client using @mastra/mcp and add the Vinkius URL to your server configuration. This setup exposes tools like listgagglemembers directly to your agent workflows.

Q: Can Mastra AI handle human approval before creating a GaggleAMP activity?

Yes. You can configure the agent with requireToolApproval for the createactivity tool, pausing the workflow until a manager approves the draft.

Q: How does Mastra AI track advocate points in GaggleAMP?

The agent uses getmemberpoints within a workflow to check points and automatically triggers listavailablerewards when a member passes a specific threshold.

Automate your employee advocacy workflows with Mastra AI and build resilient multi-step sharing campaigns.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GaggleAMP MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate reward fulfillment with Mastra AI

The `redeem_reward_item` tool executes the entire prize claim process inside your automated agent workflows using this MCP Server. Mastra AI handles the conditional logic, checking if a member has enough points before letting them claim an item. If a redemption fails due to a network error, Mastra's built-in retry engine automatically runs the tool again with exponential backoff. This ensures your advocates get their rewards without you having to manually monitor the log files.

Build conditional advocate onboarding pipelines

The `invite_new_advocate` tool sends an official invitation to join your company's social sharing network via MCP. Your agent can trigger this action automatically when a new employee record is added to your HR system. This integration allows Mastra to verify the invite status, and if the user doesn't accept within a week, the workflow branches to send a reminder. You get a self-managing onboarding system that doesn't require manual follow-ups.

Resilient activity monitoring and engagement tracking

The `get_activity_engagement` tool fetches detailed performance metrics for specific social tasks assigned to your team. Mastra AI processes these metrics through its workflow engine to identify which posts are generating the most traction. You can set up a workflow that runs `list_activities` every Monday, analyzes the engagement of each post, and automatically flags low-performing items. The agent handles the evaluation and updates your marketing team via Slack if engagement drops below your threshold.

Setup guide

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

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

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

You initialize the client using `@mastra/mcp` and add the Vinkius URL to your server configuration. This setup exposes tools like `list_gaggle_members` directly to your agent workflows.

Yes. You can configure the agent with `requireToolApproval` for the `create_activity` tool, pausing the workflow until a manager approves the draft.

The agent uses `get_member_points` within a workflow to check points and automatically triggers `list_available_rewards` when a member passes a specific threshold.

Mastra AI features automatic retries that handle API rate limits gracefully. When tools like `list_reward_history` return a rate limit error, the framework pauses and retries the call automatically.

Your social engagement statistics and member lists accessed via `get_activity_engagement` are processed in memory and never written to persistent storage. Vinkius isolates each execution in a secure, zero-trust sandbox that is destroyed immediately after your agent finishes its run.

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