How to Use the Appcues MCP in Mastra AI

Q: How does Mastra AI handle Appcues API downtime?

The agent uses checkappcuesstatus to verify the connection. If the API is down, Mastra's built-in engine pauses the workflow and retries the operation later.

Q: Can a Mastra AI agent manage Appcues checklists?

Yes, the agent calls listchecklists to audit your active guides. You can build a workflow that automatically flags checklists that have been inactive for too long.

Build resilient, self-healing Appcues onboarding workflows with Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Appcues MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Appcues flow publishing with Mastra AI

This MCP Server executes `publish_flow` inside your Mastra AI state machine to automate your release cycles. If the publish action fails due to a network hiccup, the framework retries the action using exponential backoff. You can set up conditional branches that check if a flow is ready before pushing it live. The agent manages the transition states so your team never pushes half-baked onboarding steps to production.

Clean up inactive Appcues users safely

This MCP Server invokes `delete_user` to purge old test profiles from your Appcues dashboard automatically. Because this action is irreversible, Mastra AI lets you require manual approval before the agent runs the command. The agent gathers the profile details using `get_user` first, presents them to your team in Slack, and waits for a green light before executing the wipe. This keeps your user database clean without risking live production data.

Sync segment changes to external systems

This MCP Server monitors your target audiences by calling `list_segments` to find changes in your user base. Mastra AI triggers downstream workflows the moment a segment membership shifts. If a sync fails, the workflow engine catches the error, logs the segment ID from `get_segment`, and alerts your on-call engineer. It handles the entire lifecycle without dropping events or stalling your pipelines.

Setup guide

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

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

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

Yes, you can. Use the framework's manual approval flag before running the `publish_flow` tool to prevent accidental launches.

The agent uses `check_appcues_status` to verify the connection. If the API is down, Mastra's built-in engine pauses the workflow and retries the operation later.

Yes, the agent calls `list_checklists` to audit your active guides. You can build a workflow that automatically flags checklists that have been inactive for too long.

You configure the endpoint token once in your environment variables. The agent connects to the hosted server securely without exposing your raw API keys to the workflow logic.

Yes, because this MCP Server only processes your Appcues user segments and flow configurations inside a zero-trust sandbox. The framework reads the data to run your workflows and discards it immediately afterward.

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