# Dub MCP Server

> Use the Dub MCP server to manage your Dub resources with the AI agent of your choice.

MCP is an open protocol that standardizes how applications provide context to LLMs. Among other benefits, it provides LLMs tools to act on your behalf. Dub offers both a [remote MCP server](#remote-mcp-server-recommended) and a [local MCP server](#local-mcp-server).

<Frame>
  <img src="/images/mcp-server.png" alt="MCP Server" />
</Frame>

<Tip>
  Looking for the [Dub Links](https://dub.co/links) MCP server? Check out the
  [Dub Links MCP server docs](https://mcp.dub.sh/mcp/dub-links).
</Tip>

## Remote MCP Server (recommended)

Dub's MCP server is hosted at:

```
https://mcp.dub.sh/mcp/dub-partners
```

Connect any MCP client that supports remote servers (Streamable HTTP). There's nothing to install and no local process to run, which makes it the best option for web-based clients like Claude and hosted agent platforms.

When you connect, your client opens a browser window to log in to Dub and approve access using OAuth.

<Tabs>
  <Tab title="Claude">
    You can install the Dub MCP server as a [custom connector in
    Claude](https://claude.ai/new#settings/customize-connectors):

    <Frame>
      <video
        src="https://assets.dub.co/misc/install-claude-custom-connector.mp4"
        loop
        autoPlay
        muted
        playsInline
      />
    </Frame>

    To install only the MCP server, add it manually in Claude (web or desktop) from **Settings** > **Connectors** > **Add custom connector**:

    ```
    https://mcp.dub.sh/mcp/dub-partners
    ```

  </Tab>

  <Tab title="ChatGPT">
    You can install the Dub MCP server as a [ChatGPT
    plugin](https://chatgpt.com/plugins):

    <Tip>
      Make sure to enable [Developer Mode](https://developers.openai.com/api/docs/guides/developer-mode) in ChatGPT first before installing the plugin.
    </Tip>

    <Frame>
      <video
        src="https://assets.dub.co/misc/install-chatgpt-plugin.mp4"
        loop
        autoPlay
        muted
        playsInline
      />
    </Frame>

  </Tab>

  <Tab title="Cursor">
    Open the command palette and choose **Cursor Settings** → **MCP** → **Add new global MCP server**.

    ```json
    {
      "mcpServers": {
        "dub": {
          "url": "https://mcp.dub.sh/mcp/dub-partners"
        }
      }
    }
    ```

  </Tab>

  <Tab title="Copilot">
    To use GitHub Copilot in VS Code, add the following to your `settings.json`:

    ```json
    {
      "mcp": {
        "servers": {
          "dub": {
            "type": "http",
            "url": "https://mcp.dub.sh/mcp/dub-partners"
          }
        }
      }
    }
    ```

  </Tab>

  <Tab title="Windsurf">

    In Windsurf's Settings, navigate to **Agents** > **MCP servers**, and click **+ Add** to add a new server.

    ```json
    {
      "mcpServers": {
        "dub": {
          "serverUrl": "https://mcp.dub.sh/mcp/dub-partners"
        }
      }
    }
    ```

  </Tab>

  <Tab title="Warp">
    In Warp's Settings, navigate to **Agents** > **MCP servers**, and click **+ Add** to add a new server.

    ```json
    {
      "dub": {
        "serverUrl": "https://mcp.dub.sh/mcp/dub-partners"
      }
    }
    ```

  </Tab>
</Tabs>

---

_If your client runs somewhere a browser login isn't possible_ (a server, CI, or a headless agent), pass a [Dub API key](/docs/api-reference/authentication#api-keys) in the `Mcp-Dub-Token` header instead of using OAuth.

<Tabs>
  <Tab title="Claude Code">
    ```bash
    claude mcp add dub-partners \
      --transport http https://mcp.dub.sh/mcp/dub-partners \
      --header "Mcp-Dub-Token: dub_xxxxxx"
    ```
  </Tab>

  <Tab title="JSON config">
    For clients configured with JSON (Cursor, Windsurf, and others), add a `Mcp-Dub-Token` header:

    ```json
    {
      "mcpServers": {
        "dub": {
          "url": "https://mcp.dub.sh/mcp/dub-partners",
          "headers": {
            "Mcp-Dub-Token": "dub_xxxxxx"
          }
        }
      }
    }
    ```

  </Tab>
</Tabs>

## Local MCP Server

If your MCP client doesn't support connecting directly to a remote HTTP endpoint, use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) to run a local process that proxies requests to Dub's hosted server. You can integrate it into any supported MCP client using `npx`. You'll need a [Dub API key](/docs/api-reference/authentication#api-keys).

Choose your client below to get started. Remember to replace `dub_xxxxxx` with your actual API key.

### Stdio Transport (Default)

<Tabs>
  <Tab title="Claude Code">
    ```bash
    claude mcp add dub-partners \
      --env MCP_DUB_TOKEN=dub_xxxxxx \
      -- npx -y mcp-remote@0.1.25 https://mcp.dub.sh/mcp/dub-partners \
      --header "Mcp-Dub-Token:\${MCP_DUB_TOKEN}"
    ```
  </Tab>

<Tab title="Codex">
  ```bash codex mcp add dub-partners \ --env MCP_DUB_TOKEN=dub_xxxxxx \ -- npx
  -y mcp-remote@0.1.25 https://mcp.dub.sh/mcp/dub-partners \ --header
  "Mcp-Dub-Token:\${MCP_DUB_TOKEN}" ```
</Tab>

  <Tab title="Cursor">
    Open the command palette and choose **Cursor Settings** → **MCP** → **Add new global MCP server**.

    ```json
    {
      "mcpServers": {
        "dub": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote@0.1.25",
            "https://mcp.dub.sh/mcp/dub-partners",
            "--header",
            "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
          ],
          "env": {
            "MCP_DUB_TOKEN": "dub_xxxxxx"
          }
        }
      }
    }
    ```

  </Tab>

  <Tab title="Claude Desktop">
    Open **Claude Desktop** settings → **Developer** tab → **Edit Config** and add the following:

    ```json
    {
      "mcpServers": {
        "dub": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote@0.1.25",
            "https://mcp.dub.sh/mcp/dub-partners",
            "--header",
            "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
          ],
          "env": {
            "MCP_DUB_TOKEN": "dub_xxxxxx"
          }
        }
      }
    }
    ```

  </Tab>

  <Tab title="Copilot">
    To use GitHub Copilot in VS Code, add the following to your `settings.json`:

    ```json
    {
      "mcp": {
        "servers": {
          "dub": {
            "command": "npx",
            "args": [
              "-y",
              "mcp-remote@0.1.25",
              "https://mcp.dub.sh/mcp/dub-partners",
              "--header",
              "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
            ],
            "env": {
              "MCP_DUB_TOKEN": "dub_xxxxxx"
            }
          }
        }
      }
    }
    ```

  </Tab>

  <Tab title="Gemini CLI">
    ```json
    {
      "mcpServers": {
        "dub": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote@0.1.25",
            "https://mcp.dub.sh/mcp/dub-partners",
            "--header",
            "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
          ],
          "env": {
            "MCP_DUB_TOKEN": "dub_xxxxxx"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="OpenCode">
    Add to your `opencode.json` config:

    ```json
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "dub": {
          "type": "local",
          "command": [
            "npx",
            "-y",
            "mcp-remote@0.1.25",
            "https://mcp.dub.sh/mcp/dub-partners",
            "--header",
            "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
          ],
          "enabled": true,
          "environment": {
            "MCP_DUB_TOKEN": "dub_xxxxxx"
          }
        }
      }
    }
    ```

  </Tab>

  <Tab title="Windsurf">
    ```json
    {
      "mcpServers": {
        "dub": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote@0.1.25",
            "https://mcp.dub.sh/mcp/dub-partners",
            "--header",
            "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
          ],
          "env": {
            "MCP_DUB_TOKEN": "dub_xxxxxx"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Warp">
    In Warp's Settings, navigate to **Agents** > **MCP servers**, and click **+ Add** to add a new server.

    ```json
    {
      "dub": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote@0.1.25",
          "https://mcp.dub.sh/mcp/dub-partners",
          "--header",
          "Mcp-Dub-Token:${MCP_DUB_TOKEN}"
        ],
        "env": {
          "MCP_DUB_TOKEN": "dub_xxxxxx"
        }
      }
    }
    ```

  </Tab>
</Tabs>

### Environment variables

- `MCP_DUB_TOKEN`: Your Dub API key (used by `mcp-remote` and referenced in client configs as `${MCP_DUB_TOKEN}`)

<Info>
  Store your API key in the `env` block or an environment variable rather than
  hardcoding it in shared config files when possible.
</Info>

## MCP Server tools

The Dub [MCP server](https://mcp.dub.sh/mcp/dub-partners) gives your AI agent native access to the full Dub platform through a single integration. You can manage your partner program, review applications, update commissions, and track attribution using natural language.

- **Partners** — Create or update partners, list all partners, deactivate, or ban partners from your program
- **Partner links** — Create and upsert links for enrolled partners
- **Applications** — List, approve, and reject pending partner applications
- **Analytics** — Retrieve analytics and list events for any partner, [partner groups](/help/article/partner-groups), or their specific links
- **Customers** — List, retrieve, update, and delete customers
- **Tracking** — Track lead, sale, and deep link open events
- **Bounties** — List, approve, and reject bounty submissions
- **Commissions** — List and update commissions (e.g. for refunds or fraud)
- **Payouts** — List payouts for your partner program

Here are some real examples of what your agent can do with these tools:

- Triage pending partner applications and approve or reject them in bulk
- Adjust commissions after a refund or flag suspicious activity
- Pull attribution analytics for a top partner or [partner group](/help/article/partner-groups)
- Create partner links and track lead or sale conversion events