{
  "markdown": "# @toreador/mcp-server\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for\n[Toreador](https://toreador.io). Lets Claude Desktop, Cursor, and any other\nMCP-capable assistant generate crypto QR codes and manage payment sessions on\nyour behalf.\n\n[![toreador-mcp-server MCP server](https://glama.ai/mcp/servers/Logitale/toreador-mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/Logitale/toreador-mcp-server)\n\n> ⚠️ Requires a **Pro plan API key** (`tdr_...`) from your Toreador\n> [dashboard](https://toreador.io/dashboard#api). The MCP server runs locally\n> and uses your key to call `https://toreador.io/api/v1/public`.\n\n## Tools exposed\n\n| Tool | What it does |\n|---|---|\n| `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. |\n| `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. |\n| `toreador_get_payment_status` | Poll the status of an ERC-20 payment session: `pending` / `submitted` / `confirming` / `completed` / `expired` / `failed`. |\n| `toreador_list_history` | List the 50 most recent QR code generations. |\n| `toreador_list_sessions` | List the 50 most recent ERC-20 payment sessions. |\n\n## Install in Claude Desktop\n\nEdit Claude Desktop's config file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\nAdd the `toreador` entry under `mcpServers`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toreador\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@toreador/mcp-server\"],\n      \"env\": {\n        \"TOREADOR_API_KEY\": \"tdr_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see the 5 Toreador tools in the tools menu.\n\n## Install in Cursor\n\nIn Cursor settings → MCP → \"Add new MCP server\", paste:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@toreador/mcp-server\"],\n  \"env\": { \"TOREADOR_API_KEY\": \"tdr_...\" }\n}\n```\n\n## Example prompts\n\nOnce installed, try these prompts in your MCP client:\n\n- *\"Generate a Bitcoin QR code for 0.001 BTC to bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh.\"*\n- *\"Create a USDC payment session for 50 USDC on Polygon to 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18.\"*\n- *\"What's the status of session ses_123?\"*\n- *\"Show me my last 10 payment sessions.\"*\n\nThe assistant will pick the right tool, call Toreador, and return the result —\nincluding the QR code data URI which most clients can render inline.\n\n## Configuration\n\n| Environment variable | Default | Description |\n|---|---|---|\n| `TOREADOR_API_KEY` | **required** | Your Pro plan API key. Format: `tdr_...`. |\n| `TOREADOR_BASE_URL` | `https://toreador.io/api/v1/public` | Override the API base URL (useful for testing). |\n| `TOREADOR_TIMEOUT_MS` | `30000` | Per-request timeout in milliseconds. |\n\n## Trust and safety\n\n- **Local only.** The MCP server runs on your machine via stdio. Your API key\n  never leaves your computer except in outbound HTTPS calls to `toreador.io`.\n- **Non-custodial.** Toreador never holds funds. The MCP tools only generate\n  QR codes and read session state — they cannot move money.\n- **Read or create, no destruction.** Tools either generate new payment objects\n  or read existing ones. There is no \"delete\" or \"refund\" tool.\n\n## Build from source\n\n```bash\ngit clone https://github.com/Bentonabento/toreador-sdk.git\ncd toreador-sdk/mcp\nnpm install\nnpm run build\nTOREADOR_API_KEY=tdr_... node dist/index.js\n```\n\nThe server will boot, print `[toreador-mcp] ready (5 tools registered)` to\nstderr, and wait for MCP requests on stdin.\n\n## License\n\nMIT\n",
  "bytes": 3836,
  "sha": "2fe18671feb135d0de1bba4ac66c5d7b012e3490f188a129aa5750a9e85950a8",
  "repo_slug": "logitale/toreador-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_toreador_mcp_server_da80a2c8/readme"
}