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

# Bouncy MCP server

> Connect Claude, ChatGPT, Cursor and other AI apps to your Bouncy account

## What it is

The Bouncy MCP server lets AI apps work with your Bouncy account. Connect it once, then ask in plain language: create deeplinks, check how they perform, organize them into groups, connect a custom domain or draft a link-in-bio website.

MCP (Model Context Protocol) is the open standard AI apps use to call outside tools. Claude, ChatGPT, Cursor, VS Code, Gemini CLI and many other apps support it.

The server lives at one URL:

```text theme={null}
https://mcp.bouncy.ai/mcp
```

> [!NOTE]
>
> Enter the URL exactly as shown, including `https://` and `/mcp` at the end. `bouncy.ai`, `api.bouncy.ai` or `mcp.bouncy.ai` on its own will not work.

## Who can use it

AI connections are included on the **Growth plan and above** (Growth, Scaling, Dominance, Agency and Enterprise), the same plans that include the [Bouncy API](https://docs.bouncy.ai/introduction.md). Your email address must be verified.

If you are on the Free or Solo plan, the approval page shows an upgrade option instead of the Approve button. [Compare plans](https://bouncy.ai/pricing).

## How connecting works

**1. Add the URL to your AI app**

Paste `https://mcp.bouncy.ai/mcp` into your AI app as a custom connector or MCP server. See the setup guides for [Claude](https://docs.bouncy.ai/mcp/claude.md), [ChatGPT](https://docs.bouncy.ai/mcp/chatgpt.md) and [developer tools](https://docs.bouncy.ai/mcp/developer-tools.md).

**2. Sign in to Bouncy**

Your AI app opens a Bouncy page. Log in if you are not already.

**3. Check the app and approve**

The page shows which app is asking (for example "Claude wants to access your Bouncy account") and where it will send you back. Well-known apps such as Claude, ChatGPT, VS Code, Cursor and apps running on your own computer show a **Verified** badge. Pick an access level and click **Approve**.

**4. Start asking**

Back in your AI app, ask it to work with your deeplinks. For example: "Create a deeplink for onlyfans.com/amy on tapmy.social with the slug amy and turn on the 18+ warning."

There is no API key to copy. Developers who prefer keys can also send a normal Bouncy API key instead of signing in, see [Developer tools](https://docs.bouncy.ai/mcp/developer-tools.md).

## What an AI can do

> [card] [Deeplinks](https://docs.bouncy.ai/mcp/tools.md#deeplinks)
>
> Create (one at a time or up to 100 at once), edit, pause, activate and delete deeplinks, including geo rules, language rules, Meta pixel, Google tags, SEO details, bounce behavior and the 18+ warning.

> [card] [Stats](https://docs.bouncy.ai/mcp/tools.md#stats)
>
> Views, countries, devices, platforms and referrers for one deeplink, plus account-wide totals and your top deeplinks.

> [card] [Groups](https://docs.bouncy.ai/mcp/tools.md#groups)
>
> Create, rename and delete groups, and move deeplinks between them.

> [card] [Domains](https://docs.bouncy.ai/mcp/tools.md#domains)
>
> List your domains, connect a custom domain, get its DNS records and check whether it is verified.

> [card] [Websites](https://docs.bouncy.ai/mcp/tools.md#websites)
>
> Draft a link-in-bio website that you review and publish in the editor, and read your existing websites.

> [card] [Account](https://docs.bouncy.ai/mcp/tools.md#account)
>
> Your plan, how many deeplinks you can still create, and which bounce behaviors your plan allows.

See the [tools reference](https://docs.bouncy.ai/mcp/tools.md) for every tool and example prompts.

### What it cannot do

* **Billing:** AI apps can never see payment details, change your plan or buy anything. Billing stays in the Bouncy dashboard.
* **Some dashboard features are not available to AI apps yet:** A/B tests, two-step pages, bot protection, Browser assist, 18+ warning page designs, hiding Bouncy branding, QR codes, share pages, changing a deeplink's address and team management. Use the dashboard for these.
* **Publishing websites:** the AI creates a draft. You review it and publish it yourself in the editor.

## Access levels

When you approve a connection you choose how much the AI app can do. **Full Access** is selected by default.

| Access level | The AI app can | The AI app cannot |
| - | - | - |
| **Full Access** (default) | Everything below, plus connect and verify custom domains | Billing or plan changes |
| **Creator** | Create, edit, pause and delete deeplinks; manage groups; draft and edit websites; read stats and domains | Connect or verify custom domains |
| **Viewer** | Read deeplinks, stats, domains, groups, geo presets, websites and plan limits | Create, change or delete anything |

The AI app only sees the tools its access level allows. A Viewer connection has no create, edit or delete tools at all.

> [!TIP]
>
> Connecting an assistant only to report on stats? Choose **Viewer**. It can read everything it needs and cannot change anything, even if it is given bad instructions.

To change the access level of an existing connection, revoke it on the [Connections page](https://app.bouncy.ai/connections) and connect again.

## Connection limit

You can have up to **10 AI connections** at once. When you approve an 11th, the connection that was used least recently is disconnected automatically.

AI connections do not count toward your 10 API keys. Each one appears on the [Connections page](https://app.bouncy.ai/connections) under **AI assistants**, and in the [API dashboard](https://app.bouncy.ai/api/dashboard) with an **AI connection** badge.

## Usage and rate limits

Every tool call makes one Bouncy API request (occasionally two), so tool calls count toward your plan's [API rate limits](https://docs.bouncy.ai/authentication.md#rate-limits) and appear in the Request Log of the API dashboard. At normal chat pace you will not come close to the limits.

## Set up your app

> [card] [Claude](https://docs.bouncy.ai/mcp/claude.md)
>
> Claude on the web, desktop and mobile, Claude Code and the Claude API

> [card] [ChatGPT](https://docs.bouncy.ai/mcp/chatgpt.md)
>
> ChatGPT developer mode on paid plans

> [card] [Developer tools](https://docs.bouncy.ai/mcp/developer-tools.md)
>
> Cursor, VS Code, Devin Desktop (Windsurf), Gemini CLI and MCP Inspector

> [card] [Security](https://docs.bouncy.ai/mcp/security.md)
>
> What an AI app can see and change, and how to disconnect it

Something not working? See [Troubleshooting](https://docs.bouncy.ai/mcp/troubleshooting.md).


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