Gitmaxd Dubco MCP Server

🚀 Dub.co MCP Server

An MCP server for interacting with the dub.co link shortening service API. This server allows AI agents to create, update, and manage short links through your Dub.co account.

✨ Features

• Create short links with custom slugs
• Update existing short links
• Upsert links (create or update)
• Delete links
• Automatically select domains

📦 Installation

Prerequisites

• Node.js 18 or higher
• A Dub.co account with API access
• An API key obtained from Dub.co

Recommended Installation: Via NPM

npm install -g dubco-mcp-server

Then add the following to your MCP configuration:

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

Alternative Installation: Clone and Build

# 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

Then add the following to your MCP configuration:

{
  "mcpServers": {
    "dubco-server": {
      "command": "node",
      "args": ["/path/to/dubco-mcp-server/build/index.js"],
      "env": {
        "DUBCO_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Obtaining a Dub.co API Key

1. Log in to your Dub.co account.
2. Go to the workspace settings.
3. Navigate to the "API" section.
4. Generate a new API key.

💻 Usage Examples

Basic Usage

After installation, the MCP server provides the following tools for AI agents:

create_link

Create a new short link on dub.co.

{
  "url": "https://example.com",
  "key": "example",  // Optional
  "domain": "your-domain.com",  // Optional
  "externalId": "123"  // Optional
}

update_link

Update an existing short link.

{
  "linkId": "link_id_here",
  "url": "https://new-example.com",  // Optional
  "domain": "new-domain.com",  // Optional
  "key": "new-slug"  // Optional
}

upsert_link

Create or update a short link on dub.co.

{
  "url": "https://example.com",
  "key": "example",  // Optional
  "domain": "your-domain.com",  // Optional
  "externalId": "123"  // Optional
}

delete_link

Delete a short link on dub.co.

{
  "linkId": "link_id_here"
}

📄 License

This project is licensed under the MIT License.