Linkly-HQ/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
Claude Code (CLI)
ChatGPT Desktop
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.
Publishing to the MCP Registry (maintainers)
The server.json at the repo root is the official MCP Registry manifest for the com.linklyhq/linkly server. It is **remote-only**: it points clients at the hosted server and intentionally ships no package (the deprecated npm distribution was dropped in v2.0.0).
Publishing requires DNS access to linklyhq.com — the com.linklyhq namespace is verified via a DNS TXT record on the domain apex:
See the registry authentication guide for details.