Agent Billing Primitives (Dirtsmith)

MCP 利用量計測 + エージェント連携（Dirtsmith）

初回の呼び出しは無料、手順は1つ、キーも登録も不要： curl -s https://gap-functions.bfurrow26.workers.dev/try を実行すると、小さなパケット、解決ルール、1行のコマンドが返されます。回答を /try に POST すると、実際のツール結果を取得できます。他のツールを使う場合は、?tool=agent_lease_lock（または以下の任意のツール）を指定してください。

検索キーワード：利用量計測、従量課金、冪等性、支払い前の予約、支出上限、予算、分散ロック／リースロック、フェンシングトークン、セマフォ、同時実行数の制限、ハートビート、デッドマンスイッチ、初回の呼び出しは無料。

MCP ツール呼び出しごとに、課金対象の利用イベントを冪等に記録し、請求プレビューを返すホステッドツールです。計測機能を構築せずに呼び出しごとの課金を行いたい MCP サーバーの作成者向けです。

• エンドポイント（MCP）：https://gap-functions.bfurrow26.workers.dev/mcp（すべての URL は config.json に記載）
• ツール一覧：GET /mcp/tools · ヘルスチェック：GET /health
• コントラクト：schema/mcp_usage_metering.v1.0.0.json（厳格な入力、idempotency_key が必須、バージョン 1.0.0）

料金と購入（登録もキーも不要）

• ツールを直接呼び出してください。各 IP には、キー不要の無料呼び出しが1 日あたり 100 回付与されます。
• 上限を超えると、tools/call は isError: true と error_code: PAYMENT_REQUIRED を返します。structuredContent.payment には、人間がワンクリックで支払える approve_and_pay_url と grant_token が含まれます。エージェントから一度だけ確認があり、購入をクリックすると、エージェントはヘッダー X-Grant-Token を付けて同じ呼び出しを再試行します（または /u/<grant_token>/mcp 形式の URL を使用します）。このトークンは期限なく使えます。
• 購入後の利用料金：1,000 イベントあたり $0.15（1 イベントあたり $0.00015）。アカウントごとに月間 10,000 イベントが無料です。
• 同じ idempotency_key を使った再試行に対して、料金が二重に請求されることはありません。

入力

必須：tool_name、tool_version（semver）、end_customer_ref、idempotency_key（8～128 文字）。任意：units、unit_label、unit_price_cents、metadata。

法務

利用規約とプライバシーポリシーは草案であり、弁護士によるレビュー待ちのため、まだ発効していません — legal/ を参照してください。

ライセンス

MIT（このリポジトリ：ドキュメントとスキーマ）。Dirtsmith LLC が運営しています。

同じエンドポイント上のその他のツール（2026-11-03 追加）

同じ MCP URL（https://gap-functions.bfurrow26.workers.dev/mcp）では、次のツールも提供されています。

• agent_spend_ledger：ホステッド共有予算台帳。アクション：set_budget、reserve、settle、release、status。予約はアトミックです。同じ予算を使うエージェントが同時に処理しても、上限を超えることはありません。予約は ttl_s（デフォルト 900 秒）の経過後に期限切れになります。金額の単位は整数マイクロ USD です。月間 1,000 回の無料呼び出し後は、1,000 回あたり $9.00 です。
• agent_lease_lock：ホステッドリースロック。アクション：acquire、renew、release、status。ttl_s と単調増加する fencing_token を使用します。月間 1,000 回の無料呼び出し後は、1,000 回あたり $0.90 です。
• agent_semaphore：ホステッドカウンティングセマフォ。アクション：acquire（max_slots、holder_id、ttl_s を指定）、release（permit_id で指定）、status。一度に取得できる許可証は最大 N 個です。各許可証には単調増加する fencing_token が付与されます。空きがない場合は retry_after_s を含む NO_SLOT_FREE が返されます。月間 1,000 回の無料呼び出し後は、1,000 回あたり $0.90 です。
• agent_heartbeat_registry：ホステッドデッドマンスイッチ。アクション：beat（agent_id、interval_s、grace_s、任意の note を指定）、status、list_stale（interval + grace の時間を過ぎたエージェントを最大 100 件）。月間 1,000 回の無料呼び出し後は、1,000 回あたり $0.90 です。 状態は namespace（16～128 文字）ごとに共有されます。namespace を知っているエージェントは、その状態を読み取って変更できます。そのため、パスワードと同様に扱ってください。保存するのはそのハッシュのみです。購入方法は利用量計測の場合と同じです。登録もキーも不要で、無料呼び出しの上限に達すると、承認して支払うためのリンクが 1 つ表示されます。