Linkly MCP Server

An MCP (Model Context Protocol) server that allows AI assistants like Claude and ChatGPT to create and manage short links, track clicks, and automate URL management.

About Linkly

Linkly is a powerful link management platform that lets you create branded short links, track clicks in real-time, and optimize your marketing campaigns. Features include custom domains, UTM parameters, retargeting pixels, QR codes, and detailed analytics.

Features

Link Management

• create_link - Create new short links with full customization (UTM params, pixels, Open Graph, etc.)
• update_link - Update existing links
• delete_link - Delete links
• get_link - Get details of a specific link
• list_links - List all links in the workspace with click statistics
• search_links - Search links by name, URL, or note

Analytics

• get_clicks - Get recent click data
• get_analytics - Get time-series click data for charting (daily/hourly)
• get_analytics_by - Get click counts grouped by dimension (country, platform, browser, etc.)
• export_clicks - Export detailed click records

Domain Management

• list_domains - List all custom domains in the workspace
• create_domain - Add a custom domain
• delete_domain - Remove a custom domain

Webhook Management

• list_webhooks - List workspace-level webhook subscriptions
• subscribe_webhook - Subscribe a URL to receive click events for all links
• unsubscribe_webhook - Unsubscribe a webhook URL
• list_link_webhooks - List webhooks for a specific link
• subscribe_link_webhook - Subscribe a URL to a specific link's click events
• unsubscribe_link_webhook - Unsubscribe from a link's click events

Installation

cd integrations/mcp-server
npm install

Configuration

Set the following environment variables:

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

You can find these at Settings → API in your Linkly dashboard.

Quick Start with Claude Desktop

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

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

For detailed setup instructions and usage examples, see the Claude Desktop Setup Guide.

Quick Start with ChatGPT

You can use Linkly with ChatGPT by creating a Custom GPT with Actions. This allows you to manage short links directly in ChatGPT conversations.

For step-by-step instructions, see the ChatGPT Setup Guide.

Usage with Claude Code

Add to your Claude Code MCP settings:

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

Available Tools

create_link

Create a new short link.

Required parameters:

• url - The destination URL

Optional parameters:

• name - Nickname for the link
• note - Private note
• domain - Custom domain
• slug - Custom slug (must start with /)
• enabled - Whether link is active (default: true)
• utm_source, utm_medium, utm_campaign, utm_term, utm_content - UTM parameters
• og_title, og_description, og_image - Open Graph metadata
• fb_pixel_id - Meta/Facebook Pixel ID
• ga4_tag_id - Google Analytics 4 tag ID
• gtm_id - Google Tag Manager ID
• cloaking - Hide destination URL in iframe
• forward_params - Forward URL parameters to destination
• block_bots - Block bots and spiders
• hide_referrer - Hide referrer information
• expiry_datetime - When the link expires (ISO 8601)
• expiry_destination - Fallback URL after expiry

update_link

Update an existing link.

Required parameters:

• link_id - The ID of the link to update

All other parameters from create_link are optional.

delete_link

Delete a link.

Required parameters:

• link_id - The ID of the link to delete

get_link

Get details of a specific link.

Required parameters:

• link_id - The ID of the link to retrieve

list_links

List all links in the workspace. No parameters required.

get_clicks

Get recent click data.

Optional parameters:

• link_id - Filter clicks by link ID

get_analytics

Get time-series click analytics data for charting.

Optional parameters:

• start - Start date (YYYY-MM-DD, default: 30 days ago)
• end - End date (YYYY-MM-DD, default: today)
• link_id - Filter by specific link
• frequency - Time granularity: day (default) or hour
• country - Filter by country code (e.g., 'US', 'GB')
• platform - Filter by platform (desktop, mobile, tablet)
• browser - Filter by browser name
• unique - Count unique clicks only (by IP)
• bots - Bot filtering: include (default), exclude, or only

get_analytics_by

Get click counts grouped by a dimension. Useful for breakdowns and top-N reports.

Required parameters:

• counter - Dimension to group by: country, platform, browser_name, referer, isp, link_id, destination, bot_name

Optional parameters:

• start - Start date (YYYY-MM-DD)
• end - End date (YYYY-MM-DD)
• link_id - Filter by specific link
• country - Filter by country code
• platform - Filter by platform
• unique - Count unique clicks only
• bots - Bot filtering

export_clicks

Export detailed click records with full information.

Optional parameters:

• start - Start date (YYYY-MM-DD, default: 30 days ago)
• end - End date (YYYY-MM-DD, default: yesterday)
• link_id - Filter by specific link
• country - Filter by country code
• platform - Filter by platform
• bots - Bot filtering

Returns: Array of click records with timestamp, browser, country, URL, link_id, platform, referer, bot, ISP, and params.

search_links

Search for links by name, URL, or note.

Required parameters:

• query - Search string to match against link names, URLs, and notes

list_domains

List all custom domains in the workspace. No parameters required.

create_domain

Add a custom domain to the workspace.

Required parameters:

• name - The domain name (e.g., 'links.example.com')

delete_domain

Remove a custom domain from the workspace.

Required parameters:

• domain_id - The ID of the domain to delete

list_webhooks

List all webhook URLs subscribed to the workspace. No parameters required.

subscribe_webhook

Subscribe a webhook URL to receive click events for all links.

Required parameters:

• url - The webhook URL to receive click event notifications

unsubscribe_webhook

Unsubscribe a webhook URL from workspace click events.

Required parameters:

• url - The webhook URL to unsubscribe

list_link_webhooks

List all webhook URLs subscribed to a specific link.

Required parameters:

• link_id - The ID of the link

subscribe_link_webhook

Subscribe a webhook URL to receive click events for a specific link.

Required parameters:

• link_id - The ID of the link
• url - The webhook URL to receive click event notifications

unsubscribe_link_webhook

Unsubscribe a webhook URL from a specific link's click events.

Required parameters:

• link_id - The ID of the link
• url - The webhook URL to unsubscribe

License

MIT