Clypt MCP Server

An MCP (Model Context Protocol) server that connects AI assistants to Clypt — the AI-Powered Link Intelligence platform. Shorten links, view analytics, manage tags and folders, all from Claude, ChatGPT, Cursor, or any MCP-compatible client.

Quick Start

npx clypt-mcp

You'll need a Clypt API key. Get one at clypt.io/dashboard/settings.

Installation

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "clypt-mcp"],
      "env": {
        "CLYPT_API_KEY": "clypt_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "clypt-mcp"],
      "env": {
        "CLYPT_API_KEY": "clypt_your_key_here"
      }
    }
  }
}

Global Install

npm install -g clypt-mcp
CLYPT_API_KEY=clypt_your_key_here clypt-mcp

Environment Variables

Variable	Required	Default	Description
`CLYPT_API_KEY`	Yes	-	Your Clypt API key
`CLYPT_BASE_URL`	No	`https://clypt.io`	Custom API base URL

Available Tools

`shorten_link`

Create a shortened Clypt link.

url (required) — The URL to shorten
slug — Custom short code
tags — Tags to attach
expiresAt — Expiration date (ISO 8601)
password — Password protection
folderId — Folder to organize into

`list_links`

List your shortened links with search and filtering.

search — Search by URL, title, or short code
tag — Filter by tag
limit — Results per page (max 100)
offset — Pagination offset

`get_link_analytics`

Get click analytics for a specific link.

linkId (required) — Link ID or short code
period — Time period: 7d, 30d, 90d, or all

`get_dashboard_stats`

Get high-level dashboard statistics (total links, clicks, top performers). No parameters required.

`generate_qr_code`

Generate a QR code for any URL.

url (required) — URL to encode
size — Size in pixels (100-1000)
fgColor — Foreground hex color
bgColor — Background hex color

`manage_tags`

Create or list tags.

action (required) — create or list
name — Tag name (for create)
color — Tag color hex (for create)

`manage_folders`

Create or list folders.

action (required) — create or list
name — Folder name (for create)
parentId — Parent folder ID (for create)

`bulk_shorten`

Shorten multiple URLs at once (max 25).

urls (required) — Array of URLs
tags — Tags for all links
folderId — Folder for all links

`delete_link`

Delete a link by ID.

linkId (required) — Link ID to delete

Example Usage

Once configured, you can ask your AI assistant things like:

"Shorten https://example.com/my-long-article-url with the tag 'marketing'"

"Show me analytics for my top links this month"

"Create a QR code for clypt.io/abc123"

"List all my links tagged 'campaign-q1'"

"Bulk shorten these 5 URLs for our newsletter"

Development

git clone https://github.com/Bonsai-Tech-LLC/clypt-mcp.git
cd clypt-mcp
npm install
npm run build
CLYPT_API_KEY=your_key node dist/index.js

License

MIT - See LICENSE for details.

clypt

Quick Install