English Français العربية

io.toreador/mcp-server

Official registry Finance and payments

Generate crypto QR codes (BTC, ETH, SOL, USDC, USDT, EURC) and manage payment sessions.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @toreador/mcp-server
Claude Code 
claude mcp add io-toreador-mcp-server -- npx -y @toreador/mcp-server@0.2.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-toreador-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@toreador/mcp-server@0.2.6"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @toreador/mcp-server
  2. Tools exposed
  3. Install in Claude Desktop
  4. Install in Cursor
  5. Example prompts
  6. Configuration
  7. Trust and safety
  8. Build from source
  9. License

@toreador/mcp-server

Official Model Context Protocol server for Toreador. Lets Claude Desktop, Cursor, and any other MCP-capable assistant generate crypto QR codes and manage payment sessions on your behalf.

⚠️ Requires a Pro plan API key (tdr_...) from your Toreador dashboard. The MCP server runs locally and uses your key to call https://toreador.io/api/v1/public.

Tools exposed

ToolWhat it does
toreador_generate_qrGenerate a QR code for native tokens (BTC, ETH, SOL, POL) or Solana SPL (USDC on Solana). Returns the on-chain payment URI and a base64 PNG data URI.
toreador_create_sessionCreate a hosted payment session for ERC-20 stablecoins (USDC, USDT, EURC) on Ethereum, Polygon or Base. Returns a session ID, security code and a hosted payment URL.
toreador_get_payment_statusPoll the status of an ERC-20 payment session: pending / submitted / confirming / completed / expired / failed.
toreador_list_historyList the 50 most recent QR code generations.
toreador_list_sessionsList the 50 most recent ERC-20 payment sessions.

Install in Claude Desktop

Edit Claude Desktop's config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Add the toreador entry under mcpServers:

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

Restart Claude Desktop. You should see the 5 Toreador tools in the tools menu.

Install in Cursor

In Cursor settings → MCP → "Add new MCP server", paste:

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

Example prompts

Once installed, try these prompts in your MCP client:

  • "Generate a Bitcoin QR code for 0.001 BTC to bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh."
  • "Create a USDC payment session for 50 USDC on Polygon to 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18."
  • "What's the status of session ses_123?"
  • "Show me my last 10 payment sessions."

The assistant will pick the right tool, call Toreador, and return the result — including the QR code data URI which most clients can render inline.

Configuration

Environment variableDefaultDescription
TOREADOR_API_KEYrequiredYour Pro plan API key. Format: tdr_....
TOREADOR_BASE_URLhttps://toreador.io/api/v1/publicOverride the API base URL (useful for testing).
TOREADOR_TIMEOUT_MS30000Per-request timeout in milliseconds.

Trust and safety

  • Local only. The MCP server runs on your machine via stdio. Your API key never leaves your computer except in outbound HTTPS calls to toreador.io.
  • Non-custodial. Toreador never holds funds. The MCP tools only generate QR codes and read session state — they cannot move money.
  • Read or create, no destruction. Tools either generate new payment objects or read existing ones. There is no "delete" or "refund" tool.

Build from source

git clone https://github.com/Bentonabento/toreador-sdk.git
cd toreador-sdk/mcp
npm install
npm run build
TOREADOR_API_KEY=tdr_... node dist/index.js

The server will boot, print [toreador-mcp] ready (5 tools registered) to stderr, and wait for MCP requests on stdin.

License

MIT

Frequently asked questions

What is io.toreador/mcp-server?

Generate crypto QR codes (BTC, ETH, SOL, USDC, USDT, EURC) and manage payment sessions.

How do I install io.toreador/mcp-server?

It runs on your machine. In Claude Code: claude mcp add io-toreador-mcp-server -- npx -y @toreador/mcp-server@0.2.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.toreador/mcp-server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.toreador/mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.toreador/mcp-server?

It is published by Logitale. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.