# Dub MCP by usefulapi

> Dub MCP by usefulapi is a freemium MCP server for marketing and seo. Hosted MCP server that lets AI assistants read and manage Dub short links and analytics. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/dub/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/dub
- **MCP Registry name:** io.usefulapi/dub
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The README describes this as a hosted remote endpoint, so there is nothing to install locally; you point an MCP client at a URL and sign in with your own Dub API key through a login page. Once connected, an assistant can pull click, lead and sale analytics, list links by domain, tag or folder, and look up customers attributed to your links.

The server exposes 26 tools in total. Fifteen are read-only, covering links, analytics, events, customers, tags, folders, domains and partner-programme data. The other seven can create or change data, for example creating and updating short links, creating tags and folders, and approving or rejecting partner applications. Deleting a link is also among the write tools, and the page notes that its analytics are removed with it.

This suits people who already run their short links in Dub and want to query them from Claude, ChatGPT, Cursor or VS Code. The page states that usefulapi is an independent service and is not affiliated with or endorsed by Dub. A free tier allows 50 tool calls a month, with paid Pro and Pro+ plans for higher limits.

## Features

- **Link and analytics reporting:** Ranks top links by clicks and breaks down clicks, leads and sales by country, device or referer.
- **Link lookup and filtering:** Lists and counts short links by domain, tag, folder or text search.
- **Link management:** Creates, updates, archives and deletes short links, with tags and folders.
- **Partner programme tools:** Reviews applications, approves or rejects them, and reads commissions, payouts and partner analytics.
- **OAuth sign-in:** Connects with a login page for a Dub API key, so no credentials go in client config files.
- **Read-only and write tools:** Marks read-only tools separately so clients can ask for approval before data changes.

## Good for

- Check which short links drove the most clicks in a given week
- Count sales and revenue generated by affiliate partners
- Create a tagged short link for a campaign without leaving the chat
- Review pending partner applications and commissions
- Find all links in a folder or domain for cleanup

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http dub https://dub.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://dub.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "dub": {
      "url": "https://dub.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "dub": {
      "type": "http",
      "url": "https://dub.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "dub": {
      "serverUrl": "https://dub.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "dub": {
      "type": "http",
      "url": "https://dub.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `dub_list_links`: List short links, filtered by domain, tag, folder or a text search. Dub: GET /links.
- `dub_get_link`: Fetch a single link by its id, its external id, or its domain plus key. Dub: GET /links/info.
- `dub_count_links`: Count links matching a filter, optionally grouped by domain, tag or folder. Cheaper than listing when you only need totals. Dub: GET /links/count.
- `dub_get_analytics`: Get aggregated click, lead and sale analytics, grouped by a dimension such as country, device, referer or top links. The main reporting read. Dub: GET /analytics.
- `dub_list_events`: List individual click, lead and sale events rather than aggregates — the row-level detail behind the analytics. Dub: GET /events.
- `dub_list_customers`: List the customers Dub has attributed to links, by email, external id or link. Dub: GET /customers.
- `dub_get_customer`: Fetch a single customer with their attribution. Dub: GET /customers/{id}.
- `dub_list_tags`: List the tags available for organising links. Dub: GET /tags.
- `dub_list_folders`: List link folders and their access levels. Dub: GET /folders.
- `dub_list_domains`: List the short domains configured on the workspace. Dub: GET /domains.
- `dub_list_partners`: List the partners (affiliates) in the programme, by status, country or email. Dub: GET /partners.
- `dub_get_partner_analytics`: Get analytics for the partner programme — clicks, leads, sales and revenue per partner. Dub: GET /partners/analytics.
- `dub_list_partner_applications`: List pending applications to join the partner programme. Dub: GET /partners/applications.
- `dub_list_commissions`: List partner commissions, by partner, status, customer or time window. Dub: GET /commissions.
- `dub_list_payouts`: List partner payouts and their status. Dub: GET /payouts.
- `dub_create_link`: Create a short link. Omit `key` to let Dub generate one. Dub: POST /links.
- `dub_update_link`: Change a link's destination, key, tags or archived state. Dub: PATCH /links/{linkId}.
- `dub_delete_link`: Delete a short link. The URL stops resolving immediately and its analytics go with it. Dub: DELETE /links/{linkId}.
- `dub_create_tag`: Create a tag for organising links. Dub: POST /tags.
- `dub_create_folder`: Create a folder for grouping links. Dub: POST /folders.
- `dub_approve_partner_application`: Approve an application to join the partner programme. The partner gains links and starts earning commission. Dub: POST /partners/applications/approve.
- `dub_reject_partner_application`: Reject an application to join the partner programme. Dub: POST /partners/applications/reject.

## FAQ

### What do I need to connect?

The login page asks for your Dub API key, which you create under Dub Settings, API Keys.

### Is this an official Dub product?

No. The page states usefulapi is an independent service and is not affiliated with or endorsed by Dub.

### Can the AI change my Dub data?

Yes, if you approve it. Seven of the 26 tools can create or change data; the rest are read-only.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9/mo or $90/yr with 10,000 calls, and Pro+ is $39/mo or $390/yr with 100,000 calls.

### Is Dub MCP by usefulapi free?

Dub MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Dub MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http dub https://dub.usefulapi.io/mcp

### What are the best alternatives to Dub MCP by usefulapi?

The closest alternatives to Dub MCP by usefulapi are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Customer Io](https://ai-powered.com/mcp/customer-io): Customer Io is a freemium MCP server for marketing and seo.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [Ads AI Creator MCP](https://ai-powered.com/mcp/ads-ai-creator-mcp): Ads AI Creator MCP is a paid MCP server for marketing and seo.
- [Zovo QR Code Maker](https://ai-powered.com/mcp/zovo-qr-code-maker): Zovo QR Code Maker is an MCP server for marketing and seo.
- [Agentzia](https://ai-powered.com/mcp/agentzia): Agentzia is a freemium MCP server for marketing and seo.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.

---
Source: https://ai-powered.com/mcp/dub-mcp-by-usefulapi
