Account

Check balance

account_balance · Reads only · Markdown

The balance, this key's daily budget, auto-reload, and how much of the month's free reads and downloads is used.

Free

This tool costs nothing to call.

An example

How much credit do we have left, and is automatic top-up switched on?

Your agent callsaccount_balanceFree

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "balance_usd": "$51.00",
  "bought_credit_usd": "$50.00",
  "free_and_bonus_credit_usd": "$1.00",
  "reserved_usd": "$0.00",
  "daily_budget_usd": "$100.00",
  "monthly_ceiling_usd": "$100.00",
  "auto_reload": "off",
  "free_this_month": {
    "reads": {
      "free": 1000000,
      "used": 0,
      "bought": 0,
      "price_after": "$0.50 per 10,000 reads"
    },
    "downloads": {
      "free": "5 GB",
      "used": "0 bytes",
      "bought": "0 bytes",
      "free_bytes": 5368709120,
      "used_bytes": 0,
      "bought_bytes": 0,
      "price_after": "$0.30 per GB"
    },
    "resets_at": "2026-11-01T00:00:00+00:00"
  }
}

Use it when

Before a call that costs more than a few cents, or when the owner asks how much credit is left.

What it does

The account balance, how much of it is credit bought (AI visibility and the phone run only on that) and how much free and bonus credit, what running calls are holding, this key's daily budget, the auto-reload state, and how much of this month's free reads and downloads is used.

What comes back

The balance and what running calls are holding, in USD, this key's daily budget, the business's monthly ceiling, the auto-reload state (off, pending, active or failed), and free_this_month: the reads and downloads the month gives free, how many are used and bought, the price after them, and when the month resets. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call account_balance on https://api.conecto.chat/mcp/account. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/account_balance \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md