Linkly MCP Server

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

This repository powers the hosted MCP server at https://mcp.linklyhq.com. That is the only supported way to connect an AI assistant to Linkly via MCP. See https://linklyhq.com/support/mcp-server for setup instructions.

⚠️ The linkly-mcp-server npm package is deprecated. The self-hosted / API-key flow is no longer maintained. All users should migrate to the hosted server — it uses OAuth 2.1 with PKCE, requires no API keys or local install, and always runs the latest tool set. The npm package will continue to exist on the registry for backwards compatibility but will not receive new tools or bug fixes, and may be unpublished in the future.

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

Using the hosted server

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

Connect your MCP client to the hosted server and sign in to Linkly when your browser opens. That's it — no API keys, no installation, no config drift.

Claude Desktop

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

Claude Code (CLI)

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

ChatGPT Desktop

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

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