Mcp Server

STDIOregistry active

Summary

Connects Claude to Toreador's crypto payment API so your assistant can generate payment QR codes for Bitcoin, Ethereum, Solana, and stablecoins, plus manage hosted ERC-20 payment sessions. You get five tools: generate native token QRs with embedded amounts and addresses, create hosted sessions for USDC/USDT/EURC on EVM chains, poll payment status, and list recent QR codes or sessions. Runs locally via stdio and calls toreador.io with your Pro plan API key. Useful when you're building invoicing workflows, accepting crypto donations, or prototyping payment flows and want to script the QR generation and session tracking without leaving your editor or chat window.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

@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

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

@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

Mcp Server

@toreador/mcp-server

Tools exposed

Install in Claude Desktop

Install in Cursor

Example prompts

Configuration

Trust and safety

Build from source

License

Mcp Server

@toreador/mcp-server

Tools exposed

Install in Claude Desktop

Install in Cursor

Example prompts

Configuration

Trust and safety

Build from source

License

Related Finance & Commerce MCP Servers

Related Finance & Commerce MCP Servers