A Model Context Protocol (MCP) server that provides AI agents with the ability to shorten URLs using Kutt.it - the modern, open-source URL shortener.

┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│   AI Agent      │ ──── │   Kutt MCP      │ ──── │   Kutt.it API   │
│  (Claude, etc)  │ MCP  │   Server        │ HTTP │                 │
└─────────────────┘      └─────────────────┘      └─────────────────┘

• Full Kutt API Coverage - Create, list, update, and delete short links
• Link Analytics - Get detailed statistics on link visits
• Custom Domains - Manage your own branded short domains
• Password Protection - Create secure, password-protected links
• Link Expiration - Set automatic expiry times
• n8n Compatible - Middleware handles extra args from n8n MCP client

docker run -d \
  -p 8000:8000 \
  -e KUTT_API_KEY=your-api-key \
  ghcr.io/OWNER/kutt-mcp:latest

# Copy environment template
cp .env.example .env

# Edit .env with your API key
vim .env

# Start the server
docker compose up -d

# Install dependencies
uv sync

# Set your API key
export KUTT_API_KEY=your-api-key

# Run the server
uv run python server.py

Get your API key from kutt.it/settings or your self-hosted instance.

{
  "tool": "create_link",
  "arguments": {
    "target": "https://example.com/very/long/url",
    "customurl": "my-link",
    "description": "My awesome link",
    "expire_in": "7 days"
  }
}

{
  "tool": "get_link_stats",
  "arguments": {
    "link_id": "uuid-of-your-link"
  }
}

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "kutt": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Use the MCP Client node with:

• Transport: HTTP
• URL: http://your-server:8000/mcp

If you're running your own Kutt instance, just point to your API:

KUTT_BASE_URL=https://your-kutt-instance.com/api/v2

# Clone the repo
git clone https://github.com/OWNER/kutt-mcp.git
cd kutt-mcp

# Install dependencies
uv sync

# Run locally
uv run python server.py

MIT