Toreador

What is Toreador?

This MCP server lets Claude Desktop, Cursor, and other MCP-capable assistants generate crypto QR codes and manage payment sessions via the Toreador API. It is intended for developers and users needing on‑chain payments through an AI assistant.

How to use Toreador?

Install by adding a configuration entry for the npx -y @toreador/mcp-server command and setting the TOREADOR_API_KEY environment variable. Once configured, ask your assistant prompts like “Generate a Bitcoin QR code for 0.001 BTC to [address]” and the server will call the Toreador API.

Key features of Toreador

• Generate QR codes for native tokens (BTC, ETH, SOL, POL) and Solana SPL (USDC on Solana)
• Create hosted ERC‑20 stablecoin sessions (USDC, USDT, EURC) on Ethereum, Polygon, or Base
• Poll payment session status (pending, submitted, confirming, completed, expired, failed)
• List the 50 most recent QR code generations and payment sessions
• Non‑custodial – only generates payment objects and reads state; cannot move funds

Use cases of Toreador

• Generate a Bitcoin QR code for a specific amount and address from a chat prompt
• Create a USDC payment session on Polygon and receive a hosted payment URL
• Check the status of an existing payment session
• Review recent QR code generation history
• Audit the latest ERC‑20 payment sessions

FAQ from Toreador

What do I need to use this server?

You need a Pro plan API key (format tdr_...) from your Toreador dashboard. The server runs locally via npx and requires Node.js.

Does Toreador hold my funds?

No. Toreador is non‑custodial. The MCP tools only generate QR codes and read session state – they cannot move money.

Can I delete or refund a payment with these tools?

No. There is no “delete” or “refund” tool. The tools either create new payment objects or read existing ones.

Where does my API key go?

Your API key only leaves your computer in outbound HTTPS calls to https://toreador.io/api/v1/public. The server runs locally over stdio.

What transport does the server use?

The server uses stdio (standard input/output) for MCP communication. It runs as a local process via npx.