ForgingStack Ration

ForgingStack Ration

1 つのクォータプールで、多数のエージェントを超過なしに管理します。

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

これは Ration のパブリッククライアントです。トークンバケット、レシートチェーン、キーストア、課金を含むサービス本体は、ForgingStack のプライベートサービスで稼働しており、このリポジトリには含まれていません。 このリポジトリをコピーしてもサービスは利用できません。下記から登録して API キーとクレジットを取得する必要があります。

稼働中の API：https://forgingstack-ration.jkbattles.workers.dev

機能

プリンシパルは、容量、補充率、エージェントごとの上限、バースト上限を設定してプールを作成します。エージェントはプールからユニットを引き出します。 プールは上限を適用し、引き出しの試行ごとにハッシュチェーン化されたレシートを発行します。許可された場合も拒否された場合も発行されます。

以下の場合、引き出しは拒否されます。

• ユニット数がバースト上限を超える場合（draw_exceeds_burst）
• プールで利用可能なユニットが不足している場合 （pool_insufficient_units）
• 直近 60 分間にエージェントが許可された引き出しを行うと、エージェントごとの上限を超える場合 （per_agent_cap_exceeded）

エージェントごとの上限の対象期間は、暦上の時間枠ではなく、仕様として定められたローリング 60 分間です。

登録（v1）

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

API キーは一度だけ返され、スタータークレジットが 100 付与されます。キーは直ちに保存してください。キーはハッシュとしてのみ保存され、再表示できません。 キーでプールを作成したり引き出したりする前に、登録メールに記載された確認リンクをクリックしてください。それまでは、プールの作成と引き出しは 403 email_not_verified を返します。

クレジットの追加購入

プール作成ごとに 1 クレジット、引き出しの呼び出しごとに 1 クレジット（許可・拒否を問いません）。チャージ、プールの読み取り、プール一覧の取得、削除は無料です。

curl -X POST https://forgingstack-ration.jkbattles.workers.dev/v1/billing/checkout \
  -H "X-API-Key: YOUR_PRIMARY_KEY"

Stripe の決済リンクが返されます。1,000 クレジットで 10 ドルです。 登録時と同じメールアドレスを使って、Stripe のホスト型ページで支払ってください。 支払いが確認されると（1 時間以内）、クレジットが反映されます。

利用方法（MCP、stdio）

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

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

ツール：create_pool、draw、get_pool、list_pools、 topup_pool、delete_pool、get_credits、get_receipt。 使うべき場合と使うべきでない場合については、SKILL.md を参照してください。

料金

プール作成ごとに 1 クレジット。引き出しの呼び出しごとに 1 クレジットです。拒否された引き出しにも 1 クレジットかかります。引き出しの処理が実行されるためです。同じ Idempotency-Key を使った冪等な再試行は無料で、元のレシートが返されます。

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

• app/mcp_server.py — MCP ラッパークライアント（stdio、標準ライブラリのみ）
• SKILL.md — 利用すべき場合と、許可・拒否の確認方法
• agent-card.json — A2A 形式の検出カード
• server.json — MCP Registry のメタデータ
• pyproject.toml — MCP クライアントのパッケージメタデータ