Create and track QR codes from inside your AI tool.
Codes Dance exposes a remote MCP server. Connect it once and Claude, Codex or Cursor can create QR codes, repoint them and answer questions about who scanned them — where, on what device, and when.
https://codes.dance/api/mcpConnect in one minute
Sign in with your Codes Dance account when your tool asks — OAuth 2.1, no API key to copy. Don’t have an account yet? It is created on first connect.
Claude.ai · Claude Desktop
- Open Settings → Connectors → Add custom connector
- Paste https://codes.dance/api/mcp and click Add
- Click Connect, sign in with your Codes Dance account and approve
- Turn the connector on in a chat and ask away
Claude Code
Add the server, then run /mcp → codes-dance → Authenticate:
claude mcp add --transport http codes-dance https://codes.dance/api/mcpOpenAI Codex
Add to your Codex config; Codex will start the OAuth flow the first time it connects:
[mcp_servers.codes_dance]
url = "https://codes.dance/api/mcp"Cursor · Windsurf · VS Code
Add to .cursor/mcp.json (or the equivalent for Windsurf / VS Code) and approve the sign-in prompt:
{
"mcpServers": {
"codes-dance": { "url": "https://codes.dance/api/mcp" }
}
}Scripts, CI and tools without OAuth
Create a personal API key in Dashboard → API & MCP and send it as a bearer token.
claude mcp add --transport http codes-dance https://codes.dance/api/mcp \
--header "Authorization: Bearer cd_live_…"Tools
Read tools never change anything. Write tools are marked so your AI tool asks before running them.
| Tool | What it does | Access |
|---|---|---|
| create_qr_code | Create a new QR code for a URL, text, Wi‑Fi, contact card, event and more. Returns the scan link and a PNG preview. | Write |
| list_qr_codes | List your QR codes with what each points to, total scans and last scan time. | Read |
| get_qr_code | Details of one QR code. | Read |
| update_qr_code | Change where an existing code points. The printed code stays the same. | Write |
| get_qr_image | Render the QR image as PNG or SVG at any size. | Read |
| get_qr_analytics | Scans, unique visitors, trend, countries, cities, devices, browsers and a weekday × hour heatmap for one code. | Read |
| get_recent_scans | The most recent individual scans: time, approximate location, device, outcome. | Read |
| get_dashboard_overview | Account-wide totals across all your codes. | Read |
Things to ask
Plain language is enough — the model picks the right tool.
- “Create a QR code for https://example.com/menu and show it to me.”
- “How many people scanned my menu code this week, and from which cities?”
- “Point the event QR code to the new signup page instead.”
- “Which of my QR codes is doing best, and when do people usually scan it?”
Security & privacy
OAuth 2.1 with PKCE
Sign-in and consent are handled by Clerk, the same login your dashboard uses. Your tool never sees your password.
Minimal scopes
Only email and profile are requested — enough to identify your account. Tokens can be refreshed without signing in again.
API keys are hashed
Personal keys are shown once and stored only as a SHA‑256 hash. Revoke any key instantly from the dashboard.
Your data only
Tools only ever return QR codes and analytics owned by the signed-in account. Scan locations are approximate and IP addresses are never stored.
Writes are explicit
Creating or repointing a code is a separate tool marked as a write, so Claude and other clients ask for confirmation first.
Disconnect anytime
Remove the connector in your AI tool, or revoke access from your Codes Dance account. Access ends immediately.
FAQ
Is it free?
Yes. The MCP server is included with every account. Free accounts can hold 1 QR code and Pro accounts up to 100; analytics are available on both.
Which clients are supported?
Any MCP client that supports remote servers over Streamable HTTP: Claude.ai, Claude Desktop, Claude Code, OpenAI Codex, Cursor, Windsurf, VS Code and more. Clients without OAuth support can use an API key.
Can I change where a printed QR code goes?
Yes. Every Codes Dance code routes through your scan link, so update_qr_code changes the destination without reprinting anything.
What does the AI tool get access to?
Only the QR codes and scan statistics of the account you sign in with. It cannot see other users, billing details or your password.
Where do I get help?
Email support@codes.dance. Include the name of your AI tool and the error text if something fails to connect.