Skip to content
MCP server

ForgingStack Ration

Shared quota pool for many agents with per-agent caps and receipts

Runs locally
Install
Pricing
Freemium
Platforms
API
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

Similar MCP servers

About ForgingStack Ration

ForgingStack Ration is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Ration is a small hosted service with a thin client. The MCP server in the repository is only a stdio wrapper in Python's standard library; the token bucket, receipt chain, key store and billing run on ForgingStack's private service, so you need an API key and credits to use it.

A pool is created with a capacity, a refill rate, a per-agent cap and a burst limit. Agents draw units from it, and every draw attempt, allowed or denied, produces a hash-chained receipt. A draw is denied when it exceeds the burst limit, when the pool lacks units, or when the agent's draws inside a rolling 60-minute window would pass its cap. Replaying the same Idempotency-Key returns the original receipt at no charge.

Signup is a POST to the API and returns a key once, with 100 starter credits. Pool creation and each draw cost one credit, including denied draws, and a $10 pack buys 1,000 credits.

Install

Run in a terminal

claude mcp add forgingstack-ration --env FORGINGSTACK_API_KEY='<FORGINGSTACK_API_KEY>' -- uvx forgingstack-ration

Add to claude_desktop_config.json

{
  "mcpServers": {
    "forgingstack-ration": {
      "command": "uvx",
      "args": [
        "forgingstack-ration"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "forgingstack-ration": {
      "command": "uvx",
      "args": [
        "forgingstack-ration"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "forgingstack-ration": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "forgingstack-ration"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "forgingstack-ration": {
      "command": "uvx",
      "args": [
        "forgingstack-ration"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "forgingstack-ration": {
      "command": "uvx",
      "args": [
        "forgingstack-ration"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FORGINGSTACK_API_BASERation API base URL. Live default.
  • FORGINGSTACK_API_KEYAPI key for Ration. Sign up via POST /v1/signup (key shown once).Required

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

create_pool
Creates a quota pool
draw
Draws units from a pool
get_pool
Reads a pool
list_pools
Lists pools
topup_pool
Adds units to a pool
delete_pool
Deletes a pool
get_credits
Shows remaining credits
get_receipt
Fetches a receipt

What it does

Pool limits
Each pool has a capacity, refill rate, per-agent cap and burst limit.
Hash-chained receipts
Allowed and denied draws both produce a receipt.
Rolling agent cap
Per-agent limits use a rolling 60-minute window, not a calendar one.
Idempotent draws
A repeated Idempotency-Key returns the original receipt for free.
Credit billing
One credit per pool creation or draw; top-ups and reads are free.
Denial reasons
Denials return codes such as draw_exceeds_burst and per_agent_cap_exceeded.

Good for

  • Cap how much of an API quota a team of agents can use
  • Stop one runaway agent from draining a shared budget
  • Keep an audit trail of every allowed and denied draw
  • Refill a pool at a steady rate across scheduled agents

Pricing

Freemium

100 starter credits on signup; $10 for 1,000 credits

ForgingStack Ration FAQ

Is the service open source?

Only the client is. The service itself runs privately and is not in the repository.

How much does it cost?

New keys get 100 starter credits. A $10 pack buys 1,000 credits; pool creation and each draw cost one credit.

Does a denied draw cost anything?

Yes, one credit, because the draw was performed. An idempotent replay is free.

Do I need to verify my email?

Yes. Until the verification link is clicked, creating pools and drawing return 403 email_not_verified.

Is ForgingStack Ration free?

ForgingStack Ration has a free plan, with paid plans for more usage or features.

How do I add ForgingStack Ration to Claude Code?

Run this command in your terminal: claude mcp add forgingstack-ration --env FORGINGSTACK_API_KEY='<FORGINGSTACK_API_KEY>' -- uvx forgingstack-ration

What are the best alternatives to ForgingStack Ration?

The closest alternatives to ForgingStack Ration are ForgingStack Mandate Check, Agentics, AgentPay — trust routing + spend caps for x402 agents, AgentLedger and SmartGate.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers