qrcode-pub-mcp

MCP server for QRCode.Pub tools, runnable with one command and no API key:

This package is a dependency-free stdio bridge (Node 18+, ~60 lines) to the hosted Streamable-HTTP server at https://qrcode.pub/mcp. Clients that speak Streamable HTTP natively can skip the bridge and use that URL directly.

Install

npx -y github:AgentiLoop/qrcode-pub-mcp        # runs the stdio bridge

Claude Code

claude mcp add qrcode-pub -- npx -y github:AgentiLoop/qrcode-pub-mcp
# or, no bridge:
claude mcp add --transport http qrcode-pub https://qrcode.pub/mcp

Claude Desktop / Cursor / Windsurf / Cline (stdio)

{
  "mcpServers": {
    "qrcode-pub": {
      "command": "npx",
      "args": ["-y", "github:AgentiLoop/qrcode-pub-mcp"]
    }
  }
}

Cursor / VS Code / any Streamable-HTTP client (no bridge)

{
  "mcpServers": {
    "qrcode-pub": { "type": "http", "url": "https://qrcode.pub/mcp" }
  }
}

Verify

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y github:AgentiLoop/qrcode-pub-mcp

Related MCP server: aipaygen-mcp

Paid tools and x402

The three paid tools cost cents, paid in USDC with the open x402 protocol (v2, scheme exact) on Base (eip155:8453) or Solana mainnet. No account, no key, no subscription:

1. Call the tool without payment → the result is isError: true with structuredContent.paymentRequired (the full x402 accepts list: network, asset, amount, payTo).

2. Sign one entry with any x402 client (e.g. @x402/fetch, x402-axios, or the agent's own wallet) and call the tool again with the base64 payment payload as payment.

3. The server verifies and settles through the facilitator and returns the result; a 4xx answer is never charged.

The same endpoints are plain HTTP for agents that prefer fetch + x402 middleware: GET /x402/extract?url=…, GET /x402/meta?url=…, POST /x402/store. Catalog: https://qrcode.pub/x402, OpenAPI: https://qrcode.pub/openapi.json.

Environment

Links

• Docs: https://qrcode.pub/qr-code-api?ref=github-mcp#mcp

• Official MCP registry entry: pub.qrcode/tools

• Free QR image API (no MCP needed): https://qrcode.pub/api/qr?data=https://example.com&size=300

• Agent skills for the same tools: https://github.com/AgentiLoop/skills

License

MIT — the bridge is open source; the hosted service terms are at https://qrcode.pub/.