Toreador

@toreador/mcp-server

Toreador の公式 Model Context Protocol サーバーです。 Claude Desktop、Cursor など、MCP 対応のアシスタントを使って、暗号資産の QR コードを生成し、支払いセッションを代わりに管理できます。

⚠️ Toreador の ダッシュボードから取得したPro プランの API キー（tdr_...）が必要です。MCP サーバーはローカルで実行され、キーを使って https://toreador.io/api/v1/public を呼び出します。

公開されるツール

ツール	機能
toreador_generate_qr	ネイティブトークン（BTC、ETH、SOL、POL）または Solana SPL（Solana 上の USDC）の QR コードを生成します。オンチェーン決済 URI と base64 PNG データ URI を返します。
toreador_create_session	Ethereum、Polygon、Base 上の ERC-20 ステーブルコイン（USDC、USDT、EURC）のホスト型決済セッションを作成します。セッション ID、セキュリティコード、ホスト型決済 URL を返します。
toreador_get_payment_status	ERC-20 決済セッションのステータスを確認します。ステータスは pending / submitted / confirming / completed / expired / failed です。
toreador_list_history	直近 50 件の QR コード生成履歴を一覧表示します。
toreador_list_sessions	直近 50 件の ERC-20 決済セッションを一覧表示します。

Claude Desktop へのインストール

Claude Desktop の設定ファイルを編集します。

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

mcpServers の下に toreador エントリを追加します。

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

Claude Desktop を再起動します。ツールメニューに Toreador の 5 つのツールが表示されます。

Cursor へのインストール

Cursor の設定 → MCP →「Add new MCP server」で、以下を貼り付けます。

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

プロンプトの例

インストール後、MCP クライアントで次のプロンプトを試してください。

• 「bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh 宛てに 0.001 BTC の Bitcoin QR コードを生成して。」
• 「0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 宛てに、Polygon 上で 50 USDC の決済セッションを作成して。」
• 「セッション ses_123 のステータスは？」
• 「直近 10 件の決済セッションを表示して。」

アシスタントは適切なツールを選んで Toreador を呼び出し、結果を返します。 その結果には QR コードのデータ URI も含まれ、ほとんどのクライアントではインラインで表示できます。

設定

環境変数	デフォルト	説明
TOREADOR_API_KEY	必須	Pro プランの API キーです。形式：tdr_...。
TOREADOR_BASE_URL	https://toreador.io/api/v1/public	API のベース URL を上書きします（テストに便利です）。
TOREADOR_TIMEOUT_MS	30000	リクエストごとのタイムアウト（ミリ秒）です。

信頼性と安全性

• ローカルのみ。 MCP サーバーは stdio 経由でお使いのマシン上で実行されます。API キーがコンピューターの外部に送信されることはありません。ただし、toreador.io への HTTPS リクエストには使用されます。
• ノンカストディアル。 Toreador が資金を保有することはありません。MCP ツールは QR コードを生成し、セッションの状態を読み取るだけで、送金することはできません。
• 読み取りまたは作成のみ。削除はできません。 ツールは新しい決済オブジェクトを生成するか、既存のものを読み取ります。「削除」または「返金」ツールはありません。

ソースからビルド

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

サーバーが起動し、[toreador-mcp] ready (5 tools registered) を stderr に出力して、stdin で MCP リクエストを待ち受けます。

ライセンス

MIT