ForgingStack Mandate Check

ForgingStack Mandate Check

エージェントが動作する前に、権限を確認してください。1 回の呼び出しで、1 つのレシートが発行されます。

mcp-name: io.github.jdkabattles/forgingstack-mandate-check

これは Mandate Check の公開クライアントです。サービス自体（判定ロジック、レシートチェーン、キーストア、課金）は ForgingStack のプライベートサービス上で動作しており、このリポジトリには含まれていません。このリポジトリをコピーしてもサービスは利用できません。下記から登録して API キーとクレジットを入手する必要があります。

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

確認項目と順序

1. 権限の対象エージェントが、呼び出し元のエージェントと一致する
2. 権限の主体が、エージェントが代理する主体と一致する
3. 権限の有効期限が解析可能で、未来の日時である
4. アクションが、権限で許可されたアクションに含まれている

成功または失敗の理由と、ハッシュチェーンで連結されたレシートが返されます。

確認しないこと：アクションが賢明か、合法か、安全かどうかです。確認するのは権限との適合性のみです。

登録（v1）

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

API キーと 100 クレジットの初回特典が一度だけ返されます。キーはハッシュとしてのみ保存され、再表示できないため、すぐに保存してください。 メール認証は保留中で、クレジットパックの課金もまだ利用できません。そのため、v1 では購入フローを利用できません。

エージェント用サブキー

登録したユーザーは、エージェントごとに上限付きで取り消し可能なキーを作成できます。

curl -X POST https://forgingstack-mandate-check.jkbattles.workers.dev/v1/keys \
  -H "X-API-Key: YOUR_PRIMARY_KEY" -H "Content-Type: application/json" \
  -d '{"agent_name":"my-agent","credits":20}'

GET /v1/keys で一覧表示し、DELETE /v1/keys/{id} で取り消します。取り消すと、未使用のクレジットがメインアカウントに返されます。

使い方（MCP、stdio）

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

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

ツール：check_mandate、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 のメタデータ（PyPI への公開まではドラフト）
• pyproject.toml — MCP クライアントのパッケージメタデータ