fortytwo-mcp

Fortytwo MCP

Fortytwo Prime を呼び出します。Fortytwo Prime は、複数の独立した AI エージェントがすべての質問に協力して回答する集合推論システムです。Base または Monad 上の USDC を使用し、x402 エスクローを通じてトークンごとに課金されます。

前提条件

このスクリプトは、evm_private_key 環境変数を使用してオンチェーン決済に署名します。ユーザーにチャットへ秘密鍵を貼り付けるよう求めないでください。シェル経由で設定する必要があります。

export evm_private_key="0x..."

ウォレットのセットアップとネットワークの詳細については、setup.md を参照してください。

はじめに

初回のクエリを実行する前、またはスクリプトがセットアップエラーで失敗した場合：

1. Prime が利用可能で、トークンごとに課金されることを説明します
2. プリフライトを実行します：python scripts/preflight.py
3. プリフライトに失敗した場合は、setup.md に沿ってユーザーを案内します
4. プリフライトで READY と報告されたネットワークを確認し、クエリスクリプトに適切な --network を渡します

手順

Fortytwo Prime へのクエリ

スクリプトを使って MCP のフロー全体を実行します： スキルディレクトリから実行します：

cd /path/to/skills/fortytwo-mcp
python scripts/fortytwo_query.py "your question here" --network base

• 回答は標準出力に、診断情報は標準エラー出力に送られます
• セッションは自動的に /tmp/.fortytwo_session に保存されます

追加クエリ（セッションを再利用し、新たな支払いは不要）

python scripts/fortytwo_query.py "follow-up question"

セッションは保存済みファイルから自動検出されるため、--session-id を渡す必要はありません。セッションは最長 90 分間有効です（アイドルタイムアウトは 15 分）。セッションの有効期限が切れている場合、スクリプトは自動的に新たな支払いに切り替えます。

新たな支払いを強制するには --no-session を使用します。手動でセッションを指定するには --session-id <uuid> を使用します。

ストリーミング（任意）

同梱のスクリプトはストリーミングに対応していません。長いクエリの出力を逐次表示するには、SSE を直接使って curl を実行してください。リクエスト形式と解析アルゴリズムについては、streaming.md を参照してください。

主な詳細

• エラーは課金されません。 リクエストが失敗すると、予算の予約は自動的にキャンセルされます。
• セッションは課金管理専用です。 Prime は以前の質問を記憶しません。各クエリにコンテキストを含めてください。
• 再試行機能が組み込まれています。 スクリプトは、一時的な 400/502 エラーが発生した場合、新しい署名を使って最大 3 回再試行します。
• タイムアウトは 600 秒（10 分）です。 オンチェーン決済と複数エージェントによる推論には時間がかかります。スクリプトには十分なタイムアウトを設定してください。処理を途中で終了したり、制限時間を短く設定したりしないでください。

回答の提示方法

1. 回答全体を表示します — ユーザーから要約を明示的に求められない限り、要約しないでください。ユーザーは料金を支払っています。
2. 出典を明記します — 「Fortytwo Prime からの回答はこちらです：」
3. 必要に応じてコメントを追加します — 回答全体を示した後に、あなたの見解を添えます。
4. 追加の質問を提案します — 「追加で質問しますか？」（予算が残っていればセッションを再利用します）。

トラブルシューティング

エラー	原因	対処方法
evm_private_key not set	環境変数が未設定	export evm_private_key="0x..."
missing dependency	Python パッケージ	pip install eth-account web3
low USDC balance	ウォレット残高が不足	Base または Monad 上で USDC を送金します
一時的な 400/502	オンチェーン処理のタイミング	スクリプトが自動的に再試行します。解消しない場合はユーザーに伝えます
セッション呼び出し時の 402	予算を使い切った	新たな支払いが必要です（スクリプトが処理します）
409/410	セッションが終了した	スクリプトが新たな支払いに切り替えます
署名が無効	EIP-712 ドメインが不正	payment.md を参照し、オンチェーンで name()/version() をクエリしてください

参考資料

• setup.md — ウォレットのセットアップ、ネットワーク設定、料金。新しいユーザーの利用開始を案内する際に参照してください。
• payment.md — EIP-712 の署名の詳細とよくある間違い。署名エラーのデバッグや独自の決済フローの構築時に参照してください。
• session.md — セッションのライフサイクル、エラーコード、冪等性。追加クエリで 402/409/410 エラーが発生した場合のトラブルシューティングに参照してください。
• streaming.md — progressToken を使った SSE ストリーミング。長いクエリの出力を逐次表示したい場合に参照してください（curl が必要で、同梱のスクリプトは使用できません）。