Linkbreakers MCP
QR-driven customer-journey platform for tracked QR codes, short links, and analytics.
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).
claude mcp add --transport http linkbreakers-mcp 'https://mcp.linkbreakers.com' --header 'Authorization: <Optional. Bearer API token (Authorization: Bearer <token>) for clients without OAuth. Omit it to sign in with OAuth, which the server advertises through its protected resource metadata.>'{
"mcpServers": {
"linkbreakers-mcp": {
"type": "http",
"url": "https://mcp.linkbreakers.com",
"headers": {
"Authorization": "<Optional. Bearer API token (Authorization: Bearer <token>) for clients without OAuth. Omit it to sign in with OAuth, which the server advertises through its protected resource metadata.>"
}
}
}
}linkbreakers-mcpclaude mcp add linkbreakers-mcp -e 'LINKBREAKERS_API_TOKEN=<your linkbreakers_api_token>' -- npx -y linkbreakers-mcp@1.183.3{
"mcpServers": {
"linkbreakers-mcp": {
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp@1.183.3"
],
"env": {
"LINKBREAKERS_API_TOKEN": "<your linkbreakers_api_token>"
}
}
}
}Environment variables
LINKBREAKERS_API_TOKENsecret Workspace API token. Leave unset to sign in with OAuth in the browser.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Linkbreakers agent skills
The single source of truth for everything Linkbreakers exposes to AI agents: skills, agent instructions, plugin manifests and a machine-readable discovery index.
Linkbreakers is lead capture infrastructure for the physical world. Every QR code or link runs a workflow (forms, conditions, password gates, multi-link pages, contact cards) that turns an anonymous scan into an identified visitor.
Install the skills
Any agent supported by the skills CLI (Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini, Cline and more):
npx skills add linkbreakers-com/agent-skillsClaude Code plugin
Bundles the skills and the hosted Linkbreakers MCP servers:
/plugin marketplace add linkbreakers-com/agent-skills
/plugin install linkbreakers@linkbreakersOther Agent Plugins clients
This repository is an Agent Plugin: plugin.json, skills/ and mcp.json at the root.
Skills
| Skill | Use it to |
|---|---|
| create-tracked-qr-code | Create a link with a dynamic, tracked QR code (or one that opens a PDF, image or video) and change its destination later |
| build-lead-capture-workflow | Add forms, conditions and pages to a link and wire every branch |
| read-visitors-and-leads | List, filter, sort and export captured visitors, events and funnels |
| send-leads-to-webhooks | Push scans and leads to a CRM or backend in real time |
| identify-visitors-on-your-site | Tie a QR scan to a later signup or purchase with the lbid and identify API |
| manage-custom-domains | Serve links from a branded domain and debug its DNS and certificate |
| use-linkbreakers-cli | Install and script the linkbreakers CLI |
| connect-linkbreakers-mcp | Connect an assistant to the Linkbreakers MCP server with OAuth |
Linkbreakers for agents
| Surface | Where |
|---|---|
| Agent instructions | AGENTS.md |
| Docs index for LLMs | https://linkbreakers.com/llms.txt |
| MCP server (your workspace, OAuth) | https://mcp.linkbreakers.com |
| Docs MCP server (no auth) | https://linkbreakers.com/mcp |
| REST API | https://api.linkbreakers.com, reference at https://linkbreakers.com/help/api |
| OpenAPI spec | https://api.linkbreakers.com/internal/openapi/api/v1/api.swagger.json |
| CLI | brew install linkbreakers-com/tap/linkbreakers (tap: https://github.com/linkbreakers-com/homebrew-tap), docs at https://linkbreakers.com/cli |
| SDKs | TypeScript (npm i linkbreakers), Python (pip install linkbreakers), Go, Java, Rust: https://linkbreakers.com/help/article/linkbreakers-developer-ecosystem-overview |
discovery.json
discovery.json is the machine-readable index of all of the above, validated by schema/discovery.schema.json. linkbreakers.com reads it at runtime from:
https://raw.githubusercontent.com/linkbreakers-com/agent-skills/main/discovery.jsonIts skills[] array is generated from the skills/ folders:
node scripts/build-discovery.mjs # regenerate
node scripts/build-discovery.mjs --check # what CI runsContributing
Add a folder under skills/ with a SKILL.md whose frontmatter has name (same as the folder) and description, regenerate discovery.json, and open a pull request. Ground every step in the real API: check the OpenAPI spec rather than guessing.
License
Frequently asked questions
What is Linkbreakers MCP?
QR-driven customer-journey platform for tracked QR codes, short links, and analytics.
How do I install Linkbreakers MCP?
It runs as a remote server. In Claude Code: claude mcp add --transport http linkbreakers-mcp 'https://mcp.linkbreakers.com' --header 'Authorization: <Optional. Bearer API token (Authorization: Bearer <token>) for clients without OAuth. Omit it to sign in with OAuth, which the server advertises through its protected resource metadata.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Linkbreakers MCP need an API key?
Yes. It expects LINKBREAKERS_API_TOKEN, Authorization, which you set in its configuration.
Is Linkbreakers MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Linkbreakers MCP?
It is published by linkbreakers-com. 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.