Read spend
get_spend_summaryThe account's balance (free to spend, or sponsored when the account manager pays) and what it was charged in a month, this month so far unless one is given, from the same wallet the Spend page reads: by feature, by project, by client and by who started the work (MCP agents, pages in the app, scheduled runs), with what is still held for work running now and, on the account's own keys, what those keys paid. For the Owner and people who manage billing, also each client's month at the client price the account set for it (its own pricing toward that client, which changes nothing it is charged), and what its budget has left when one is on. Also the agent spend limit: how much one tool call may spend without asking. Only a member with spend access can read it, within their allowed projects. Free: buys nothing.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_spend_summary"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| month | No | The month to read, as YYYY-MM in UTC, as the Spend page counts months. Omit for this month so far. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| month | Yes | ||
| balance | Yes | ||
| heldUsd | Yes | ||
| byClient | Yes | ||
| bySource | Yes | ||
| byFeature | Yes | ||
| byProject | Yes | ||
| chargedUsd | Yes | ||
| clientPrices | No | ||
| agentSpendLimitUsd | Yes |