MCP 服务器

Linkly MCP Server

Enables interaction with Linkly's URL shortener and link management platform. Supports creating and managing short links, viewing analytics, configuring custom domains and webhooks, and exporting click data.

README

Linkly MCP Server

Official Model Context Protocol (MCP) server for Linkly - the URL shortener and link management platform.

Documentation

For full documentation, setup guides, and examples, visit: https://linklyhq.com/support/mcp-server

Features

Create, update, and delete short links
View click analytics and statistics
Manage custom domains and favicons
Configure webhooks for click events
Search and filter links
Export click data

Two Ways to Use

Option 1: Hosted Server (Recommended)

Use Linkly's hosted MCP server with OAuth authentication. No installation required.

Server URL: https://mcp.linklyhq.com

This is the easiest way to get started - just connect your MCP client to the hosted server and authenticate with your Linkly account.

Option 2: Self-Hosted (npm)

Run your own instance using your API key.

Installation

npm install -g linkly-mcp-server

Or run directly with npx:

npx linkly-mcp-server

Configuration

Set the required environment variables:

export LINKLY_API_KEY="your-api-key"
export LINKLY_WORKSPACE_ID="your-workspace-id"

You can find these in your Linkly dashboard under Settings > API.

Usage with Claude Desktop

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

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Available Tools

Tool	Description
`create_link`	Create a new short link
`update_link`	Update an existing link
`delete_link`	Delete a link
`get_link`	Get link details
`list_links`	List all links in workspace
`search_links`	Search links by name, URL, or note
`get_analytics`	Get time-series click data
`get_analytics_by`	Get clicks grouped by dimension
`get_clicks`	Get recent click data
`export_clicks`	Export detailed click records
`list_domains`	List custom domains
`create_domain`	Add a custom domain
`delete_domain`	Remove a custom domain
`update_domain_favicon`	Update domain favicon
`list_webhooks`	List workspace webhooks
`subscribe_webhook`	Add a webhook
`unsubscribe_webhook`	Remove a webhook
`list_link_webhooks`	List link-specific webhooks
`subscribe_link_webhook`	Add a link webhook
`unsubscribe_link_webhook`	Remove a link webhook