Agent Billing Primitives (Dirtsmith)

Name: Agent Billing Primitives (Dirtsmith)
Author: throttler300

远程服务

github.com/throttler300开发工具02 天前更新

代码仓库

关于 Agent Billing Primitives (Dirtsmith)

Agent Billing Primitives 是面向 MCP 服务作者和 Agent 运营者的托管 MCP 服务，提供用量计量和共享协调状态。它以幂等方式记录计费事件，并在同一端点提供支出预算、租约锁、信号量和心跳检查。

主要功能

01幂等用量计量和发票预览
02原子化共享支出预留
03带 fencing token 的租约锁
04通过信号量限制并发
05Agent 心跳和超时检查

适用场景

01为 MCP 服务中的计费调用计量
02让并发 Agent 遵守共享预算
03协调独占任务或限制并发任务
04检测停止发送心跳的 Agent

MCP 相关

托管端点向 MCP 客户端提供用量计量和 Agent 协调工具，包括事件记录、共享预算、租约锁、信号量和心跳状态。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://gap-functions.bfurrow26.workers.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http throttler300-mcp-usage-metering https://gap-functions.bfurrow26.workers.dev/mcp

Cursor.cursor/mcp.json

{"mcpServers":{"throttler300-mcp-usage-metering":{"type":"http","url":"https://gap-functions.bfurrow26.workers.dev/mcp"}}}

在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"throttler300-mcp-usage-metering":{"type":"http","url":"https://gap-functions.bfurrow26.workers.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json

{"mcpServers":{"throttler300-mcp-usage-metering":{"type":"http","url":"https://gap-functions.bfurrow26.workers.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"throttler300-mcp-usage-metering":{"serverUrl":"https://gap-functions.bfurrow26.workers.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

MCP 使用量计量 + Agent 协调（Dirtsmith）

首次调用免费，只需一步，无需密钥或注册： curl -s https://gap-functions.bfurrow26.workers.dev/try 会返回一个简短数据包、解决规则和一行命令。将答案 POST 回 /try，即可获得真实工具结果。对其他工具使用 ?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 每天可免费调用 100 次，无需密钥。
超出后，tools/call 会返回 isError: true，并附带 error_code: PAYMENT_REQUIRED。structuredContent.payment 中包含一个供真人使用的一键式 approve_and_pay_url 和 grant_token。你的 Agent 会询问你一次；点击购买后，Agent 会使用请求头 X-Grant-Token（或 /u/<grant_token>/mcp URL 形式）重试同一调用。该令牌永久有效。
购买后的使用量：每 1,000 个事件 $0.15（$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（本仓库：文档和 schema）。由 Dirtsmith LLC 运营。

同一端点上的更多工具（2026-11-03 新增）

同一个 MCP URL（https://gap-functions.bfurrow26.workers.dev/mcp）还提供：

agent_spend_ledger：托管共享预算账本。操作：set_budget、reserve、settle、release、status。预留是原子操作：多个 Agent 同时使用同一预算时，绝不会超出上限。预留会在 ttl_s（默认为 900 秒）后过期。金额以整数微美元计。每月 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；名额已满时返回 NO_SLOT_FREE 和 retry_after_s。每月 1,000 次免费调用后，每 1,000 次调用收费 $0.90。
agent_heartbeat_registry：托管失效保护开关。操作：beat（使用 agent_id、interval_s、grace_s，可选 note）、status、list_stale（列出超过间隔 + 宽限期的 Agent，最多 100 个）。每月 1,000 次免费调用后，每 1,000 次调用收费 $0.90。状态按 namespace 共享（16–128 个字符）。任何知道该命名空间的 Agent 都可以读取和更改该状态，因此请将其视为密码。我们只存储其哈希值。购买方式与计量工具相同：无需注册或密钥，免费调用用完后会提供一个一键式批准并付款链接。