Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Linkly MCP Servercreate a short link for our new product launch page"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Or run directly with npx:
Configuration
Set the required environment variables:
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):
Available Tools
Tool | Description |
| Create a new short link |
| Update an existing link |
| Delete a link |
| Get link details |
| List all links in workspace |
| Search links by name, URL, or note |
| Get time-series click data |
| Get clicks grouped by dimension |
| Get recent click data |
| Export detailed click records |
| List custom domains |
| Add a custom domain |
| Remove a custom domain |
| Update domain favicon |
| List workspace webhooks |
| Add a webhook |
| Remove a webhook |
| List link-specific webhooks |
| Add a link webhook |
| Remove a link webhook |
Links
Support
For help and support, visit Linkly Support or email support@linklyhq.com.
License
MIT