About LinkBit
LinkBit is an MCP server for managing short links from MCP clients, with tools for link creation, QR codes, and click analytics. It also supports bulk creation, link updates, and disabling or deleting links.
Key features
- 01Create single or bulk short links
- 02Set slugs, notes, and UTM parameters
- 03Update, disable, or delete links
- 04Generate PNG or SVG QR codes
- 05View link and account analytics
Use cases
- 01Create campaign links with UTM parameters
- 02Shorten a batch of destination URLs
- 03Generate QR codes for print
- 04Review click sources and devices by date
MCP support
The MCP server exposes tools to create, list, update, disable, and delete short links, as well as generate QR codes and retrieve analytics.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y linkbit-mcpAPI_KEYSecretLinkBit API key (slk_...)APP_URLAPI origin, default https://linkbit.liveLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
9Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| note | string | No | |
| slug | string | No | |
| utm_term | string | No | |
| utm_medium | string | No | |
| utm_source | string | No | |
| destination | string | Yes | |
| utm_content | string | No | |
| utm_campaign | string | No |
Details
From the project READMElinkbit-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).
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
npx -y linkbit-mcp
Claude Code:
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):
{
"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 (
fetchis 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.exampleto.cursor/mcp.json(gitignored) or~/.cursor/mcp.json. - Paste the
slk_…key intoenv.API_KEY. - For this repo before publish, use
"command": "node"and"args": ["mcp/src/index.js"].
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.