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.

30-second setup

Every tool needs an API key, included in every plan, the free plan included. There is no anonymous access.

tor_test_

Test key (sandbox)

A tor_test_… key runs every tool on test networks (Sepolia, Polygon Amoy, Base Sepolia, Solana Devnet), outside any quota. Ideal to try the integration without real funds.

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

tor_live_ · Recommended

Live key (mainnet)

A tor_live_… key creates real payment requests on mainnet. Per-minute rate and monthly quota of tracked payments depend on your plan.

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

Generate your API keys in your dashboard.

Tools exposed

The MCP server exposes the following tools. All of them require an API key.

ToolDescription
toreador_create_checkout Create a payment request in USD or EUR and get the link of its hosted payment page, where the payer picks the stablecoin and the network. The main tool to get paid.
toreador_get_payment Get a payment by its checkout or session id: status, token, network, amount, transaction hash and timeline.
toreador_list_payments List the recent tracked payments of the whole team, newest first, with status, amounts, transaction hash, reference and establishment. Paginated; can be limited to one establishment.
toreador_list_wallets List the receiving wallets registered on the account. A payment can only go to one of them.
toreador_list_establishments List the establishments of the organization. An id limits the list of payments to one point of sale, or attaches a new payment request to it.
toreador_list_tokens List the payable token and network pairs for the environment of the key (live or test).
toreador_get_account Read the account of the key: plan, environment, monthly quota used and remaining.
toreador_generate_qr Generate a direct QR code for a native coin (BTC, ETH, SOL, POL and others) or a token on Solana, as an image or as text for a terminal. The payment is not tracked.
toreador_create_session Advanced: create a tracked payment in one given stablecoin on one given network, for example exactly 100 USDC on Base, with its hosted payment page.
toreador_screen_address Screen an address against sanctions lists: clear, sanctioned or unknown.

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, order-status sync. 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 let your AI create crypto payment requests?

Start free, no card. Every plan includes the API and the SDK; upgrade from your dashboard when you need a higher quota of tracked payments.

We respect your privacy

We use analytics cookies to improve our service. These cookies are only activated with your consent. Essential cookies (authentication, language etc.) are always active.