Linkbreakers is software (SaaS) for QR codes and links that capture, qualify and route leads. Each scan or click starts a short workflow the business builds: it learns who the person is, tells them apart and sends each one to the right menu, page or contact card, then into the business's CRM or email tool.
Category: Software, Lead capture, QR codes, No-code workflow automation. Tags: lead-capture, lead-qualification, lead-routing, qr-codes, links, no-code, api, webhooks, mcp.
Getting started
- Free tier: The Free plan costs $0, needs no credit card, and includes the REST API, webhooks and the MCP server.
- Self-serve signup: https://app.linkbreakers.com?offer=free-plan&ref=landing-free-plan&showcase=default
- API keys: create a workspace API token yourself at https://app.linkbreakers.com/workspace/dashboard/api-tokens
- REST API documentation
- How Linkbreakers works with AI agents
- Authentication guide (auth.md)
- Pricing (pricing.md)
API: Linkbreakers API
REST API for links, QR codes, workflow steps, media (PDFs, images, videos), visitors, events, analytics, webhooks and custom domains. Bearer auth with a workspace API token.
- Base URL:
https://api.linkbreakers.com - OpenAPI
- Documentation, reference
Endpoints that need no authentication:
GET https://api.linkbreakers.com/v1/pricing/plans: List pricing plansGET https://api.linkbreakers.com/v1/public/page-theme-templates: List page theme templatesGET https://api.linkbreakers.com/v1/public/qrcode-templates: List QR code templatesGET https://api.linkbreakers.com/v1/workspace-tokens/scopes: List the scopes a token can have
Bulk endpoints:
POST https://api.linkbreakers.com/v1/links/batch: Create multiple links from a bare JSON arrayPOST https://api.linkbreakers.com/v1/links/bulk: Create multiple links in a single requestPOST https://api.linkbreakers.com/v1/links/bulk/jobs: Create links in bulk in the backgroundPOST https://api.linkbreakers.com/v1/page-themes/bulk-update: Restyle many links' page themesPOST https://api.linkbreakers.com/v1/workflow-steps/bulk-insert: Insert one step into many links' workflows
Example requests
List pricing plans (no token needed):
curl https://api.linkbreakers.com/v1/pricing/plans
List links:
curl "https://api.linkbreakers.com/v1/links?pageSize=5" \
-H "Authorization: Bearer $LINKBREAKERS_TOKEN"
Create a link with a tracked QR code:
curl -X POST https://api.linkbreakers.com/v1/links \
-H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"destination": "https://example.com", "waitForQrcode": true}'
Get the link's QR code image URL (signed, it expires, so fetch it when you render):
curl "https://api.linkbreakers.com/v1/links/$LINK_ID?include=qrcodeSignedUrl" \
-H "Authorization: Bearer $LINKBREAKERS_TOKEN"
Send that link's scans to your endpoint with a webhook (linkId is the link's id; leave it out to receive every link's scans):
curl -X POST https://api.linkbreakers.com/v1/webhooks \
-H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Scans", "endpointUrl": "https://hooks.example.com/linkbreakers", "linkId": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"}'
Authentication
Guide: auth.md
- bearer: Workspace API token created in the dashboard, sent as Authorization: Bearer
. For the REST API, SDKs and CLI; the MCP server does not accept it. Applies to https://api.linkbreakers.com. - oauth2: OAuth 2.1 authorization code with PKCE and dynamic client registration, handled by MCP clients. Applies to
https://mcp.linkbreakers.com.
MCP servers
- Linkbreakers MCP:
https://mcp.linkbreakers.com(streamable-http, auth: oauth2). Create links, QR codes, workflows and media, and read visitors and analytics in your workspace. Server card, docs, registry entry Local stdio server:npx -y linkbreakers-mcp(packagelinkbreakers-mcpon npm, latest 1.204.1, source at https://github.com/linkbreakers-com/linkbreakers-mcp) Linkbreakers MCP supports MCP Apps (io.modelcontextprotocol/ui,text/html;profile=mcp-app) and the OpenAI Apps SDK (openai/outputTemplate): tool results render as interactive UI in the conversation. Views: Link card (ui://linkbreakers/link-card.html, forlinks_create,links_get); Visitors (ui://linkbreakers/visitors-card.html, forvisitors_list); Workspace metrics (ui://linkbreakers/workspace-metrics.html, foranalytics_workspace_metric). MCP Apps guide - Linkbreakers Docs MCP:
https://linkbreakers.com/mcp(streamable-http, auth: none). Search and read the Linkbreakers help center and developer docs. No sign-in required. Server card, docs
SDKs
- TypeScript:
linkbreakerson npm, latest 1.204.1,npm install linkbreakers, docs - Python:
linkbreakerson PyPI, latest 1.204.1,pip install linkbreakers, docs - Go:
github.com/linkbreakers-com/linkbreakers-goon Go modules, latest 1.204.1,go get github.com/linkbreakers-com/linkbreakers-go, docs - Java:
com.linkbreakers:linkbreakers-sdkon Maven Central, latest 1.204.1,com.linkbreakers:linkbreakers-sdk, docs - Rust:
linkbreakerson crates.io, latest 1.204.1,cargo add linkbreakers, docs
CLI
- Homebrew:
brew install linkbreakers-com/tap/linkbreakers(registry) - Install script (macOS, Linux):
curl -fsSL https://cli.linkbreakers.com/install.sh | bash - npm:
npm install -g linkbreakers-cli(registry, latest 1.204.1) - CLI docs, source, latest release v1.204.1
Agent skills
- build-lead-capture-workflow: Turn a Linkbreakers link or QR code into a lead capture flow by adding workflow steps (forms, conditions, multi-link pages, message pages, thank you pages, contact cards, redirects, opening a PDF, image or video) and wiring their branches. Use when the user wants to collect emails, phone numbers or answers from people who scan a QR code, qualify visitors, route them by country, device or previous answers, or gate content behind a form or password.
- connect-linkbreakers-mcp: Connect an AI assistant (Claude, Claude Code, Cursor, VS Code, Continue or any MCP client) to the hosted Linkbreakers MCP server at https://mcp.linkbreakers.com with OAuth sign-in, then pick the right MCP tools for links, QR codes, workflows, media, visitors, domains and analytics. Use when the user wants their assistant to operate their Linkbreakers workspace directly, asks for the Linkbreakers MCP URL or config, or the MCP connection is failing.
- create-tracked-qr-code: Create a Linkbreakers link with a dynamic, tracked QR code and get the QR image URL, short URL, and scan counts back. Use when the user wants a QR code for a flyer, sign, product, booth, table tent or business card, wants a QR code that opens a PDF menu, brochure, image or video, wants to shorten a URL with scan tracking, wants one link behind many printed codes that each carry their own value (serial number, table, room, batch, GS1 Digital Link) with a QR image per value in the link design, or wants to change where an existing QR code points without reprinting it.
- identify-visitors-on-your-site: Connect a QR code scan to what the same person does later on the user's own website or app by forwarding the Linkbreakers lbid through the redirect and calling the identify API, so signups, purchases and profile data merge into one Linkbreakers visitor. Use when the user wants offline-to-online attribution, wants to know which QR code drove a signup or sale, or wants to enrich Linkbreakers visitors from their own product.
- manage-custom-domains: Connect a custom (white-label) domain such as qr.example.com to a Linkbreakers workspace, get the exact DNS records to add, check verification and certificate status, and serve links and QR codes from it. Use when the user wants branded short links, wants QR codes to show their own domain instead of Linkbreakers, or asks why a custom domain is pending, not working or expiring.
- read-visitors-and-leads: Read, filter, sort and export the leads (visitors) a Linkbreakers workspace has captured from QR code scans and forms, including their custom attributes, scan history and journey through a workflow. Use when the user asks who scanned a QR code, wants a list or CSV of leads, wants leads filtered by answers such as budget or interest, wants a lead's full history, or wants funnel and drop-off numbers for a link.
- send-leads-to-webhooks: Push Linkbreakers scans and captured leads to another system in real time with webhooks, and write the receiving endpoint. Use when the user wants new QR code leads in their CRM, Slack, a database, Zapier, Make or their own backend as soon as someone scans or submits a form, or asks what a Linkbreakers webhook payload looks like.
- sync-leads-to-crm: Sync the visitors a Linkbreakers QR code or link identifies into a CRM or email marketing tool as contacts, natively, without webhooks or Zapier. Covers HubSpot, Salesforce, Zoho CRM, Pipedrive, Freshsales, Mailchimp, Klaviyo, Brevo, MailerLite, Kit, Loops, Customer.io and Bird. Use when the user wants QR code leads added to a list or audience, created as a CRM contact, lead or deal, mapped to custom fields, or subscribed to marketing only with consent.
- use-linkbreakers-cli: Create a Linkbreakers workspace and API token in one command, then manage links, QR codes, workflows and analytics from the shell with the official linkbreakers CLI. Use whenever the user asks to create a link, short link or QR code with Linkbreakers, wants to automate Linkbreakers from the terminal, a script, cron or CI, or asks how to install or authenticate the Linkbreakers CLI. Works with no account: signup is one command.
Discovery documents
- llms.txt
- API catalog (RFC 9727)
- ARD catalog
- Agent skills index
- MCP server card
- Sitemap
- Help center
- This view as JSON
Contact: support@linkbreakers.com