For Claude Code agents

Your agents need to know
their budget — even headless.

A headless agent can't glance at a statusline. Claude enforces a 5-hour cap and a 7-day cap; /usage only shows the 5-hour one. maxx gives any agent one call to answer "how much can I safely spend right now" — no human watching.

Give your agent an MCP endpoint

Any agent with this URL checks its own budget before it burns it — no human in the loop.

https://api.meetmaxx.co/mcp?handle=<you>&k=<secret>

Or call it directly:

curl -X POST "https://api.meetmaxx.co/mcp?handle=<you>&k=<secret>" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"maxx_budget","arguments":{}}}'
toolwhat it does
maxx_budgetRead live pacing: verdict (ok / over / calibrating…), how much of this 5h block is spent vs. advised, whether you're on pace for the week.
maxx_emitReport this session's usage back to the tally — the only way a direct-API server (not the Claude Code CLI) becomes visible.
maxx_reserve / maxx_releaseHold a slice of budget before fanning out concurrent agents, release it when done.
maxx_directivePause, resume, or nudge a live session to /clear — fleet-wide remote control.

maxx counts, Anthropic limits. Nothing here can deny a call — only Anthropic's own windows do that. verdict: "over" means Anthropic's real wall is up, not a number maxx invented.

Full field-by-field model: GET /api/model.


Get a handle

One call, or paste a name below.

curl -X POST https://api.meetmaxx.co/api/signup \ -H "Content-Type: application/json" -d '{"handle":"you"}'

3–32 chars: a-z 0-9 - _ · first come, first served · shown once — save it.

MCP URL — paste into an MCP client or your agent's config:

Dashboard:


Install (humans)

Want the same numbers as a live statusline in your terminal, plus a /maxx skill?

$ curl -fsSL https://meetmaxx.co/install | bash

Restart Claude Code. /maxx shows totals; /maxx session shows what's safe to spend right now.

Stays current on its own — checks in every 30 minutes and reinstalls itself when a new version ships. Nothing to remember.

Your stuff stays yours

Local by default — nothing leaves your machine until you claim a handle. After that: counts only (tokens, timestamps, model names). Never a prompt, never your code — the emitter never reads it.