aanet_get_remaining_balance
Free (never charged): how much this key can still spend, so you can stop before a 402 instead of discovering it mid-sequence — the MCP counterpart of the REST X-AANet-Remaining-Balance header. Takes only the key; works for the owner_key or any sub-key, against itself.
Returns `remaining` (what you can actually spend: the lower of the two
limits below), `key_budget_remaining` (this key's budget_cap minus what it
has spent; null if the key has no cap), `key_window_remaining` (units left
under the key's spend_limit_per_hour/day, whichever is tighter; null if it
has neither) and `workspace_balance` (the shared workspace balance), all in
raw integer units ($0.00001 each). `remaining` is the lowest of the three.
Comparing them tells you which one runs out first.Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"api_key": "<api_key>"
},
"name": "aanet_get_remaining_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | Yes | Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403. |