Dwz

You can manage short URLs for AI assistants using an MCP server that communicates with a dedicated short URL service. This MCP server provides creation, retrieval, listing, batch operations, and domain management for short URLs, along with robust authentication and error handling to keep your workflows smooth.

How to use

To use this MCP server, connect your MCP client to either the remote HTTP endpoint or the local MCP process. You can create individual short URLs with optional custom codes, fetch detailed information about a short URL, list and search through your URLs, delete URLs you no longer need, batch-create multiple URLs, and retrieve the list of available domains. All actions are performed through the MCP client using the provided tools, and you can monitor statistics and ensure secure access with API keys.

Typical use patterns include creating a short URL with a custom domain and code, fetching details for a specific short URL by its ID, listing URLs with pagination and domain filter, and performing batch creation to accelerate setup. You will also be able to list domains to understand which domains you can publish under and access click statistics to gauge engagement.

How to install

Prerequisites You need Node.js version 18.0.0 or newer and either npm or yarn installed on your machine.

Install and set up the MCP client Start by installing dependencies and configuring environment variables for the MCP client.

# Install dependencies
npm install

# Copy environment variable template
cp .env.example .env

# Edit the .env file to configure connection details

Run in development or production

Development mode runs with hot reload to help you iterate quickly while building your MCP integrations.

# Development mode
npm run dev

Production mode starts the optimized server for steady operation.

npm start

Available tools

create_short_url

Create a new short URL with required original URL, domain, and title, with optional custom code and description.

get_url_info

Retrieve detailed information about a short URL by its ID.

list_short_urls

List short URLs with pagination and optional domain and keyword filters.

delete_short_url

Delete a short URL by its ID.

batch_create_short_urls

Batch create multiple short URLs under a single domain.

list_domains

Retrieve a list of all available short URL domains.