LinkBit
Shorten URLs, bulk create, QR, and click analytics for LinkBit.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
linkbit-mcpclaude mcp add linkbit -e 'API_KEY=<your api_key>' -e 'APP_URL=<APP_URL>' -- npx -y linkbit-mcp@1.0.4
{
"mcpServers": {
"linkbit": {
"command": "npx",
"args": [
"-y",
"linkbit-mcp@1.0.4"
],
"env": {
"API_KEY": "<your api_key>",
"APP_URL": "<APP_URL>"
}
}
}
}
Environment variables
API_KEYrequired secret LinkBit API key (slk_...)APP_URLAPI origin, default https://linkbit.live
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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).
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"].
Frequently asked questions
What is LinkBit?
Shorten URLs, bulk create, QR, and click analytics for LinkBit.
How do I install LinkBit?
It runs on your machine. In Claude Code: claude mcp add linkbit -e 'API_KEY=<your api_key>' -e 'APP_URL=<APP_URL>' -- npx -y linkbit-mcp@1.0.4. For other clients, paste the JSON configuration from this page into their MCP settings.
Does LinkBit need an API key?
Yes. It expects API_KEY, which you set in its configuration.
Is LinkBit open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains LinkBit?
It is published by yutotanakastar. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.