Servers Playground How we check Add a server Log in

Dub MCP by usefulapi

Working · 2.3 s

io.usefulapi/dubv1.17.0 Domain verified

Short links with click, lead and sale analytics, customers, tags and the partner programme.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://dub.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

dub_approve_partner_application Destructive

Approve an application to join the partner programme. The partner gains links and starts earning commission. Dub: POST /partners/applications/approve.

applicationIdstring, required

The application to approve.

groupIdstring

Place the partner in this group.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Dub MCP by usefulapi MCP server | mcptry

Tools (22)

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.

destructive

Argument	Type	Description
groupId	string	Place the partner in this group.
applicationId*	string	The application to approve.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "applicationId"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Place the partner in this group."
    },
    "applicationId": {
      "type": "string",
      "description": "The application to approve."
    }
  }
}

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.

read-only

Argument	Type	Description
domain	string	Only links on this short domain.
search	string	Free-text search.
groupBy	string	Return counts grouped by this dimension.
folderId	string	Only links in this folder.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Only links on this short domain."
    },
    "search": {
      "type": "string",
      "description": "Free-text search."
    },
    "groupBy": {
      "enum": [
        "domain",
        "tagId",
        "folderId",
        "userId"
      ],
      "type": "string",
      "description": "Return counts grouped by this dimension."
    },
    "folderId": {
      "type": "string",
      "description": "Only links in this folder."
    }
  }
}

dub_create_folder

Create a folder for grouping links. Dub: POST /folders.

destructive

Argument	Type	Description
name*	string	The folder name.
accessLevel	string	Default workspace access to the folder.
description	string	What the folder is for.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The folder name."
    },
    "accessLevel": {
      "enum": [
        "write",
        "read",
        "none"
      ],
      "type": "string",
      "description": "Default workspace access to the folder."
    },
    "description": {
      "type": "string",
      "description": "What the folder is for."
    }
  }
}

dub_create_link

Create a short link. Omit `key` to let Dub generate one. Dub: POST /links.

destructive

Argument	Type	Description
key	string	The short key. Omit for a random one.
url*	string	The destination URL.
title	string	Custom link preview title.
domain	string	Short domain to create it on. Defaults to the workspace default.
comments	string	An internal note.
folderId	string	Folder to file it under.
tagNames	array	Tags to attach, by name.
externalId	string	Your own id for this link.
description	string	Custom link preview description.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "url"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "The short key. Omit for a random one."
    },
    "url": {
      "type": "string",
      "description": "The destination URL."
    },
    "title": {
      "type": "string",
      "description": "Custom link preview title."
    },
    "domain": {
      "type": "string",
      "description": "Short domain to create it on. Defaults to the workspace default."
    },
    "comments": {
      "type": "string",
      "description": "An internal note."
    },
    "folderId": {
      "type": "string",
      "description": "Folder to file it under."
    },
    "tagNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to attach, by name."
    },
    "externalId": {
      "type": "string",
      "description": "Your own id for this link."
    },
    "description": {
      "type": "string",
      "description": "Custom link preview description."
    }
  }
}

dub_create_tag

Create a tag for organising links. Dub: POST /tags.

destructive

Argument	Type	Description
name*	string	The tag name.
color	string	Tag colour in the dashboard.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The tag name."
    },
    "color": {
      "enum": [
        "red",
        "yellow",
        "green",
        "blue",
        "purple",
        "pink",
        "brown"
      ],
      "type": "string",
      "description": "Tag colour in the dashboard."
    }
  }
}

dub_delete_link

Delete a short link. The URL stops resolving immediately and its analytics go with it. Dub: DELETE /links/{linkId}.

destructive

Argument	Type	Description
linkId*	string	The link to delete.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "linkId"
  ],
  "properties": {
    "linkId": {
      "type": "string",
      "description": "The link to delete."
    }
  }
}

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.

read-only

Argument	Type	Description
end	string	ISO-8601 end of an absolute range.
key	string	The short key, used with domain.
event	string	Which event type to report. Defaults to clicks.
start	string	ISO-8601 start of an absolute range.
device	string	Filter to one device type.
domain	string	Only links on this domain.
linkId	string	Only this link.
country	string	Filter to one country code.
groupBy	string	Dimension to group by, e.g. count, timeseries, top_links, countries, cities, devices, browsers, os, referers, utm_sources.

dub_get_customer

