Tools/Account (free)

account.balance

freeread-only

FREE (0 credits). Return this API key's credit balance (free + paid), USD value, and top-up URL. Call this to self-monitor before/after spending — checking your balance never costs credits.

Parameters#

No parameters. Call it with an empty argument object.

Example call#

bash

curl -X POST https://arkolith.com/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "account.balance",
    "arguments": {}
  }
}'

REST mirror: GET /credits, metered identically.

Example response#

json

{
  "credits": { "free": 940, "paid": 0, "total": 940 },
  "usd_value": 9.4,
  "credit_to_usd": 0.01,
  "topup_url": "https://arkolith.com/account/credits"
}

Free tool

This call costs 0 credits. Use it freely.

account.balance

Parameters#

Example call#

Example response#

Related tools#