{
  "markdown": "# Clypt MCP Server\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that connects AI assistants to [Clypt](https://clypt.io) — the AI-Powered Link Intelligence platform. Shorten links, view analytics, manage tags and folders, all from Claude, ChatGPT, Cursor, or any MCP-compatible client.\n\n## Quick Start\n\n```bash\nnpx clypt-mcp\n```\n\nYou'll need a Clypt API key. Get one at [clypt.io/dashboard/settings](https://clypt.io/dashboard/settings).\n\n## Installation\n\n### Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"clypt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clypt-mcp\"],\n      \"env\": {\n        \"CLYPT_API_KEY\": \"clypt_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your Cursor MCP settings (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"clypt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clypt-mcp\"],\n      \"env\": {\n        \"CLYPT_API_KEY\": \"clypt_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Global Install\n\n```bash\nnpm install -g clypt-mcp\nCLYPT_API_KEY=clypt_your_key_here clypt-mcp\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CLYPT_API_KEY` | Yes | - | Your Clypt API key |\n| `CLYPT_BASE_URL` | No | `https://clypt.io` | Custom API base URL |\n\n## Available Tools\n\n### `shorten_link`\nCreate a shortened Clypt link.\n- `url` (required) — The URL to shorten\n- `slug` — Custom short code\n- `tags` — Tags to attach\n- `expiresAt` — Expiration date (ISO 8601)\n- `password` — Password protection\n- `folderId` — Folder to organize into\n\n### `list_links`\nList your shortened links with search and filtering.\n- `search` — Search by URL, title, or short code\n- `tag` — Filter by tag\n- `limit` — Results per page (max 100)\n- `offset` — Pagination offset\n\n### `get_link_analytics`\nGet click analytics for a specific link.\n- `linkId` (required) — Link ID or short code\n- `period` — Time period: `7d`, `30d`, `90d`, or `all`\n\n### `get_dashboard_stats`\nGet high-level dashboard statistics (total links, clicks, top performers). No parameters required.\n\n### `generate_qr_code`\nGenerate a QR code for any URL.\n- `url` (required) — URL to encode\n- `size` — Size in pixels (100-1000)\n- `fgColor` — Foreground hex color\n- `bgColor` — Background hex color\n\n### `manage_tags`\nCreate or list tags.\n- `action` (required) — `create` or `list`\n- `name` — Tag name (for create)\n- `color` — Tag color hex (for create)\n\n### `manage_folders`\nCreate or list folders.\n- `action` (required) — `create` or `list`\n- `name` — Folder name (for create)\n- `parentId` — Parent folder ID (for create)\n\n### `bulk_shorten`\nShorten multiple URLs at once (max 25).\n- `urls` (required) — Array of URLs\n- `tags` — Tags for all links\n- `folderId` — Folder for all links\n\n### `delete_link`\nDelete a link by ID.\n- `linkId` (required) — Link ID to delete\n\n### `create_ab_test`\nCreate an A/B split test on a link (Pro plan or above).\n- `linkId` (required) — The link ID to test\n- `variants` (required) — Array of 2–5 variants, each with `url`, optional `label`, and `weight` (weights must sum to 100)\n\n### `get_ab_test_results`\nGet A/B test results including per-variant clicks, statistical significance (chi-square), and winner recommendation.\n- `linkId` (required) — The link ID\n\n### `end_ab_test`\nEnd an active A/B test. The link reverts to its original URL. Test data is preserved.\n- `linkId` (required) — The link ID\n\n### `promote_ab_test_winner`\nPromote a winning variant as the sole destination URL and end the test.\n- `linkId` (required) — The link ID\n- `variantId` (required) — The variant ID to promote\n\n### `generate_ai_qr_code`\nGenerate an AI artistic QR code using Stable Diffusion + ControlNet (Pro plan or above).\n- `linkId` (required) — The link ID to generate for\n- `prompt` — Text prompt describing the desired art style\n- `style` — Preset style: `watercolor`, `oil_painting`, `cyberpunk`, `minimal`, `japanese`, `nature`, `abstract`, `geometric`\n\n## Example Usage\n\nOnce configured, you can ask your AI assistant things like:\n\n> \"Shorten https://example.com/my-long-article-url with the tag 'marketing'\"\n\n> \"Show me analytics for my top links this month\"\n\n> \"Create a QR code for clypt.io/abc123\"\n\n> \"List all my links tagged 'campaign-q1'\"\n\n> \"Bulk shorten these 5 URLs for our newsletter\"\n\n> \"Set up a 50/50 A/B test on my landing page link with the new design vs the old one\"\n\n> \"Check the A/B test results — is there a winner yet?\"\n\n> \"Promote the winning variant and end the test\"\n\n## Development\n\n```bash\ngit clone https://github.com/Bonsai-Tech-LLC/clypt-mcp.git\ncd clypt-mcp\nnpm install\nnpm run build\nCLYPT_API_KEY=your_key node dist/index.js\n```\n\n## License\n\nMIT - See [LICENSE](LICENSE) for details.\n\n## Links\n\n- [Clypt](https://clypt.io) — AI-Powered Link Intelligence\n- [Clypt API Docs](https://clypt.io/api/v1/docs)\n- [MCP Protocol](https://modelcontextprotocol.io)\n- [Report Issues](https://github.com/Bonsai-Tech-LLC/clypt-mcp/issues)\n",
  "bytes": 5078,
  "sha": "2b55f065f3ce4bcfddd183f016581cd5c9ed9e736c1a60071cd9883846719e09",
  "repo_slug": "bonsai-tech-llc/clypt-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bonsai_tech_llc_clypt_d78c0c6e/readme"
}