> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Splash to Conversion

> Add the Splash MCP server with your Splash API credentials so Conversion AI chats and agents can work with your Splash events and guests.

Connect Splash through Conversion's hosted MCP wrapper to give AI chats and [agents](https://docs.conversion.ai/product-docs/conversion-ai/agents/overview.md) tools for events, guests, contacts, and registration forms.

> [!NOTE]
>
> To sync event details, RSVPs, and check-ins into a Conversion field event, use the separate [Splash field event integration](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/splash.md). The MCP server is its own connection and does not use that integration's saved sign-in.

## Set up Splash

### Before you begin

* A Conversion **Administrator** account to add the server.
* A Splash **Client ID** and **Client secret**. Splash issues them through your Customer Success Manager. See [Get your Splash API credentials](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/splash.md#get-your-splash-api-credentials). You can reuse the pair the field event integration uses.
* The username and password of the Splash user the tools act as. The tools can see and change only what that user can, so a dedicated integration user works well.
* Optional: a Splash **CRM API key**. Splash issues it separately from the Client ID and Client secret. Only event creation needs it.

### Step 1: Write the client secret value

The server takes every Splash credential except the Client ID as one JSON value on a single line.

1. Copy this template.

   ```json theme={null}
   {"clientSecret":"YOUR_SPLASH_CLIENT_SECRET","username":"YOUR_SPLASH_USERNAME","password":"YOUR_SPLASH_PASSWORD","crmApiKey":"YOUR_SPLASH_CRM_API_KEY"}
   ```

2. Replace each placeholder with your own value.

3. If you have no CRM API key, delete `,"crmApiKey":"YOUR_SPLASH_CRM_API_KEY"`. An empty value is rejected.

If a value contains a double quote or a backslash, put a backslash in front of it.

> [!WARNING]
>
> Conversion stores this value encrypted, password included, and sends it to the wrapper each time a member connects. The wrapper uses the username and password once to sign in to Splash and does not keep them. The field event integration works differently: it does not store the password.

### Step 2: Add the server in Conversion

In Conversion, go to **Settings → AI → Connections**. Under **MCP servers**, click **Add MCP server** (or **Add server** below an existing list). Fill in the fields below.

| Field | Value |
| - | - |
| **Name** | `Splash` |
| **Server URL** | `https://map.mcp.conversion.ai/splash/mcp` |
| **Transport** | **Streamable HTTP** |
| **Authentication** | **OAuth (per user)** |
| **OAuth client ID** | Your Splash **Client ID** |
| **OAuth client secret** | The JSON value from Step 1 |

Keep credentials out of the server URL. The URL is the same for every Splash organization.

### Step 3: Authorize the connection

1. Click **Add server**.
2. Click **Connect** on the Splash server.
3. Confirm the server shows **Authorized**.

No Splash sign-in page appears. The wrapper checks the saved credentials with Splash.

Each member must connect individually. Every connection acts as the Splash user in the JSON value, so all members get the same Splash access.

## Tools

The server exposes 27 tools, one for each operation in [Splash's published API](https://api-docs.splashthat.com/).

| Area | Tools that read | Tools that change Splash |
| - | - | - |
| Events | `splash_all_events`, `splash_individual_event`, `splash_event_details` | `splash_create_event`, `splash_update_an_event`, `splash_workflow_status_update`, `splash_delete_event` |
| Guests | `splash_group_contacts_for_one_event`, `splash_single_group_contact` | `splash_create_single_group_contact`, `splash_update_group_contact`, `splash_batch_cancel_rsvps` |
| Contacts | `splash_get_list_of_contacts`, `splash_get_single_contact_by_id`, `splash_get_contact_history` | `splash_delete_a_contact`, `splash_anonymize_contact` |
| Unsubscribes | `splash_retrieve_unsubscribe` | `splash_create_an_unsubscribe`, `splash_resubscribe` |
| Team | `splash_fetch_organization_groups`, `splash_fetch_organization_roles`, `splash_fetch_organization_users` | `splash_invite_user_to_organization`, `splash_update_role_and_groups_for_an_user`, `splash_delete_user_from_the_organization` |
| Registration form | `splash_retrieve_registration_form` | None |

On the server's **Tools** tab, set each tool's mode. See [tool approval settings](https://docs.conversion.ai/product-docs/workspace-settings/ai/connections.md#server-page-and-tools). Set the tools you don't need to **Disabled**, starting with the ones that delete events, delete or anonymize contacts, and manage team users. Anonymizing a contact cannot be undone.

A few tools behave in ways their names don't show:

* `splash_create_event` needs the CRM API key and the ID of an existing theme. Ask `splash_all_events` to include themes to find one.
* `splash_create_single_group_contact` updates a guest whose status is `added` or `invited`. For a guest with any other status it creates a duplicate with the same email address, so look the guest up first.
* `splash_batch_cancel_rsvps` cancels one guest's RSVP by setting them to not attending. It does not delete the contact.
* No tool designs an event page, edits a Splash email template, or changes a registration form. Splash's API does not offer those.

## Test the connection

1. Open the server's **Tools** tab and confirm Splash tools are listed.
2. Start a Conversion AI chat and ask it to list up to three upcoming Splash events, without creating or changing anything.
3. Approve the read-only tool call if prompted.
4. Compare the returned titles with Splash. A successful empty result is valid for an organization with no upcoming events.

## Limits

Splash allows two API requests per second per Client ID, shared by everything that uses those credentials. That includes the [field event integration](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/splash.md#limits) when both use the same Client ID.

The wrapper does not pace or retry calls. A call over the limit returns Splash's rate limit error. If a create call fails without a clear answer, check Splash before trying again, because the event or guest may already exist.

## Troubleshooting

* **Not Found** or **Unreachable**: check that the server URL is `https://map.mcp.conversion.ai/splash/mcp` and the transport is **Streamable HTTP**.
* **Connect** fails: check that **OAuth client secret** is valid JSON on one line with only the fields from Step 1 and no empty values. If it is, Splash rejected the Client ID, Client secret, username, or password. Try signing in to Splash directly with the same username and password.
* Event creation fails: add `crmApiKey` to the JSON value with **Edit** on the server page. Changing **OAuth client secret** removes every member's connection, so each member clicks **Connect** again.
* A tool reports that the access token expired or was revoked: choose **Disconnect** from the server's options menu, then click **Connect**. If the Splash user's password changed, update the JSON value first.
* A tool fails after connecting: check what the Splash user can access and the error returned by Splash.

After correcting the settings, reconnect if needed and use **Refresh tools** on the server page. A tools list confirms discovery; a successful read-only call confirms access to Splash.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.