Fetch a single customer with their attribution. Dub: GET /customers/{id}.

read-only

Argument	Type	Description
customer_id*	string	The customer's Dub id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "customer_id"
  ],
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "The customer's Dub id."
    }
  }
}

dub_get_link

Fetch a single link by its id, its external id, or its domain plus key. Dub: GET /links/info.

read-only

Argument	Type	Description
key	string	The short key, used with domain.
domain	string	The short domain, used with key.
linkId	string	The link's Dub id.
externalId	string	Your own id for the link.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "key": {
      "type": "string",
      "description": "The short key, used with domain."
    },
    "domain": {
      "type": "string",
      "description": "The short domain, used with key."
    },
    "linkId": {
      "type": "string",
      "description": "The link's Dub id."
    },
    "externalId": {
      "type": "string",
      "description": "Your own id for the link."
    }
  }
}

dub_get_partner_analytics

Get analytics for the partner programme — clicks, leads, sales and revenue per partner. Dub: GET /partners/analytics.

read-only

Argument	Type	Description
end	string	ISO-8601 end of an absolute range.
start	string	ISO-8601 start of an absolute range.
groupBy	string	Dimension to group by, e.g. count, timeseries, top_partners.
interval	string	Relative time window. Use start/end instead for an absolute range.
partnerId	string	Only this partner.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "end": {
      "type": "string",
      "description": "ISO-8601 end of an absolute range."
    },
    "start": {
      "type": "string",
      "description": "ISO-8601 start of an absolute range."
    },
    "groupBy": {
      "type": "string",
      "description": "Dimension to group by, e.g. count, timeseries, top_partners."
    },
    "interval": {
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "1y",
        "mtd",
        "qtd",
        "ytd",
        "all"
      ],
      "type": "string",
      "description": "Relative time window. Use start/end instead for an absolute range."
    },
    "partnerId": {
      "type": "string",
      "description": "Only this partner."
    }
  }
}

dub_list_commissions

List partner commissions, by partner, status, customer or time window. Dub: GET /commissions.

read-only

Argument	Type	Description
page	integer	1-based page number.
type	string	Only commissions of this type, e.g. sale, lead, click.
status	string	Only commissions in this state.
interval	string	Relative time window. Use start/end instead for an absolute range.
pageSize	integer	Page size, 1-100.
partnerId	string	Only this partner's commissions.
customerId	string	Only commissions from this customer.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "type": {
      "type": "string",
      "description": "Only commissions of this type, e.g. sale, lead, click."
    },
    "status": {
      "type": "string",
      "description": "Only commissions in this state."
    },
    "interval": {
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "1y",
        "mtd",
        "qtd",
        "ytd",
        "all"
      ],
      "type": "string",
      "description": "Relative time window. Use start/end instead for an absolute range."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "partnerId": {
      "type": "string",
      "description": "Only this partner's commissions."
    },
    "customerId": {
      "type": "string",
      "description": "Only commissions from this customer."
    }
  }
}

dub_list_customers

List the customers Dub has attributed to links, by email, external id or link. Dub: GET /customers.

read-only

Argument	Type	Description
page	integer	1-based page number.
email	string	Only the customer with this email.
linkId	string	Only customers attributed to this link.
search	string	Free-text search.
pageSize	integer	Page size, 1-100.
externalId	string	Your own id for the customer.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "email": {
      "type": "string",
      "description": "Only the customer with this email."
    },
    "linkId": {
      "type": "string",
      "description": "Only customers attributed to this link."
    },
    "search": {
      "type": "string",
      "description": "Free-text search."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "externalId": {
      "type": "string",
      "description": "Your own id for the customer."
    }
  }
}

dub_list_domains

List the short domains configured on the workspace. Dub: GET /domains.

read-only

