linkbit-mcp

MCP server for LinkBit: shorten links, bulk create, QR codes, and click analytics from Claude, ChatGPT, Cursor, and n8n.

Public docs: linkbit.live/docs · linkbit.live/mcp

Setup

Sign in at linkbit.live and create an API key (slk_...) on the API Keys page.
Node.js 18+ is required (fetch).

Code

APP_URL=https://linkbit.live
API_KEY=slk_your_key

Auth against the REST API uses either Authorization: Bearer slk_... or x-api-key: slk_.... This server sends Bearer.

Install

Terminal

npx -y linkbit-mcp

Claude Code:

Terminal

claude mcp add linkbit -e API_KEY=slk_your_key -e APP_URL=https://linkbit.live -- npx -y linkbit-mcp

Claude Desktop / Cursor (mcp.json):

config.json

{
  "mcpServers": {
    "linkbit": {
      "command": "npx",
      "args": ["-y", "linkbit-mcp"],
      "env": {
        "APP_URL": "https://linkbit.live",
        "API_KEY": "slk_your_key"
      }
    }
  }
}

Example prompts

Shorten https://example.com/campaign as slug spring and utm_source newsletter
List my links and show clicks for the first id since 2026-01-01
Disable link <id> then generate a print PNG QR

Tools

Tool	Parameters	Notes
`shorten_url`	`destination` (required), `slug`, `note`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`	Existing `utm_*` on the URL are not overwritten; `#fragment` is kept
`shorten_urls`	`urls[]` with the same fields	Bulk create
`list_links`	—	Newest first
`update_link`	`id`, optional destination/slug/note/UTM/`disabled`	PATCH
`disable_link`	`id`, optional `disabled` (default true)	Stops redirects. `destructiveHint: true`
`delete_link`	`id`	Permanent. `destructiveHint: true`
`get_qr`	`id`, `format` png\|svg, `color`, `logo`, `print`	PNG as an image block when possible
`get_link_stats`	`id`, optional `from`, `to` (YYYY-MM-DD)	Countries, devices, referrers, daily
`get_analytics`	—	Account overview

Errors

Tool failures (missing key, 401, invalid URL, daily limit, unsafe destination) are returned as tools/call with isError: true so the model can explain them. Protocol errors (unknown method, bad JSON) stay JSON-RPC errors.

401 — API key missing or wrong (slk_...). Create a key under API Keys.
400 — invalid URL, slug taken, daily create limit, blocked or unsafe destination.
404 — unknown link id.
Process fails at start if Node is older than 18 (fetch is required).

n8n, Make, and custom agents can also call /api/v1 with the same headers.

Local development (ShortLinks monorepo)

Until npm publish, Cursor can run the copy in this folder:

Copy mcp/cursor.mcp.json.example to .cursor/mcp.json (gitignored) or ~/.cursor/mcp.json.
Paste the slk_… key into env.API_KEY.
For this repo before publish, use "command": "node" and "args": ["mcp/src/index.js"].