> For the complete documentation index, see [llms.txt](https://docs.cymbal.co/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cymbal.co/help/mcp.md).

# MCP

Connect AI assistants to Cymbal with the Model Context Protocol (MCP) so they can draft campaigns, pages, automations, and more on your behalf.

Cymbal's **Model Context Protocol (MCP)** connector lets AI assistants like Cursor, Claude, ChatGPT, and other MCP-compatible tools work inside your Cymbal organization. They can draft and edit email and text campaigns, landing pages, automations, contacts, and more. A few go-live steps, like publishing a page or pausing a send, are available too, and the assistant asks for your approval before it does any of them.

**Status:** Product beta

## How to connect an AI assistant

{% stepper %}
{% step %}
In your AI assistant, add a new MCP server or connector.
{% endstep %}

{% step %}
Paste the connector URL: [`https://mcp.cymbal.co/connect`](https://mcp.cymbal.co/connect).
{% endstep %}

{% step %}
When prompted, sign in to Cymbal in your browser and approve access for the organization you want the assistant to use.
{% endstep %}

{% step %}
Once you're connected, the assistant can use Cymbal tools with your account.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Use a Cymbal account that already has access to the right organization. If sign-in fails or the assistant says it isn't authorized, disconnect and reconnect the MCP server, then sign in again.
{% endhint %}

## What assistants can do

**Read** organization data such as events, contacts, campaigns, automations, pages, ads, sources, billing, metrics, tags, and lists.

When an assistant looks up contacts, each result shows the contact's name, email, phone, city, and spend. Ask about one contact by name or email to see their full record. When it builds an export, it can include only the columns that export type offers, and it can tell you which ones those are.

When an assistant looks up events, each result is a short summary: the event's name, status, start time, length, door time, and location. Cover photos, tags, and ticketing source details aren't included.

**Draft and edit:**

* Create, edit, test, and duplicate email and text campaigns
* Create, edit, and duplicate landing pages
* Create, edit, and test automations (but not turn them on)
* Manage contacts, tags, lists, events, settings, domains, and integrations
* Reply in your inbox, manage style presets, and upload images
* Draft Meta ads. If you don't name a Facebook page, the assistant uses the default page saved on your [Meta connection](https://docs.cymbal.co/help/setting-up-cymbal/ads-setup/connecting-meta-ads). If there's no default page, it tells you to pick one. City locations use a radius of 10 to 50 miles, and 50 miles if you don't say.

**Go live, with your approval:**

* Publish, republish, or unpublish a landing page, or cancel a page's scheduled publish
* Pause an email or text campaign that's sending, then resume it
* Cancel a scheduled email or text campaign so you can edit it

The assistant should ask you before each of these, and only go ahead once you approve.

## What assistants can't do

These still happen in Manager, or aren't available at all:

* Send or schedule email and text campaigns
* Schedule a landing page to publish later
* Launch, pause, or resume Meta ads, or turn on automated carousels
* Turn automations on, or turn on the default text welcome message
* Delete contacts, campaigns, pages, or other records
* Use the Partners API, public fan pages, webhooks, or admin-only actions
* Change billing, payment methods, text balance top-ups or auto recharge, or make owner-level team changes like removing members, changing roles, or inviting owners. Those need an organization **Owner**, and anyone else sees **org owner access is required**.

## Recommended workflow

{% stepper %}
{% step %}
Ask the assistant to work in the correct organization.
{% endstep %}

{% step %}
Have it draft the campaign, page, or automation.
{% endstep %}

{% step %}
Review the draft in Manager using the links the assistant gives you.
{% endstep %}

{% step %}
Send, schedule, or turn it on in Manager. If you want the assistant to publish a page or pause, resume, or cancel a send, approve it when the assistant asks.
{% endstep %}
{% endstepper %}

## Related

* Partners API: ticketing partner ingest and page discovery API
