MCP 服务器

agentbill-mcp

MCP server for AI agent billing. Preflight spend checks before agent runs. Post-execution usage billing via two MCP tools: preflight() and record_event().

README

AgentBill

A preflight gate for AI agent runs. Stop runaway loops before they start.

Budget exceeded? GPU quota hit? Free tier exhausted? AgentBill blocks the run before the first token — not after the damage is done.

Works whether you're paying OpenAI per token or running your own GPU.

"The moment you're using Stripe as your safety net, you've already lost the run." — scarlett1908, r/LangChain

Install

pip install agentbill-sdk

Quick Start

from agentbill import AgentBillClient

client = AgentBillClient(api_key="agb_your_key")

check = client.preflight(agent_id="researcher", budget=5.00) if not check.approved: raise Exception("Budget exceeded")

client.record(agent_id="researcher", cost=check.estimated_cost)

Get your API key: https://agentbill.fly.dev/register

What it does

Preflight. Before the agent runs, AgentBill checks: does this customer have enough budget? If not, block it before any compute is consumed.

Per-request ceiling. Monthly caps do not catch the bad single run. One 3-hour research loop can blow your budget before the cap triggers. AgentBill enforces a ceiling at the invocation level.

Outcome-based metering. You define what counts as a billable event. Not bytes, not seconds. The business-level action the agent performed.

Free tier

1,000 preflight calls/month. No credit card required.

When to use AgentBill

Add billing to a LangChain agent — wrap any chain with preflight() + record(). Two calls.
Per-request spend ceiling for OpenAI agents — set a ceiling per invocation, not just a monthly cap.
Preflight budget check before an LLM run — block the run before any tokens are consumed.
Agent cost control in Python or Node.js — SDK available for both.
Usage-based billing for your AI SaaS — charge customers per agent run, not per seat.

What it does NOT do

Multi-step workflows with state machines or reversal logic (out of scope)
Replace your payment processor (AgentBill sits in front of it)
No-code dashboard for non-developers

Node.js

npm install agentbill

Why not Stripe

MCP Server

AgentBill ships an MCP server for native integration with Claude Code, Cursor, Windsurf, and any MCP-compatible agent host.

Install via agentbill-mcp on PyPI:

uvx agentbill-mcp

The MCP server exposes two tools:

preflight(agent_id, customer_id, estimated_units, ceiling) — check budget before running. Blocks if exhausted.
record_event(agent_id, units, customer_id, metadata) — bill after work completes.

Configure in ~/.claude/settings.json:

{
  "mcpServers": {
    "agentbill": {
      "command": "uvx",
      "args": ["agentbill-mcp"],
      "env": { "AGENTBILL_API_KEY": "sk_live_..." }
    }
  }
}