Argument	Type	Description
page	integer	1-based page number.
search	string	Free-text search.
archived	boolean	Include archived domains.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "search": {
      "type": "string",
      "description": "Free-text search."
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived domains."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

dub_list_events

List individual click, lead and sale events rather than aggregates — the row-level detail behind the analytics. Dub: GET /events.

read-only

Argument	Type	Description
end	string	ISO-8601 end of an absolute range.
page	integer	1-based page number.
event	string	Which event type to list.
limit	integer	Page size, 1-100.
start	string	ISO-8601 start of an absolute range.
linkId	string	Only this link's events.
interval	string	Relative time window. Use start/end instead for an absolute range.
customerId	string	Only this customer's events.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "end": {
      "type": "string",
      "description": "ISO-8601 end of an absolute range."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "event": {
      "enum": [
        "clicks",
        "leads",
        "sales"
      ],
      "type": "string",
      "description": "Which event type to list."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "start": {
      "type": "string",
      "description": "ISO-8601 start of an absolute range."
    },
    "linkId": {
      "type": "string",
      "description": "Only this link's events."
    },
    "interval": {
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "1y",
        "mtd",
        "qtd",
        "ytd",
        "all"
      ],
      "type": "string",
      "description": "Relative time window. Use start/end instead for an absolute range."
    },
    "customerId": {
      "type": "string",
      "description": "Only this customer's events."
    }
  }
}

dub_list_folders

List link folders and their access levels. Dub: GET /folders.

read-only

Argument	Type	Description
page	integer	1-based page number.
search	string	Free-text search over folder names.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "search": {
      "type": "string",
      "description": "Free-text search over folder names."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

dub_list_links

List short links, filtered by domain, tag, folder or a text search. Dub: GET /links.

read-only

Argument	Type	Description
page	integer	1-based page number.
domain	string	Only links on this short domain.
search	string	Free-text search over the key, URL and title.
folderId	string	Only links in this folder.
pageSize	integer	Page size, 1-100.
tagNames	array	Only links carrying these tag names.
showArchived	boolean	Include archived links.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "domain": {
      "type": "string",
      "description": "Only links on this short domain."
    },
    "search": {
      "type": "string",
      "description": "Free-text search over the key, URL and title."
    },
    "folderId": {
      "type": "string",
      "description": "Only links in this folder."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "tagNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only links carrying these tag names."
    },
    "showArchived": {
      "type": "boolean",
      "description": "Include archived links."
    }
  }
}

dub_list_partner_applications

List pending applications to join the partner programme. Dub: GET /partners/applications.

read-only

Argument	Type	Description
page	integer	1-based page number.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

dub_list_partners

List the partners (affiliates) in the programme, by status, country or email. Dub: GET /partners.

read-only

Argument	Type	Description
page	integer	1-based page number.
email	string	Only the partner with this email.
search	string	Free-text search.
status	string	Only partners in this state, e.g. approved, pending.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "email": {
      "type": "string",
      "description": "Only the partner with this email."
    },
    "search": {
      "type": "string",
      "description": "Free-text search."
    },
    "status": {
      "type": "string",
      "description": "Only partners in this state, e.g. approved, pending."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

dub_list_payouts

List partner payouts and their status. Dub: GET /payouts.

read-only

Argument	Type	Description
page	integer	1-based page number.
status	string	Only payouts in this state.
pageSize	integer	Page size, 1-100.
partnerId	string	Only this partner's payouts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "status": {
      "type": "string",
      "description": "Only payouts in this state."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "partnerId": {
      "type": "string",
      "description": "Only this partner's payouts."
    }
  }
}

dub_list_tags

List the tags available for organising links. Dub: GET /tags.

read-only

Argument	Type	Description
page	integer	1-based page number.
search	string	Free-text search over tag names.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "search": {
      "type": "string",
      "description": "Free-text search over tag names."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

dub_reject_partner_application

Reject an application to join the partner programme. Dub: POST /partners/applications/reject.

destructive

Argument	Type	Description
applicationId*	string	The application to reject.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "applicationId"
  ],
  "properties": {
    "applicationId": {
      "type": "string",
      "description": "The application to reject."
    }
  }
}

dub_update_link

Change a link's destination, key, tags or archived state. Dub: PATCH /links/{linkId}.

destructive

Argument	Type	Description
key	string	New short key.
url	string	New destination URL.
title	string	New preview title.
linkId*	string	The link to update.
archived	boolean	Archive or unarchive the link.
comments	string	New internal note.
tagNames	array	Replace the link's tags.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "linkId"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "New short key."
    },
    "url": {
      "type": "string",
      "description": "New destination URL."
    },
    "title": {
      "type": "string",
      "description": "New preview title."
    },
    "linkId": {
      "type": "string",
      "description": "The link to update."
    },
    "archived": {
      "type": "boolean",
      "description": "Archive or unarchive the link."
    },
    "comments": {
      "type": "string",
      "description": "New internal note."
    },
    "tagNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Replace the link's tags."
    }
  }
}