Skip to main content
Glama

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:

Tool

What it does

Price

qr_code

QR code image (PNG or SVG) for any text or link — returned inline plus a stable image URL

free

page_to_markdown

Fetch a public web page → title, description, clean Markdown, links (deterministic, no model call)

$0.01 USDC via x402

page_metadata

Page metadata: title, description, canonical, language, OpenGraph/Twitter cards, icons, JSON-LD

$0.005 USDC via x402

host_file

Upload 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

Related MCP server: @melis-ai/x402-tools-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

Variable

Default

Purpose

QRCODE_PUB_MCP_URL

https://qrcode.pub/mcp

remote endpoint

QRCODE_PUB_MCP_TIMEOUT_MS

60000

per-request timeout

License

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

Available Tools

4 tools
host_fileHost a file at a public URL for 30 days ($0.01/call)A

Upload a file (≤ 5 MB; png, jpeg, webp, gif, pdf, json, txt, md or csv) and get a stable public URL https://qrcode.pub/f/ that any agent, tool or browser can fetch for 30 days. Nothing executable is accepted. The answer includes a delete token. Price: $0.01 USDC per call via x402 (USDC on Base or Solana, no account; nothing is charged for a bad input).

Inputs: content (required), content_type (required), name, payment, +1 more.

page_metadataWeb page metadata ($0.005/call)A
Read-only

Fetch a public web page and return its metadata: title, description, canonical URL, language, OpenGraph and Twitter card tags, icons and parsed JSON-LD blocks. Price: $0.005 USDC per call via x402 (USDC on Base or Solana, no account; nothing is charged for a bad input).

Inputs: url (required), payment.

page_to_markdownWeb page → Markdown ($0.01/call)A
Read-only

Fetch a public web page and return its title, description, clean Markdown (scripts, styles, nav chrome removed) and the list of links. No model call, deterministic. Price: $0.01 USDC per call via x402 (USDC on Base or Solana, no account; nothing is charged for a bad input).

Inputs: url (required), payment.

qr_codeQR code image (free)A
Read-onlyIdempotent

Generate a QR code image (PNG or SVG) for any text or link. Free, no account. The answer carries the image and a permanent image URL you can embed or print.

Inputs: data (required), ecc, size, color, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 4 tools

    Disambiguation4/5

    qr_code and host_file are clearly distinct, and page_to_markdown vs page_metadata differ by output (clean Markdown vs structured metadata/OG tags). The two page-fetching tools overlap in the fetch step and could be momentarily confused, but their return contracts are different enough to guide selection.

    Naming Consistency4/5

    All names use snake_case (qr_code, page_to_markdown, page_metadata, host_file), which is consistent. The verb/noun style varies a bit (noun-only qr_code, noun_to_noun page_to_markdown, verb_noun host_file), but each name is readable and predictable.

    Tool Count4/5

    Four tools is a compact, well-scoped set for a QR generation plus file-hosting/page-fetching utility. Slightly thin, but each tool earns its place and nothing looks redundant.

    Completeness3/5

    Generation (qr_code), fetching (page_to_markdown, page_metadata) and upload (host_file) are covered, but host_file returns a delete token with no corresponding delete tool, leaving a dead end for cleanup. No QR decoding or content-size/format management operations either.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Multi-tool API for AI agents with MCP support: image generation (Flux), web scraping, TTS, OCR, QR codes, weather, crypto, PDF, screenshots, and more. Pay-per-use with x402 protocol.
      22 npm
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server providing 22 pay-per-call utility tools for AI agents (scrape, validate, embed, store, moderate, notify, convert, prevent loops) without accounts or API keys, using USDC payments via the x402 protocol.
      17
      62 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-capable agents to call 40 paid API tools—including OCR, PDF, image, tabular, and web utilities—by paying per request via x402 micropayments on Base, with no API key, subscription, or signup required.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to read public web pages as clean markdown, verify whether a quote appears on a page, check the health of up to 25 links, and audit any origin's x402 and agent-readiness setup. Tools are pay-per-call in USDC on Base via x402 with free previews, requiring no signup or API key.
      MIT