Dub.co

🚀 Unofficial Dub.co Model Context Protocol (MCP) Server

This project provides an unofficial server to interact with Dub.co services via the Model Context Protocol, facilitating AI assistants in automating short - link operations.

🚀 Quick Start

This is an unofficial Dub.co MCP server designed to integrate with Dub.co's short - link service through the Model Context Protocol (MCP). The project aims to assist AI assistants in automating the creation, update, and deletion of Dub.co short - links.

✨ Features

• Support for creating new short - links.
• Support for updating existing short - links.
• Support for deleting short - links.
• Interaction using the Dub.co API.
• Simple configuration, easy to integrate into MCP environments.

📦 Installation

Install via npm

npm install -g dubco-mcp-server-npm

Clone the repository and install dependencies

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

🔧 Configuration

Before running the server, make sure to set the DUBCO_API_KEY environment variable:

export DUBCO_API_KEY="your_api_key_here"

Create an MCP service configuration file

Create a mcp-config.json file and add the following content:

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

💻 Usage Examples

Basic Usage

create_link

Create a new short - link. 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. 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. Parameters:

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

Example:

{
  "linkId": "clwxyz123456"
}

📚 Documentation

How it Works

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

1. The server validates the input parameters.
2. Sends a request to the Dub.co API.
3. Processes the response and returns it to the AI assistant.

Development

Clone the repository

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

Install dependencies

npm install

Run tests

npm test

📄 License

[Add your license information here]

🔗 Links

• Dub.co Official Website
• Model Context Protocol (MCP) Documentation

🤝 Contribution Guidelines

Contributions are welcome! Please refer to the CONTRIBUTING.md file in the project repository.

📋 Creator Information

Creator: [Your name or team name] Contact Information: [Your email address or other contact details]

This project aims to provide a flexible and easy - to - use MCP server for Dub.co, helping developers manage short - links more efficiently.

⚠️ Important Note

This is an unofficial project for interacting with Dub.co services via the Model Context Protocol. It is not supported by Dub.co or its affiliated companies.