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

# Use MCP

> Connect Boom to Claude, Cursor, or any AI tool. Add one link, sign in — no API key.

Boom works with any AI tool that supports **MCP** (Model Context Protocol) —
like Claude, Cursor, and VS Code. Once it's connected, the tool can look up and
update your customer data for you.

It takes two steps, and there's no API key to set up.

<Steps>
  <Step title="Add Boom to your tool">
    Copy this link:

    ```
    https://www.useboom.ai/mcp
    ```

    Then add it the way your tool expects:

    <Tabs>
      <Tab title="Claude Code">
        Run this in your terminal:

        ```bash theme={null}
        claude mcp add --transport http boom https://www.useboom.ai/mcp
        ```
      </Tab>

      <Tab title="Cursor">
        Add this to `.cursor/mcp.json`, then open **Settings → MCP** and click
        **Boom**:

        ```json theme={null}
        {
          "mcpServers": {
            "boom": {
              "url": "https://www.useboom.ai/mcp"
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        Add this to `.vscode/mcp.json`, then start the server from the little
        button above it:

        ```json theme={null}
        {
          "servers": {
            "boom": {
              "type": "http",
              "url": "https://www.useboom.ai/mcp"
            }
          }
        }
        ```
      </Tab>

      <Tab title="Claude Desktop / Claude.ai">
        Go to **Settings → Connectors → Add custom connector**, paste the link,
        and click **Connect**.
      </Tab>

      <Tab title="Other tools">
        Most tools use a file like this:

        ```json theme={null}
        {
          "mcpServers": {
            "boom": {
              "url": "https://www.useboom.ai/mcp"
            }
          }
        }
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Sign in">
    The first time you use it, a window opens to sign in to Boom — the same login
    you use for the dashboard. Approve it, and you're connected.

    * Everything stays inside **your organization**.
    * In more than one organization? Pick which one when you sign in.
    * There's no key to copy or keep safe — access follows your login.
  </Step>
</Steps>

<Note>
  Just testing? Use `https://dev.useboom.ai/mcp` instead — it's a separate
  sandbox with its own data and login.
</Note>

## What you can do

Once connected, the AI tool gets the **same capabilities as the REST API**
(see [one uniform surface](/one-surface)):

* **Customer data** — find, add, and update **people**; record and read
  **events** (like a purchase or a sign-up); manage **custom objects** —
  things like orders or loans; and link records with **relationships**.
* **Segments** — the full authoring loop: discover what's filterable,
  validate and preview a filter, create or update an audience, trigger an
  evaluation, and page through who's in it.
* **Initiatives** — create and configure outreach initiatives, link the
  WhatsApp templates they'll send, drive the lifecycle (**launch**, cancel,
  archive, unarchive), and read a summary of the data collected.
* **Participants** — add people to an active initiative, list them, check
  one participant's status, read their conversation transcript, and stop
  their outreach.
* **Journeys** — list your journeys and read one, including its live
  status and metrics (read-only).
* **WhatsApp templates** — see your WhatsApp numbers, then list, read,
  and create message templates.

<Warning>
  Adding participants to an initiative (and launching one) sends **real
  WhatsApp messages to real customers**. Any connected AI tool can do it, so
  check what a tool is doing before you let it run on its own. People on
  your Do Not Contact list are always skipped.
</Warning>

<Note>
  Destructive and outreach actions — deleting records, launching or
  cancelling initiatives, adding or stopping participants — require your
  Boom login to be an **organization admin**. Read tools work for every
  member.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="One uniform surface" icon="layers" href="/one-surface">
    How MCP tools map one-to-one onto REST endpoints.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Work with the same data over the REST API.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API keys for scripts and server-to-server calls.
  </Card>

  <Card title="Connect your database" icon="database" href="/connect-your-database">
    Sync people and objects straight from your database.
  </Card>

  <Card title="Rate limits & errors" icon="gauge-high" href="/rate-limits-and-errors">
    Limits and the shared error shape.
  </Card>
</CardGroup>