Navigation
Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts - MCP Implementation

Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts

Dive into seamless AI-driven Dub.co link management—create, update, or wipe short URLs on the fly with MCP tools. No messy code, just crisp automation. Your shortcuts, supercharged." )

Developer Tools
4.4(106 reviews)
159 saves
74 comments

Ranked in the top 8% of all AI tools in its category

About Unofficial dubco-mcp-server

What is Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts?

This tool bridges the Dub.co URL shortening service with AI assistants via the Model Context Protocol (MCP). It lets developers automate short link creation, updates, and deletions by exposing Dub.co's API as structured tools for AI integration. Think of it as a middleware layer that translates AI requests into actionable API calls — no manual dashboard interactions required.

How to Use Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts?

Start by installing the package globally with npm install -g dubco-mcp-server. Next, set your Dub.co API key as an environment variable. For Cursor IDE users, configure the server through its MCP settings panel by specifying the command with your API key embedded. Once activated, you can instruct AI agents to:

  • Create links with create_link {url: "https://example.com", key: "my-slug"}
  • Update existing links using their linkId
  • Delete links by referencing their unique identifiers

Unofficial dubco-mcp-server Features

Key Features of Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts?

This server provides three core capabilities:

Create

Generate short links with custom slugs and domain assignments

Update

Edit existing links' destinations, domains, or slugs

Delete

Permanently remove links via their ID

MCP Integration

Seamless tooling for AI agents using standardized request formats

Use Cases of Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts?

Common scenarios include:

  • Automating social media campaigns with dynamic short links
  • Building link management dashboards for content teams
  • Creating trackable links for A/B testing campaigns
  • Integrating shortening into chatbots for quick URL sharing

Unofficial dubco-mcp-server FAQ

FAQ from Unofficial dubco-mcp-server: Link Automation & Smart Shortcuts?

Why do I get "Unauthorized" errors?

Double-check your API key placement in environment variables and command configurations. The key must be set globally or explicitly passed in the server command.

Can I use this without Cursor IDE?

Yes - any MCP-compatible AI framework can use this server through standard API requests. See the MCP documentation for implementation details.

What happens if my API key expires?

You'll need to regenerate it from the Dub.co dashboard and update your environment variables accordingly.

Content

Unofficial dubco-mcp-server

npm version License: ISC Node.js Version

A Model Context Protocol (MCP) server for creating and managing Dub.co short links (unofficial). This server enables AI assistants to create, update, and delete short links through the Dub.co API.

🚀 Features

  • Create custom short links with your Dub.co domains
  • Update existing short links
  • Delete short links
  • Seamless integration with AI assistants through the Model Context Protocol

📋 Prerequisites

  • Node.js 16.0.0 or higher
  • A Dub.co account with API access
  • An API key from the Dub.co dashboard

💻 Installation

Global Installation

npm install -g dubco-mcp-server

Local Installation

npm install dubco-mcp-server

Direct Usage with npx

npx dubco-mcp-server

⚙️ Configuration

This MCP server requires a Dub.co API key to function. You can get your API key from the Dub.co dashboard.

Set the API key as an environment variable:

export DUBCO_API_KEY=your_api_key_here

For persistent configuration, add this to your shell profile (e.g., .bashrc, .zshrc):

echo 'export DUBCO_API_KEY=your_api_key_here' >> ~/.zshrc

🖥️ Cursor IDE Setup

Cursor IDE provides native support for MCP servers. Follow these steps to set up the dubco-mcp-server in Cursor:

Step 1: Install Cursor IDE

If you haven't already, download and install Cursor IDE (version 0.4.5.9 or later).

Step 2: Open Cursor Settings

  1. Open Cursor IDE
  2. Click on the gear icon in the bottom left corner, or use the keyboard shortcut Cmd+, (Mac) or Ctrl+, (Windows/Linux)
  3. Navigate to the Features section
  4. Scroll down to find the "MCP Servers" section

Step 3: Add the MCP Server

  1. Click on "+ Add new MCP server"
  2. In the dialog that appears:
    * Name : Enter "Dub.co MCP Server" (or any name you prefer)
    * Type : Select "command" from the dropdown
    * Command : Enter env DUBCO_API_KEY=your_api_key_here npx -y dubco-mcp-server (Replace your_api_key_here with your actual Dub.co API key)
  3. Click "Save" to add the server

Step 4: Verify the Connection

After adding the MCP server, you should see a green status indicator next to the server name. If it shows a red or yellow status, try:

  1. Checking that your API key is correct
  2. Restarting Cursor IDE
  3. Verifying that Node.js (16.0.0+) is properly installed

Step 5: Using the Server

The dubco-mcp-server provides tools that can be used with Cursor's AI features:

  1. Open Cursor's Composer or Agent mode (MCP only works in these modes)
  2. Explicitly instruct the AI to use the Dub.co tools (create_link, update_link, delete_link)
  3. Accept the tool usage prompts when they appear

🔧 Usage with MCP

This server provides tools that can be used by AI assistants through the Model Context Protocol. To use it with an MCP-compatible AI assistant, add it to your MCP configuration.

MCP Configuration Example

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

Available Tools

create_link

Create a new short link on Dub.co.

Parameters:

{
  "url": "https://example.com",
  "key": "optional-custom-slug",
  "externalId": "optional-external-id",
  "domain": "optional-domain-slug"
}

Example:

{
  "url": "https://github.com/gitmaxd/dubco-mcp-server-npm",
  "key": "dubco-mcp"
}

update_link

Update an existing short link on Dub.co.

Parameters:

{
  "linkId": "link-id-to-update",
  "url": "https://new-destination.com",
  "domain": "new-domain-slug",
  "key": "new-custom-slug"
}

Example:

{
  "linkId": "clwxyz123456",
  "url": "https://github.com/gitmaxd/dubco-mcp-server-npm/releases"
}

delete_link

Delete a short link on Dub.co.

Parameters:

{
  "linkId": "link-id-to-delete"
}

Example:

{
  "linkId": "clwxyz123456"
}

🔍 How It Works

The server connects to the Dub.co API using your API key and provides a standardized interface for AI assistants to interact with Dub.co through the Model Context Protocol. When a tool is called:

  1. The server validates the input parameters
  2. It sends the appropriate request to the Dub.co API
  3. It processes the response and returns it in a format that the AI assistant can understand

🛠️ Development

Building from Source

git clone https://github.com/gitmaxd/dubco-mcp-server-npm.git
cd dubco-mcp-server-npm
npm install
npm run build

Running in Development Mode

npm run dev

📝 License

This project is licensed under the ISC License - see the LICENSE file for details.

🔗 Links

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

👨‍💻 Created By

This unofficial Dub.co MCP Server was created by GitMaxd (@gitmaxd on X).

This project was developed as a learning exercise to understand the Model Context Protocol and how to build MCP servers. I chose Dub.co as the integration target because of its straightforward API and practical utility, making it an ideal candidate for a learning project.

While I have no official affiliation with Dub.co, I highly recommend their service for both manual and automated short link creation. Their API is well-documented and easy to work with, making it perfect for this kind of integration.

If you find this project helpful or have suggestions for improvements, feel free to reach out or contribute to the repository. Happy link shortening!

Related MCP Servers & Clients