# Linkbreakers MCP

Wires your agent into Linkbreakers: tracked QR codes, lead-capture workflows and visitor exports.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: linkbreakers-com
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/linkbreakers-com/agent-skills
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/linkbreakers-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.linkbreakers.com`
- Environment variables: `LINKBREAKERS_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.linkbreakers.com
```

2. **Platform CLI**
```bash
claude mcp add --env LINKBREAKERS_API_TOKEN=<LINKBREAKERS_API_TOKEN> --transport stdio linkbreakers-mcp -- npx -y linkbreakers-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add linkbreakers-mcp --url https://mcp.linkbreakers.com
```

2. **Platform CLI**
```bash
codex mcp add linkbreakers-mcp --env LINKBREAKERS_API_TOKEN=<LINKBREAKERS_API_TOKEN> -- npx -y linkbreakers-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "linkbreakers-mcp": {
            "url": "https://mcp.linkbreakers.com"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "linkbreakers-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "linkbreakers-mcp"
            ],
            "env": {
                "LINKBREAKERS_API_TOKEN": "<LINKBREAKERS_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "linkbreakers-mcp": {
            "type": "http",
            "url": "https://mcp.linkbreakers.com"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "linkbreakers-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "linkbreakers-mcp"
            ],
            "env": {
                "LINKBREAKERS_API_TOKEN": "<LINKBREAKERS_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http linkbreakers-mcp https://mcp.linkbreakers.com
```

2. **Platform CLI**
```bash
gemini mcp add -e LINKBREAKERS_API_TOKEN=<LINKBREAKERS_API_TOKEN> linkbreakers-mcp npx -y linkbreakers-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [debug-zoom-integration](https://affpapa.org/en/nevibecode/skills/anthropics-debug-zoom-integration.md) — skill · 2100 installs
- [cyrus-setup-linear](https://affpapa.org/en/nevibecode/skills/cyrus-setup-linear.md) — skill · 1100 installs
- [shopify](https://affpapa.org/en/nevibecode/skills/mrgoonie-shopify.md) — skill · 450 installs
- [Meta Social Technologies MCP](https://affpapa.org/en/nevibecode/mcp/meta-social-technologies-mcp.md) — MCP server · ★ 17
- [zoom-plugin](https://affpapa.org/en/nevibecode/plugins/zoom-plugin.md) — plugin · ★ 7
- [api-integration-specialist](https://affpapa.org/en/nevibecode/skills/api-integration-specialist.md) — skill · 2978 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md