Linkly MCP Server

The Linkly MCP Server lets you connect AI assistants to your Linkly account using the Model Context Protocol. Once connected, you can create and manage short links through natural conversation.

The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely connect to external tools and data sources. Instead of copying and pasting between apps, you can ask your AI assistant to perform actions directly.

The Linkly MCP Server works with:

• Claude Desktop
• ChatGPT Desktop
• Other MCP-compatible clients (Cursor, Windsurf, etc.)

Once connected, you can ask your AI assistant to:

• Create short links - "Create a short link for https://example.com"
• Track performance - "How many clicks did my links get this week?"
• Manage links - "Update the link called 'promo' with a new destination"
• View analytics - "Show me clicks by country for the last 30 days"
• Search links - "Find all links related to the product launch"
• Manage domains - "List my custom domains"
• Set up webhooks - "Subscribe https://my-site.com/webhook to receive click events"

The hosted Linkly MCP Server lives at https://mcp.linklyhq.com. There is nothing to install and no API key to copy — the server uses OAuth, so the first time your AI assistant connects, a browser window opens asking you to sign in to Linkly and approve access. After that, your assistant stays connected.

https://mcp.linklyhq.com

Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Linkly MCP server:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Restart Claude Desktop. The first time you use a Linkly tool, a browser tab opens for you to sign in and approve access.

Claude Code supports remote MCP servers natively. Add Linkly with one command:

claude mcp add --transport http linkly https://mcp.linklyhq.com

Then run /mcp inside Claude Code, pick linkly, and authorize in the browser when prompted.

Open your ChatGPT config file:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Add the Linkly MCP server:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

When creating links, you can specify:

• Basic: url, name, note, domain, slug, enabled
• UTM Parameters: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph: og_title, og_description, og_image
• Tracking: fb_pixel_id, ga4_tag_id, gtm_id
• Advanced: cloaking, forward_params, block_bots, hide_referrer
• Expiry: expiry_datetime, expiry_destination

• Confirm https://mcp.linklyhq.com is reachable from your machine
• If your client uses mcp-remote, make sure Node.js v18 or later is installed
• In Claude Code, run /mcp and pick linkly to re-trigger the OAuth flow

Clear your client's cached MCP credentials and re-authorize. In Claude Code, run /mcp → linkly → reconnect. In Claude Desktop, quit the app, delete the cached mcp-remote token in ~/.mcp-auth/, then restart.

• Restart your AI assistant after saving the configuration
• Check that the JSON syntax in your config file is valid
• Verify the MCP server is running (check for the tools icon in your assistant)

• Claude Desktop Integration
• ChatGPT Integration
• Linkly API Documentation
• Webhooks
• Model Context Protocol