MCP setup · Windsurf

Connect MyQRx to Windsurf.

The agentic IDE with Cascade. With MyQRx connected, it can make dynamic QR codes in your account, change where they point after printing and tell you which one worked.

Step 1

Get an API token.

Sign in to MyQRx (Free works), open Settings → API tokens, name it "Windsurf" and tick what it may do. Copy the token: it is shown once.

Step 2

Add the server.

Add this to ~/.codeium/windsurf/mcp_config.json (Windsurf Settings → Cascade → MCP servers → View raw config). Replace mqx_your_token with your token.

{
  "mcpServers": {
    "myqrx": {
      "serverUrl": "https://myqrx.com/mcp",
      "headers": { "Authorization": "Bearer mqx_your_token" }
    }
  }
}

Step 3

Check it works.

1
Paste the configuration into mcp_config.json and save.
2
Press Refresh in the MCP servers panel and check myqrx lists its tools.
3
In Cascade, ask: "List my MyQRx QR codes."

Then ask

Things to try in Windsurf.

"Make a dynamic QR code for each of our 3 stores, pointing to example.com/offer, named by store."

"Show me the QR code for the Andheri store so I can check it."

"Which store's code got the most scans this month, and is that up on last month?"

"Point the weakest store's code at example.com/new-offer."

A dynamic code uses one slot of your plan's quota; static codes (Wi-Fi, vCard, plain text) are unlimited. Which to choose.

If something's off

Fixes for Windsurf.

Cascade says the tool is unavailable

Refresh the MCP servers panel after saving, and check the server is enabled.

Errors mention authentication

Check the token in the Authorization header, and create a new one in Settings if it was revoked.

An error says quota_exceeded

Your plan's dynamic codes are used up. Static codes still work; upgrade or buy a code pack for more.

An error says missing_ability

The token can't do that. Create a token with that ability ticked and use it instead.

Tools

What Windsurf gets.

MyQRx MCP tools
create_code	Create a QR code
list_codes	List QR codes
update_destination	Change where a dynamic code points
rename_code	Rename a QR code
get_code_image	Get a QR code image
get_scan_analytics	Scan analytics for one code
compare_codes	Compare QR codes
check_url_safety	Check a URL for phishing and malware

Other apps: Claude Code · Cursor · VS Code · Claude Desktop · All tools and details

FAQ

MyQRx in Windsurf, answered.

How do I add MyQRx to Windsurf?

Create an API token under MyQRx Settings → API tokens, then add the server https://myqrx.com/mcp to Windsurf with the token in an Authorization: Bearer header, as shown on this page.

What can Windsurf do with MyQRx?

Create dynamic and static QR codes, rename them, change where dynamic codes point after printing, show a code image, read scan analytics and compare codes to see which placement worked.

How do I disconnect MyQRx from Windsurf?

Revoke the token under Settings → API tokens. Windsurf loses access on its next call; your codes keep working.