You can manage Dub.co short links programmatically from your AI workflows. This MCP server exposes create, update, upsert, and delete operations for short links, with automatic domain handling and straightforward configuration so your agents can interact with the Dub.co API securely and efficiently.

How to use

Use the server with an MCP client to perform link operations from your AI agents. You can create new short links with custom slugs, update existing ones, upsert (create or update) links, and delete links. Your MCP client will invoke the available tools to send the necessary data to the server, which then communicates with your Dub.co account via the API key you provide.

How to install

Prerequisites you must have before installing.

Node.js 18 or higher is required.

A Dub.co account with API access and an API key.

Option 1: Install via NPM (Recommended)

npm install -g dubco-mcp-server

Then configure your MCP server as shown below.

## Option 2: Clone and Build

If you prefer to build from source, follow these steps.

Clone the repository

git clone https://github.com/Gitmaxd/dubco-mcp-server.git cd dubco-mcp-server

Install dependencies

npm install

Build the project

npm run build

After building, configure your MCP server to point to the built index.

Configuration examples

Add one or both MCP server configurations to your MCP setup. The examples assume you have an API key from Dub.co.

{
  "mcpServers": {
    "dubco-mcp": {
      "command": "dubco-mcp-server",
      "env": {
        "DUBCO_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Alternatively, if you build from source locally, use the built index as the entry point.

## Environment variables

The following environment variable is required to authorize requests to Dub.co.

DUBCO_API_KEY=your_api_key_here

Provide this value securely in your MCP configuration. Do not share it publicly.

Usage details for tools

The MCP server exposes the following tools to your AI agents. Each tool accepts a specific payload to perform operations on your Dub.co account.

• create_link creates a new short link with an optional slug, domain, and external identifier.

• update_link updates an existing short link by its ID, with optional new URL, domain, or slug.

• upsert_link creates or updates a short link in one operation using the provided details.

• delete_link deletes a short link by its ID.

Security notes

Keep your API key secure. Store it in environment variables or a secrets manager and restrict access to the MCP runtime. Rotate keys periodically and monitor usage for unusual activity.

Examples of common flows

Create a short link when you need a new branded URL for a campaign, update a slug to reflect a rebranding, or delete a retired link. Your MCP client can orchestrate these actions as part of larger automation tasks.

Available tools

create_link

Create a new short link on Dub.co with optional slug, domain, and externalId.

update_link

Update an existing short link identified by linkId with new URL, domain, or slug.

upsert_link

Create a new short link or update an existing one based on the provided data.

delete_link

Delete an existing short link by its linkId.