ForgingStack Ration

ForgingStack Ration

一个配额池，多个 Agent，不会超额。

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

这是 Ration 的公开客户端。服务本身——令牌桶、收据链、密钥存储和计费——运行在 ForgingStack 的私有服务上，不在此仓库中。 复制此仓库并不能让你获得该服务：你仍然需要 API 密钥和额度，请通过下方链接注册。

在线 API：https://forgingstack-ration.jkbattles.workers.dev

功能

主体创建一个配额池，并设置容量、补充速率、每个 Agent 的上限和突发限制。Agent 从中提取额度。配额池会强制执行这些限制，并为每次提取尝试生成一条哈希链式收据——无论允许还是拒绝。

以下情况会拒绝提取：

• 额度超过突发限制（draw_exceeds_burst）
• 配额池的可用额度不足 （pool_insufficient_units）
• Agent 在滚动 60 分钟窗口内的允许提取量 将超过每个 Agent 的上限（per_agent_cap_exceeded）

每个 Agent 的上限窗口为滚动 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 付款链接：10 美元购买 1,000 个额度。请在 Stripe 托管页面使用你注册时填写的邮箱付款。 付款验证后（通常在一小时内），额度即会到账。

使用方式（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 客户端的包元数据