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

Links

• Linkly Website
• Documentation
• API Reference
• GitHub Repository

Support

For help and support, visit Linkly Support or email support@linklyhq.com.

License

MIT