Allows AI agents to create, style, and manage dynamic QR codes and short links while tracking scan analytics and visitor data.
Also known as linkbreakers-com/linkbreakers-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 16, 2026
- License
- MIT
What is Linkbreakers MCP?
Linkbreakers allows AI agents to create, style, and manage dynamic QR codes and short links while tracking scan analytics and visitor data.
Summary generated from the project's README
About Linkbreakers MCP server
Generating and managing dynamic QR codes and short links from within an AI assistant is what linkbreakers-mcp enables. Developers using Claude, Cursor, or VS Code can instruct their agents to build branded assets, customize visual styles like dot shapes and colors, and insert lead capture forms before a user reaches a destination URL. The server functions as a local stdio bridge to a hosted service, though clients supporting remote connections can connect directly to the hosted endpoint.
Setting up the server requires Node.js 18 or later and uses an OAuth flow for authentication rather than manual API key entry. Once authorized via a browser, the agent gains access to tools like links_create for single or bulk link generation, qrcodedesigns_update for visual modifications, and workflow_steps_create for adding data collection steps. Users can also retrieve detailed scan analytics, including device types, geographic locations, and visitor counts, through tools like events_list and metrics_workspace. Interactive cards are provided in clients that support MCP App rendering to display this data clearly.
What you can do with it
- 1Bulk QR code generationInstruct an agent to create unique QR codes for a large list of physical store locations.
- 2Visual brand customizationAsk the AI to change the aesthetic properties of a QR code to match specific brand colors and styles.
- 3Lead generation setupHave an agent configure a workflow that requires users to provide an email address before being redirected.
- 4Scan data analysisQuery the agent to find out where and when people are scanning a specific marketing poster.
Written from the project's README. Every use case is checked against a quote from it.
How to install Linkbreakers MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Linkbreakers MCP in Claude Code
$ claude mcp add linkbreakers-mcp -- npx -y linkbreakers-mcpInstall Linkbreakers MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"linkbreakers-mcp": {
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp"
]
}
}
}Install Linkbreakers MCP in VS Code
.vscode/mcp.json
{
"servers": {
"linkbreakers-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp"
]
}
}
}Install Linkbreakers MCP in VS Code CLI
$ code --add-mcp '{"name":"linkbreakers-mcp","type":"stdio","command":"npx","args":["-y","linkbreakers-mcp"]}'Install Linkbreakers MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"linkbreakers-mcp": {
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp"
]
}
}
}Install Linkbreakers MCP in Codex
$ codex mcp add linkbreakers-mcp -- npx -y linkbreakers-mcpInstall Linkbreakers MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.linkbreakers-mcp] command = "npx" args = ["-y", "linkbreakers-mcp"]
Install Linkbreakers MCP in Gemini CLI
$ gemini mcp add -s user linkbreakers-mcp npx -- -y linkbreakers-mcpInstall Linkbreakers MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"linkbreakers-mcp": {
"command": "npx",
"args": [
"-y",
"linkbreakers-mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablelinkbreakers-com/linkbreakers-mcp is public and reachablegithub.com/linkbreakers-com/linkbreakers-mcp ↗Pass
- Package names this repository as its sourcelinkbreakers-mcp names linkbreakers-com/linkbreakers-mcp as sourcenpmjs.com/package/linkbreakers-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for linkbreakers-mcpnpmjs.com/package/linkbreakers-mcp/v/1.195.11#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/linkbreakers-com/linkbreakers-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from linkbreakers-mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHublinkbreakers-mcp
An MCP server that lets AI agents create and track QR codes. Connect Claude, Cursor, VS Code or any MCP client to Linkbreakers and your agent can create a dynamic QR code and its short link, style the code, put a lead capture form between the scan and the destination and read back every scan: device, country, city and time, visitors and analytics.
npx -y linkbreakers-mcp
Sign in with OAuth on the first request, nothing to paste. Works on every Linkbreakers plan, Free included.
What an agent can ask for, and the tools it uses:
| Ask | Tools |
|---|---|
| "Make a QR code for our spring poster that opens example.com/spring" | links_create |
| "Make one code per store from this list" | links_create_bulk |
| "Make the code navy with rounded dots" | qrcodedesigns_update |
| "Ask for an email before the redirect" | workflow_steps_create |
| "Who scanned the poster this week, and from where?" | events_list, visitors_list |
| "How many scans did the workspace get?" | metrics_workspace |
In clients that render MCP Apps (Claude, ChatGPT), links_create, links_get, visitors_list and metrics_workspace answer with an interactive card.
How it works
This package is a local stdio bridge to the hosted server at https://mcp.linkbreakers.com, for MCP clients that can only start local (stdio) servers. If your client supports remote MCP servers, connect it to https://mcp.linkbreakers.com directly instead. See the setup guide.
Tools, resources and their schemas come from the hosted server: this package forwards every request unchanged, so it always matches what https://mcp.linkbreakers.com serves.
Setup
{
"mcpServers": {
"linkbreakers": {
"command": "npx",
"args": ["-y", "linkbreakers-mcp"]
}
}
}
Authentication
On the first request, your browser opens the Linkbreakers sign-in. Once you approve, the tools appear. Tokens are stored in ~/.config/linkbreakers/mcp-oauth.json and refreshed automatically.
The MCP server accepts OAuth only: dashboard API tokens are refused, so there is nothing to paste. API tokens are for the REST API, the SDKs and the CLI.
| Variable | Default | Purpose |
|---|---|---|
LINKBREAKERS_MCP_URL |
https://mcp.linkbreakers.com |
Server to forward to |
LINKBREAKERS_MCP_CALLBACK_PORT |
47823 |
Local port for the OAuth redirect |
Requires Node.js 18 or later.
Releases
Each API release dispatches update-sdk to this repo. The release workflow sets the package to the API version, checks that the server answers an MCP initialize over stdio, publishes to npm through trusted publishing and tags v<version>.
License
MIT
Linkbreakers MCP questions
How do I add Linkbreakers MCP to Claude Code?
Run claude mcp add linkbreakers-mcp -- npx -y linkbreakers-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Linkbreakers MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can I use API tokens for this MCP server?
No, the MCP server only accepts OAuth. Dashboard API tokens are not supported for this connection.
What kind of analytics can the agent access?
The agent can retrieve data regarding device type, country, city, time, total visitors, and workspace metrics.