Linkbreakers MCP — Claude Code MCP server: QR codes and leads
Wires your agent into Linkbreakers: tracked QR codes, lead-capture workflows and visitor exports.
claude mcp add --transport http mcp https://mcp.linkbreakers.comWhat Linkbreakers MCP does
Linkbreakers handles lead capture in the physical world. A QR code or link opens a workflow — forms, conditional branches, multi-link pages, contact cards — and a scan by someone anonymous becomes a record you can act on.
The MCP server exposes your Linkbreakers workspace to the agent. It can mint a link with a dynamic QR code and repoint it later, assemble workflow branches, pull visitors and events, and push leads to a webhook in your CRM. A second server serves the docs and needs no login: https://linkbreakers.com/mcp.
The workspace server at https://mcp.linkbreakers.com authenticates over OAuth. Pick the stdio route with npx -y linkbreakers-mcp and you must supply LINKBREAKERS_API_TOKEN instead — the server will not authorise without it.
What it helps with
- mint a link with a dynamic QR code and repoint it later
- assemble a workflow with a form and conditional branches
- export visitors and events for a date range
- push scans and leads into a CRM over a webhook
- tie a QR scan to a later signup on your site
Example prompts for the agent
- Create a tracked QR code pointing at our signup page
- Add a phone field to this workflow and a branch for repeat scans
- List visitors from the past week and export them as CSV
How to install Linkbreakers MCP
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.linkbreakers.com2Platform CLI
claude mcp add --env LINKBREAKERS_API_TOKEN=<LINKBREAKERS_API_TOKEN> --transport stdio linkbreakers-mcp -- npx -y linkbreakers-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add linkbreakers-mcp --url https://mcp.linkbreakers.com2Platform CLI
codex mcp add linkbreakers-mcp --env LINKBREAKERS_API_TOKEN=<LINKBREAKERS_API_TOKEN> -- npx -y linkbreakers-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"linkbreakers-mcp": {
"url": "https://mcp.linkbreakers.com"
}
}
}{
"mcpServers": {
"linkbreakers-mcp": {
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp"
],
"env": {
"LINKBREAKERS_API_TOKEN": "<LINKBREAKERS_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"linkbreakers-mcp": {
"type": "http",
"url": "https://mcp.linkbreakers.com"
}
}
}{
"servers": {
"linkbreakers-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp"
],
"env": {
"LINKBREAKERS_API_TOKEN": "<LINKBREAKERS_API_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http linkbreakers-mcp https://mcp.linkbreakers.com2Platform CLI
gemini mcp add -e LINKBREAKERS_API_TOKEN=<LINKBREAKERS_API_TOKEN> linkbreakers-mcp npx -y linkbreakers-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Linkbreakers MCP
How do I install Linkbreakers MCP in Claude Code?
Run claude mcp add --transport http mcp https://mcp.linkbreakers.com, then complete the OAuth flow.
What does Linkbreakers MCP do?
It gives the agent access to your Linkbreakers workspace: tracked QR codes and links, lead-capture workflows, visitor and event reads, and webhook delivery of leads.
Does Linkbreakers MCP need an API token?
The HTTP endpoint at https://mcp.linkbreakers.com uses OAuth. LINKBREAKERS_API_TOKEN is only required for the stdio setup with npx -y linkbreakers-mcp.
