Skip to content
Conduit

mcp server

qrcode-pub-mcp

MCP server for QRCode.Pub tools: free QR code images, paid page→Markdown, page metadata and file hosting via x402 (no API key). Stdio bridge to https://qrcode.pub/mcp

AgentiLoop/qrcode-pub-mcpcommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "qrcode-pub-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qrcode-pub-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 26, 2026

qrcode-pub-mcp

🤖 Built by the makers of Agent!, an autonomous macOS agent. 🌐 agentiloop.ai

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

ToolWhat it doesPrice
qr_codeQR code image (PNG or SVG) for any text or link — returned inline plus a stable image URLfree
page_to_markdownFetch a public web page → title, description, clean Markdown, links (deterministic, no model call)$0.01 USDC via x402
page_metadataPage metadata: title, description, canonical, language, OpenGraph/Twitter cards, icons, JSON-LD$0.005 USDC via x402
host_fileUpload a file (≤ 5 MB: png, jpeg, webp, gif, pdf, json, txt, md, csv) → public URL https://qrcode.pub/f/<id> for 30 days$0.01 USDC via x402

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

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

VariableDefaultPurpose
QRCODE_PUB_MCP_URLhttps://qrcode.pub/mcpremote endpoint
QRCODE_PUB_MCP_TIMEOUT_MS60000per-request timeout

Links

License

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

↑↓ navigate openesc close