MCP.so
Sign In

Toreador

@Logitale

About Toreador

Official Model Context Protocol (MCP) server for Toreador — generate crypto QR codes and manage payment sessions from Claude Desktop, Cursor, ChatGPT and other MCP clients.

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

5

Generate a crypto QR code for a native token (BTC, ETH, SOL, POL) or a Solana SPL token (USDC on Solana). Returns the QR data URI (PNG base64) and the on-chain payment URI (BIP21, EIP-681, Solana Pay). FREE — no API key needed for these chains. For ERC-20 stablecoins on Ethereum/Polygon/Base (USDT, USDC, EURC), use toreador_create_session (Pro plan required).

Create a hosted payment session for ERC-20 stablecoins on EVM chains (USDC, USDT, EURC on Ethereum, Polygon or Base). Returns a session ID, a 6-character security code to display to the payer, and a URL to a Toreador-hosted payment page where the payer connects their wallet. Sessions expire 15 minutes after creation. PRO PLAN REQUIRED. For native tokens or Solana SPL, use toreador_generate_qr instead.

Get the current status of an ERC-20 payment session by ID. Status values: pending, submitted, confirming, completed, expired, failed. Includes on-chain confirmation count and tx hash once submitted.

List the 50 most recent QR code generations for the authenticated account. Returns a list of payment requests with token, chain, amount, recipient and timestamp.

List the 50 most recent ERC-20 payment sessions for the authenticated account. Includes status, tx hash, confirmations and timestamps.

Overview

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.

Frequently asked questions

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`.

Comments

More Other MCP servers