ForgingStack Quorum

ForgingStack Quorum

エージェントが単独で行動する前に、定足数を確保しましょう。1件の提案、N件の承認、1件のレシート。

mcp-name: io.github.jdkabattles/forgingstack-quorum

これは Quorum の公開クライアントです。サービス本体（承認フロー、レシートチェーン、キーストア、請求）は ForgingStack のプライベートサービス上で稼働しており、このリポジトリには含まれていません。 このリポジトリをコピーしてもサービスは利用できません。以下から登録して API キーとクレジットを入手する必要があります。

ライブ API：https://forgingstack-quorum.jkbattles.workers.dev

仕組み

1. 実行するアクションを提案し、承認者を指定して、必要な承認数（N）と提案の有効期限を設定します。
2. 各承認者に、1回限りのリンクがメールで届きます。承認は無料です。
3. 定足数に達すると提案が承認され、ハッシュチェーンによるレシートが発行されます。それより先に有効期限が切れた場合は、期限切れとなります。レシートは発行されず、その後に提案を承認することもできません。
4. 保留中の提案は、自分で却下することもできます。

このサービスが行わないこと：アクションが賢明か、合法か、安全かを判断することです。Quorum が担うのは定足数の確保のみで、それ以外は承認者が判断します。

登録

curl -X POST https://forgingstack-quorum.jkbattles.workers.dev/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

API キーと初回利用時の 100 クレジットが返されます。キーは一度しか表示されないため、すぐに保存してください。キーはハッシュとしてのみ保存され、再表示できません。 キーを使って提案を作成する前に、登録確認メールのリンクをクリックしてください（メールが届かない場合は、迷惑メールフォルダーを確認するか、POST /v1/verify/resend を実行してください）。

提案を作成する

curl -X POST https://forgingstack-quorum.jkbattles.workers.dev/v1/proposals \
  -H "X-API-Key: YOUR_PRIMARY_KEY" -H "Content-Type: application/json" \
  -d '{"action":"deploy the new build","approvers":["[email protected]","[email protected]"],"required_approvals":2,"expires_at":"2027-01-01T00:00:00Z"}'

承認状況と、承認メールの送信先を含む提案（201）が返されます。GET /v1/proposals/{id} で内容を取得し、GET /v1/proposals で自分の提案を一覧表示できます。保留中の提案は POST /v1/proposals/{id}/reject で却下できます。 承認者はメール内のリンクをクリックして承認します。各リンクは1回のみ使用できます。発行されたレシートは GET /v1/receipts/{id} で取得できます。

使用方法（MCP、stdio）

キーを設定してから、このリポジトリの MCP サーバーを実行します。

export FORGINGSTACK_API_KEY="your-key-here"
python -m app.mcp_server

ツール：create_proposal、get_proposal、get_credits、get_receipt。 使用する状況と使用しない状況については、SKILL.md を参照してください。

料金

提案1件につき1クレジットです。承認は無料です。登録時に初回利用分として100クレジットが付与されます。POST /v1/billing/checkout（Payment Link）から、1,000クレジットを10ドルで購入できます。支払いの確認後、通常1時間以内にクレジットが付与されます。

このリポジトリ内のファイル

• app/mcp_server.py — MCP ラッパークライアント（stdio、標準ライブラリのみ）
• SKILL.md — 使用する状況と結果の読み方
• agent-card.json — A2A 形式のディスカバリーカード
• server.json — MCP Registry のメタデータ
• pyproject.toml — MCP クライアントのパッケージメタデータ
• llms.txt — 言語モデル向けの簡易インデックス