Toreador

by Logitale

1 stars

379 downloads

Not rated

GitHub

Other

About

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.

Details

Author: Logitale
GitHub stars: 1
Downloads: 379
Categories: Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Toreador

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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.

`toreador_generate_qr`

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

`toreador_create_session`

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.

`toreador_get_payment_status`

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.

`toreador_list_history`

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.

`toreador_list_sessions`

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

@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

| Tool | What it does |
|---|---|
| toreador_generate_qr | Generate 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_session | Create 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_status | Poll the status of an ERC-20 payment session: pending / submitted / confirming / completed / expired / failed. |
| toreador_list_history | List the 50 most recent QR code generations. |
| toreador_list_sessions | List 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 variable | Default | Description |
|---|---|---|
| TOREADOR_API_KEY | required | Your Pro plan API key. Format: tdr_.... |
| TOREADOR_BASE_URL | https://toreador.io/api/v1/public | Override the API base URL (useful for testing). |
| TOREADOR_TIMEOUT_MS | 30000 | Per-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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

toreador_generate_qr

toreador_create_session

toreador_get_payment_status

toreador_list_history

toreador_list_sessions

Claude Desktop / Cursor

McpServers

@toreador/mcp-server

Tools exposed

Install in Claude Desktop

Install in Cursor

Example prompts

Configuration

Trust and safety

Build from source

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`toreador_generate_qr`

`toreador_create_session`

`toreador_get_payment_status`

`toreador_list_history`

`toreador_list_sessions`