How to Use the Appcues MCP in Windsurf

Q: Can I check which users are in a segment with Appcues and Windsurf?

Not directly, but you can get close. Use Windsurf to call getsegment to see the segment's rules and getuser to check a specific user's properties against those rules.

Q: Is there a status check tool?

Yes, the checkappcuesstatus tool lets your agent ping the Appcues API. It's a good first step for any automated sequence to make sure the service is reachable.

Let Windsurf's Cascade agent manage your Appcues flows. Set a goal, like publishing a new onboarding sequence, and watch it happen.

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 Windsurf

Create your Vinkius account to connect Appcues to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Onboarding Flows Autonomously

This server gives your agent direct control over your Appcues flows. You can tell Windsurf to `list_flows`, find a specific one, and then `publish_flow` or `unpublish_flow` without touching the Appcues dashboard. It's a fast way to roll out or roll back changes. Cascade makes this even better. Just say, "Update the new user checklist and publish the Q3 feature announcement flow." Windsurf will find the right flows, get their details with `get_flow`, and execute the publishing actions. No more clicking through a web UI.

Inspect Users and Segments

Use your agent to pull user and segment data directly from Appcues. Ask Windsurf to `get_user` by their ID to see their profile or `get_segment` to understand who's in it. You can also `list_segments` or `list_checklists` to get a high-level view. This is useful for quick debugging. Instead of logging into Appcues, just ask your agent, "Is user 123 in the 'Power Users' segment?" Windsurf uses the tools to get the answer right in your IDE.

Full Lifecycle with your Windsurf MCP Server

Your Windsurf agent can now handle the entire Appcues workflow. It starts by checking the connection with `check_appcues_status`. Then it can list, get, publish, and unpublish your user-facing content. This MCP Server even includes a `delete_user` tool for cleanup, but be careful—it's irreversible. Cascade can be configured to ask for confirmation before running destructive actions like that. It's a solid way to manage your user experience logic from one place.

Setup guide

Set up Appcues MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Appcues MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Appcues payment history." If connected, Cascade will call the Appcues tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "appcues-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Just tell the Cascade agent your goal. For example, "Find the flow named 'New Feature Tour' and publish it." Windsurf will use `list_flows` to find it and `publish_flow` to push it live.

Not directly, but you can get close. Use Windsurf to call `get_segment` to see the segment's rules and `get_user` to check a specific user's properties against those rules.

The fastest way is a direct command to your agent. "Unpublish the 'Holiday Sale Banner' flow." It will find the flow and use the `unpublish_flow` tool immediately.

Yes, the `check_appcues_status` tool lets your agent ping the Appcues API. It's a good first step for any automated sequence to make sure the service is reachable.

This server only handles Appcues user profile data when you use `get_user` or `delete_user`. All data is sent directly between Vinkius and Appcues over encrypted connections. Nothing is stored on the MCP server itself.

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