Guides

MCP and JSON

Two machine-readable surfaces: a JSON document for scripts, and an MCP server so an agent can ask about its own behaviour.

JSON

$ actualis --json --days 30 | jq '.cost_usd'

Redaction is on by default, including in --json. Every top-level key is documented in docs/json.md, and a test asserts that no key can be added without documenting it.

Two keys are worth knowing about because they qualify the numbers rather than report them:

• unknown_models — models seen with no pricing entry. Billed at Opus-tier rates and excluded from confident totals.
• aggregator_priced_models — models priced from a third party because the vendor publishes no rate for that id. The rate is probably right; nobody authoritative has said so.

MCP server

$ actualis --mcp

Runs as an MCP server over stdio, exposing the same read-only data to an agent that the CLI shows a human. Point your agent's MCP configuration at that command.

It is the same code path and the same redaction. An agent querying Actualis cannot see credential values that a human running the CLI could not.