Bookkeeping

List bank rules

books_list_bank_rules · Reads only · Markdown

Lists the bank rules in the order they are tried, with where they book and how often they were used.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which bank rules do we have, and which ones are never used?

Your agent callsbooks_list_bank_rulesFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "rules": [
    {
      "name": "Bank fees",
      "direction": "out",
      "when": [
        {
          "field": "counterparty",
          "op": "contains",
          "value": "Haspa"
        }
      ],
      "match": "all",
      "amount_min": null,
      "amount_max": null,
      "bank_account": null,
      "parts": [
        {
          "account": "6100",
          "tax": null,
          "percent": "100"
        }
      ],
      "description": null,
      "position": 100,
      "times_used": 0,
      "last_used_at": null
    }
  ]
}

Use it when

Before saving a rule, or to see why a line was suggested as it was.

What it does

The bank rules, in the order they are tried: their conditions, where they book, and how often and when each was last used.

What comes back

rules: each with its name, direction, conditions, amount range, bank account, parts, description, position, times used and last used. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call books_list_bank_rules on https://api.conecto.chat/mcp/books. Over REST:

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

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
no_books409The business keeps no books yet.Set them up with books_setup (base currency, start date).

Give this to your agent.

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