Appcues MCP server

Connect Appcues to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Appcues MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get user events tool in Appcues
  • Use the get experience tool in Appcues
  • Use the track user event tool in Appcues
  • Use the publish experience tool in Appcues
  • Use the manage segment members tool in Appcues
  • Use the list tags tool in Appcues

Supported Tools

get_user_events

Get User Events

Retrieve recent event history for a specific user in Appcues. Returns events with their names, timestamps, and attributes. Supports limiting the number of results and specifying a time zone.

get_experience

Get Experience

Retrieve detailed information about a specific Appcues experience by its ID and type. Returns full metadata including name, publish status, frequency, steps, and tags.

track_user_event

Track User Event

Track a custom event for a user in Appcues. Events are immediately available for flow targeting but take several minutes to appear in analytics/insights. Can include optional attributes and group association.

publish_experience

Publish Experience

Publish or unpublish an Appcues experience. Supports all experience types: flows (including Flow 2.0), pins, banners, launchpads, checklists, mobile experiences, NPS surveys, and embeds. Publishing makes the experience visible to users; unpublishing hides it.

manage_segment_members

Manage Segment Members

Add or remove user IDs from a segment in bulk. Membership changes are processed asynchronously. You can also export segment membership to retrieve a list of users in the segment.

list_tags

List Tags

List all tags used to organize experiences in your Appcues account. Tags can be used to filter and categorize flows, checklists, and other experience types.

list_segments

List Segments

List all user segments in your Appcues account. Segments are used to group users for targeted experience delivery.

update_segment

Update Segment

Update an existing segment's name or description in Appcues.

get_job_status

Get Job Status

Check the status of an asynchronous job in Appcues. Many operations like bulk imports, exports, segment membership changes, and user deletions are processed asynchronously and return a job ID. Use this tool to monitor job progress and completion.

create_segment

Create Segment

Create a new user segment in Appcues. Segments can be populated with users later using the "Manage Segment Members" tool.

delete_segment

Delete Segment

Delete a user segment from Appcues. This permanently removes the segment definition and its membership data.

export_events

Export Events

Export event data from Appcues matching specified conditions and time ranges. Supports filtering by flow, checklist, NPS, segment, event name, and custom attributes. The export is processed asynchronously — use the "Get Job Status" tool to track progress.

list_experiences

List Experiences

List all experiences in your Appcues account. Supports filtering by experience type to retrieve flows (including Flow 2.0), pins, banners, launchpads, checklists, mobile experiences, NPS surveys, or embeds. Returns key metadata including publish status, name, and tags.

get_user_profile

Get User Profile

Retrieve an end-user's profile from Appcues. Returns all stored profile properties for the user, which are used for experience targeting and personalization.

update_group_profile

Update Group Profile

Update profile properties for a group (account/company) in Appcues. Group properties can be used for targeting experiences at the group level. Also supports associating users with the group.

get_group_profile

Get Group Profile

Retrieve a group (account/company) profile from Appcues. Group properties are used for targeting experiences at the group level.

delete_user_profile

Delete User Profile

Delete an end-user's profile from Appcues. This resets their experience state (re-enables one-time flows, resets checklist progress) but does **not** remove analytics data. The operation is processed asynchronously.

update_user_profile

Update User Profile

Update profile properties for an end-user in Appcues. Properties are applied synchronously and immediately available for flow targeting and personalization. Pass key-value pairs to set or update.

get_segment

Get Segment

Retrieve a user segment by ID, including its name, description, and creation and update information. Use List Segments to discover segment IDs.

list_jobs

List Jobs

List recent asynchronous import, export, membership, and deletion jobs in the account. Returns job IDs and status so you can inspect progress with Get Job Status.

Connect Appcues to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Appcues in Metorial. In your Metorial portal, enable the Appcues MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Appcues tools.

Run Appcues through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Appcues and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Appcues tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Appcues

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Technical notes for Appcues

Manage Appcues in-app experiences, including web flows, Flow 2.0, pins, banners, launchpads, checklists, mobile experiences, NPS surveys, and embeds. Read experience details and publish or unpublish experiences. Read, update, and delete end-user profiles; track custom events and retrieve event history. Read and update group profiles and associate users with groups. Create, inspect, update, and delete user segments; manage segment membership and initiate event or membership exports. Discover recent asynchronous jobs and inspect their progress.

Frequently asked questions

Common questions about connecting Appcues to AI agents with Metorial.

  1. How many tools does the Appcues MCP server have?
    The Appcues MCP server exposes 20 tools, including Get User Events, Get Experience, Track User Event. Each one is governed and traced through Metorial.
  2. Appcues exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Appcues MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Appcues and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Appcues MCP server yourself or use the hosted gateway.

Connect Appcues to production AI agents

See how Metorial gives your team governed access to Appcues, with tracing and security controls built in.