Model Context Protocol

Crypto QR codes, in the language your AI already speaks.

Plug Toreador into Claude Desktop, Cursor, Windsurf or any MCP-capable assistant in 30 seconds. Then just ask: "generate a Bitcoin QR code for 0.001 BTC to bc1q…". The assistant calls Toreador, receives the QR, and shows it to you.

View source npm package

30-second setup

Two flavors, depending on whether you already have a Toreador account.

Free

Anonymous

No account needed. Native tokens only (BTC, ETH, SOL, POL, USDC on Solana). Rate-limited per IP (50 req/h, 200/day).

{
  "mcpServers": {
    "toreador": {
      "command": "npx",
      "args": ["-y", "@toreador/mcp-server"]
    }
  }
}

Recommended

Pro

With API key

ERC-20 sessions, status polling, history, higher rate limit (100 req/h, no daily cap).

{
  "mcpServers": {
    "toreador": {
      "command": "npx",
      "args": ["-y", "@toreador/mcp-server"],
      "env": {
        "TOREADOR_API_KEY": "tdr_..."
      }
    }
  }
}

Generate a Pro API key in your dashboard.

Tools exposed

The MCP server exposes the following tools. Tier indicates whether a Pro API key is required.

Tool	Tier	Description
`toreador_generate_qr`	Free	Generate a payment QR code for a native token (BTC, ETH, SOL, POL) or USDC on Solana. Returns a data-URL ready to display.
`toreador_create_session`	Pro	Create an ERC-20 stablecoin payment session (USDC, USDT, EURC on Ethereum, Polygon, Base) with hosted payment page and webhook events.
`toreador_get_session_status`	Pro	Poll the status of an existing payment session (pending, submitted, confirming, completed, expired, failed).
`toreador_list_sessions`	Pro	List recent payment sessions for the authenticated account, with filters by status and pagination.
`toreador_check_compatibility`	Pro	Check whether a given token + chain pair is supported, before attempting to generate a QR or session.

Compatible hosts

Any MCP-capable client. Same JSON config everywhere — only the location of the file changes.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add the snippet below. Restart the app — Toreador appears in the tools panel.

Cursor

Settings → MCP → New MCP server. Paste the same JSON, scope project or global.

Windsurf

Settings → Cascade → MCP Servers → Edit JSON. Same config.

Other MCP-capable hosts

Any client that speaks Model Context Protocol over stdio can launch the server with `npx -y @toreador/mcp-server`.

Why MCP rather than the REST API?

MCP and the REST API serve different audiences. Use the REST API when you're writing backend code that needs deterministic behavior — checkout pages, cron jobs, payment processors. Use the MCP server when a human (or an AI agent on their behalf) wants to generate a QR ad-hoc, in conversation, without writing code.

The same backend powers both. Anything you can do via MCP, you can also do via REST. The MCP server is just a thin stdio adapter that translates tool calls from your assistant into HTTPS calls to the Toreador API.

Ready to plug your AI into crypto payments?

Start free, no card. Upgrade to Pro from your dashboard when you need ERC-20 stablecoin sessions or webhooks.

Install the package See pricing