[0.13.1] - 2026-04-25
Added
- Initial release: MCP (Model Context Protocol) stdio server exposing read-only burn ledger queries for in-session self-query by the running agent (#26).
startStdioServer({sessionId?, tools?, ...})— minimal JSON-RPC 2.0 MCP server over stdio. No external SDK dependency.buildMcpConfig({sessionId, burnBin?})— returns a JSON string for Claude Code's--mcp-configflag. Registersburn mcp-server --session-id <id>as theburnserver.- Built-in tools:
burn__sessionCost({ sessionId? })— returns{totalUSD, totalTokens, turnCount, models}for the session. Session id defaults to the--session-idbaked into the server at spawn time.burn__currentBlock({ sessionId? })— returns the Claude OAuth-reported 5-hourpercentUsedplus a locally-forecastburnRateTokensPerMin,projectedBlockTotal, andminutesToResetwith a coarseadvicelabel.
- Read-only by construction: no MCP tool writes to the ledger.