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.
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.
Generate your API keys in your dashboard.
Tools exposed
The MCP server exposes the following tools. All of them require an API key.
| Tool | Description |
|---|---|
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.