linkbreakers-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
