seatledger MCP server
Local ledger of Claude Code and Codex tokens, API-equivalent cost, limits and token-rate changes.
0 stars317 downloads/wk
Reviews
Write oneNobody has reviewed seatledger yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
seatledger tools (4)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
seatledger_plan_compareWhat this machine's last 30 days of Claude Code and Codex work would cost on each coding plan, read from the local transcripts: the Anthropic and OpenAI APIs at list prices; Claude Pro, Max 5x, Max 20x, Team standard and Team premium; ChatGPT Plus and Pro; Codex credits at OpenAI's rate card; and Copilot Pro, Pro+ and Max at GitHub's per-token AI-credit rates. Returns each client's tokens, API-equ
seatledger_rate_changesStep changes in how this machine's coding-agent requests use tokens, per client and model: tokens per request, cache-read share of prompt tokens, cache writes per cache read, tokens per user turn, the share of Claude Code cache writes made at the 1-hour lifetime, and Codex tokens per 1% of its 5-hour window. Each finding has the date it starts, the client version in use and whether that was its fi
seatledger_team_summaryThe hosted seatledger team ledger this machine created or joined (`seatledger team create` or `seatledger team join`): what the team's coding-agent seats and tokens bought, from every developer's pushed daily aggregates. Returns team totals; tables by day, month, developer, model and client; and the rate-change findings feed, each with its date, the developer, the client version and whether that w
seatledger_usage_summaryTokens and API-equivalent dollars from this machine's Claude Code and Codex transcripts, read locally. With no arguments: today by client and model, the last 7 days by day, progress against limits the user recorded with `seatledger limits set`, and the latest rate-limit readings Codex wrote to its own rollouts. With `since` or `group_by`: one table for that range, grouped by day, project folder, m
Public scan report
scanner v0.1.10 · 2026-10-09 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How seatledger compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 4
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 317
- more than 82% of 12,191 servers with a package
What its tools let an agent do: 4 read
Install seatledger in Claude Code, Cursor or VS Code
Runs npx -y seatledger on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add seatledger -- npx -y seatledger
What the publisher says
From the seatledger repository's README, as published. We do not edit it. Read it on GitHub
seatledger
What your coding-agent seats and tokens bought, from your own machine — and when the rate changed.
npx seatledgerThe picture is the real output of npx seatledger demo, which runs on synthetic history. It is regenerated by pnpm screenshot and a test fails if it drifts from what the CLI prints.
seatledger reads the transcripts Claude Code and Codex already keep on your machine and tells you:
dropping because writes moved to a shorter cache lifetime, more tokens per turn after a client update, or Codex's own 5-hour window filling faster for the same tokens — with the date and the client version where it starts.
- tokens and API-equivalent dollars by day, project folder, model and client;
- how fast you are burning toward limits you set, and when you would reach them at this rate;
- when the rate changed: the same work suddenly costing more tokens per request, cache reads
No vendor will build that last one: it is an alarm about their own rate. seatledger is MIT, has no telemetry and no runtime dependencies, and needs no account. It makes no network calls unless you create or join a team ledger — and then seatledger push sends daily aggregates only, which seatledger push --dry-run prints in full.
Commands
npx seatledger # today and the last 7 days, your limits, vendor readings
npx seatledger report --since 30d --by project # --by day | project | model | client, --since 2026-09-01
npx seatledger rates # step changes over the last 90 days (--since, --client, --model)
npx seatledger limits set --window 5h --tokens 40M # or --usd 25; --window weekly; --client codex
npx seatledger limits # your limits, burn rate, projected time to each
npx seatledger mcp # read-only MCP server on stdio
npx seatledger demo # all of the above on synthetic history
# the team ledger (optional; the only commands that send anything)
npx seatledger team create --name "Acme platform" # a free team for up to 3; prints the invite link
npx seatledger team join <invite link> --as alice # your key goes to ~/.seatledger/team.json (0600)
npx seatledger push --dry-run # exactly what would be sent; sends nothing
npx seatledger push # this machine's daily aggregates to the team
npx seatledger team #Every command takes --json, --client claude-code|codex, --claude-dir, --codex-dir, --no-cache and --quiet. Without npm: npx github:agentwares/seatledger runs the same CLI from this repository (it ships its built dist/).
What it reads
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
seatledger: common questions
- Is seatledger MCP server safe?
- Mostly: it is graded B (82/100). Read the seatledger safety report
- How do I install seatledger?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does seatledger need an API key?
- Yes. The registry entry asks for
SEATLEDGER_KEY. - Is seatledger maintained?
- The last commit was 27 days ago (2026-10-08). The latest release is v0.3.0.
- How does seatledger compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.