MCP Integration
Overview
Connect AI agents to Shorten using the Model Context Protocol.
Shorten provides a native Model Context Protocol (MCP) server. Any MCP-compatible client — Claude Desktop, Claude Code, Cursor, or custom agents — can create links, query analytics, and manage your link infrastructure through natural language.
Available tools
| Tool | Description | Required scope |
|---|---|---|
create_short_link | Create a new shortened link | write |
bulk_create_links | Create multiple links in one request | write |
list_links | List and search existing links | read |
get_analytics | Retrieve click analytics | read |
revoke_link | Permanently revoke a link | write |
generate_qr | Generate a QR code for a link | read |
An API key with read + write scopes covers all tools.
Quick setup
Add the Shorten MCP server to your client configuration:
{
"mcpServers": {
"shorten": {
"command": "npx",
"args": ["@shorten-dev/mcp"],
"env": {
"SHORTEN_API_KEY": "sk_your_key_here"
}
}
}
}Requires an API key (sk_) with read + write scopes. See Authentication for details.