About ForgingStack Ration
ForgingStack Ration is a public MCP client for a private quota service, intended for principals managing shared agent usage. It applies pool, per-agent, and burst limits, with a hash-chained receipt for every draw attempt.
Key features
- 01Create quota pools with refill settings
- 02Enforce per-agent and burst caps
- 03Draw units and report allowed or denied results
- 04Top up, inspect, list, or delete pools
- 05Retrieve draw receipts
Use cases
- 01Share a limited quota across multiple agents
- 02Track denied draws as well as successful draws
MCP support
Runs as an MCP server over stdio and wraps the private service. Its tools create and manage pools, draw units, check credits, and retrieve receipts.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx forgingstack-rationFORGINGSTACK_API_BASERation API base URL. Live default.FORGINGSTACK_API_KEYSecretAPI key for Ration. Sign up via POST /v1/signup (key shown once).Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
8Saved tool list · updated 5d ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | |
| burst_units | integer | Yes | |
| capacity_units | integer | Yes | |
| per_agent_cap_units | integer | Yes | |
| refill_units_per_minute | number | Yes |
Details
From the project READMEForgingStack Ration
One quota pool, many agents, no overruns.
mcp-name: io.github.jdkabattles/forgingstack-ration
This is the public client for Ration. The service itself — the token bucket, the receipt chain, the key store, and billing — runs on ForgingStack's private service and is not in this repo. Copying this repo does not give you the service: you still need an API key and credits, from signup below.
Live API: https://forgingstack-ration.jkbattles.workers.dev
What it does
A principal creates a pool with a capacity, a refill rate, a per-agent cap, and a burst limit. Agents draw units from it. The pool enforces the limits and issues a hash-chained receipt for every draw attempt — allowed and denied.
A draw is denied when:
- the units exceed the burst limit (
draw_exceeds_burst) - the pool does not have enough available units
(
pool_insufficient_units) - the agent's allowed draws inside the rolling 60-minute window
would exceed the per-agent cap (
per_agent_cap_exceeded)
The per-agent cap window is a rolling 60 minutes — a documented design choice, not a calendar window.
Signup (v1)
curl -X POST https://forgingstack-ration.jkbattles.workers.dev/v1/signup \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]"}'
Returns an API key once and 100 starter credits. Save the key
immediately — it is stored only as a hash and cannot be shown again.
Click the verification link in the signup email before the key can
create pools or draw: until then, pool creation and draws return
403 email_not_verified.
Buying more credits
1 credit per pool creation, 1 credit per draw call (allowed or denied). Top-ups, pool reads, pool lists, and deletes are free.
curl -X POST https://forgingstack-ration.jkbattles.workers.dev/v1/billing/checkout \
-H "X-API-Key: YOUR_PRIMARY_KEY"
Returns the Stripe Payment Link: $10 for 1,000 credits. Pay on Stripe's hosted page with the same email you signed up with. Credits land once the payment is verified (within the hour).
Use it (MCP, stdio)
Set the key, then run the MCP server in this repo:
export FORGINGSTACK_API_KEY="your-key-here"
python -m app.mcp_server
Tools: create_pool, draw, get_pool, list_pools,
topup_pool, delete_pool, get_credits, get_receipt.
See SKILL.md for when to use it and when not to.
Price
1 credit per pool creation. 1 credit per draw call — a denied draw
still costs 1 credit, the draw was performed. An idempotent replay
(same Idempotency-Key) is free and returns the original receipt.
Files in this repo
app/mcp_server.py— MCP wrapper client (stdio, stdlib only)SKILL.md— when to use it, how to read allowed/deniedagent-card.json— A2A-style discovery cardserver.json— MCP Registry metadatapyproject.toml— package metadata for the MCP client
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.