Back to Directory/Analytics & BI

LinkBit

Shorten URLs, bulk create, QR, and click analytics for LinkBit.

Analytics & BIJavaScriptv1.0.0

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

  1. Sign in at linkbit.live and create an API key (slk_...) on the API Keys page.
  2. 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

ToolParametersNotes
shorten_urldestination (required), slug, note, utm_source, utm_medium, utm_campaign, utm_term, utm_contentExisting utm_* on the URL are not overwritten; #fragment is kept
shorten_urlsurls[] with the same fieldsBulk create
list_links—Newest first
update_linkid, optional destination/slug/note/UTM/disabledPATCH
disable_linkid, optional disabled (default true)Stops redirects. destructiveHint: true
delete_linkidPermanent. destructiveHint: true
get_qrid, format png|svg, color, logo, printPNG as an image block when possible
get_link_statsid, 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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y linkbit-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-elkinegor-linkbit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "linkbit-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

linkbit-mcpnpm

Compatible MCP Clients

LinkBit works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More