Which stablecoins can be used in payment sessions?

ERC-20 stablecoins USDC, USDT, and EURC on Ethereum, Polygon, or Base networks.

Is the server custodial or does it hold funds?

It is non-custodial; it only generates QR codes and reads session states without moving funds.

How is the API key managed?

You must provide a Toreador Pro plan API key via the TOREADOR_API_KEY environment variable; the key is used locally and sent only to toreador.io.

Can I run this server without an internet connection?

No, the server requires outbound HTTPS calls to the Toreador public API.

Toreador MCP Server

Local MCP server to generate crypto payment QR codes and manage ERC-20 payment sessions via Toreador API.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server enables AI assistants to generate QR codes for native cryptocurrencies and Solana SPL tokens, create and track ERC-20 stablecoin payment sessions on Ethereum-compatible chains, and list recent transactions. It requires a Toreador Pro plan API key and runs locally, calling Toreador's public API. Use it to integrate crypto payment requests and session management into MCP-capable clients like Claude Desktop or Cursor.

Use cases

Generate QR codes for BTC, ETH, SOL, POL, and Solana USDC payments

Create hosted payment sessions for ERC-20 stablecoins on Ethereum, Polygon, or Base

Check the status of existing ERC-20 payment sessions

Retrieve recent QR code generations and payment session histories

Key features

Generate on-chain payment URIs and base64 PNG QR codes

Create and manage hosted ERC-20 stablecoin payment sessions

Poll payment session status with detailed states

List last 50 QR codes and payment sessions

Runs locally with API key security, no custody of funds

Capabilities & Tool Schemas (5)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Toreador MCP Server.

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.

Documentation Overview

@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:

config.json

{
  "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:

config.json

{
  "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

bash

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

221

Package downloads in the last 30 days.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Toreador MCP Server

Native tokens BTC, ETH, SOL, POL and Solana SPL token USDC are supported.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Toreador MCP Server AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/logitale-toreador-mcp-server?style=directory)](https://allmcps.com/mcp/logitale-toreador-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/logitale-toreador-mcp-server"><img src="https://allmcps.com/api/badge/logitale-toreador-mcp-server?style=directory" alt="Toreador MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

11/11 checks healthy over the last 33d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools26/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @toreador/mcp-server (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Toreador MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code

Toreador MCP Server

Local MCP server to generate crypto payment QR codes and manage ERC-20 payment sessions via Toreador API.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Generate QR codes for BTC, ETH, SOL, POL, and Solana USDC payments

Create hosted payment sessions for ERC-20 stablecoins on Ethereum, Polygon, or Base

Check the status of existing ERC-20 payment sessions

Retrieve recent QR code generations and payment session histories

Key features

Generate on-chain payment URIs and base64 PNG QR codes

Create and manage hosted ERC-20 stablecoin payment sessions

Poll payment session status with detailed states

List last 50 QR codes and payment sessions

Runs locally with API key security, no custody of funds

Capabilities & Tool Schemas (5)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Toreador MCP Server.

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.

Documentation Overview

@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:

config.json

{
  "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:

config.json

{
  "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

bash

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

221

Package downloads in the last 30 days.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Toreador MCP Server

Native tokens BTC, ETH, SOL, POL and Solana SPL token USDC are supported.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/logitale-toreador-mcp-server?style=directory)](https://allmcps.com/mcp/logitale-toreador-mcp-server)

HTML Embed

<a href="https://allmcps.com/mcp/logitale-toreador-mcp-server"><img src="https://allmcps.com/api/badge/logitale-toreador-mcp-server?style=directory" alt="Toreador MCP Server on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

11/11 checks healthy over the last 33d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools26/30

Adoption & activity4/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @toreador/mcp-server (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Toreador MCP Server →Install in Claude Desktop Install in Cursor Install in VS Code