Bookkeeping

List the fixed assets

books_list_assets · Reads only · Markdown

The fixed asset register: each asset's cost, accumulated depreciation and book value, what a run would book now, and the register held against the books.

Free*

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

An example

What are our vans and machines worth now, and is depreciation booked through September?

Your agent callsbooks_list_assetsFree*

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
{
  "assets": [
    {
      "number": "FA-0001",
      "name": "Service van",
      "status": "registered",
      "purchase_date": "2026-03-14",
      "cost": "36000.00",
      "account": "1500",
      "method": "straight_line",
      "averaging": "full_month",
      "life_months": 60,
      "life_years": "5",
      "rate_percent": null,
      "residual": "6000.00",
      "depreciation_start": "2026-03-14",
      "expense_account": "6950",
      "accumulated_account": "1590",
      "opening_accumulated": null,
      "accumulated": "3500.00",
      "book_value": "32500.00",
      "depreciated_through": "2026-09-30",
      "depreciation_per_month": "500.00",
      "fully_depreciated": false,
      "tracking": null,
      "description": null,
      "serial_number": null,
      "warranty_until": null
    },
    {
      "number": "FA-0002",
      "name": "Combi steamer",
      "status": "registered",
      "purchase_date": "2026-07-01",
      "cost": "12000.00",
      "account": "1500",
      "method": "declining_balance",
      "averaging": "full_month",
      "life_months": null,
      "life_years": null,
      "rate_percent": "30",
      "residual": "0.00",
      "depreciation_start": "2026-07-01",
      "expense_account": "6950",
      "accumulated_account": "1590",
      "opening_accumulated": null,
      "accumulated": "900.00",
      "book_value": "11100.00",
      "depreciated_through": "2026-09-30",
      "depreciation_per_month": "300.00",
      "fully_depreciated": false,
      "tracking": null,
      "description": null,
      "serial_number": null,
      "warranty_until": null
    }
  ],
  "count": 2,
  "totals": {
    "cost": "48000.00",
    "accumulated": "4400.00",
    "book_value": "43600.00"
  },
  "due": {
    "through": "2026-09-30",
    "amount": "0.00",
    "assets": 0
  },
  "check": [
    {
      "account": "1500",
      "name": "Equipment",
      "in_books": "48000.00",
      "in_register": "48000.00",
      "difference": "0.00"
    },
    {
      "account": "1590",
      "name": "Accumulated depreciation",
      "in_books": "4400.00",
      "in_register": "4400.00",
      "difference": "0.00"
    }
  ]
}

Use it when

Before booking depreciation or selling an asset, at a month's or year's end, or to say what the business owns and what it is worth.

What it does

The asset register: each asset's cost, accumulated depreciation, book value, how it depreciates and through which month that is booked, with totals. due: what books_depreciate would book through the end of last month. check: the register held against the books per account, like Xero's fixed asset reconciliation; a difference is a purchase not registered yet, or an asset booked out another way. asset gives one asset with its schedule (depreciation and book value per fiscal year) and the months booked.

What comes back

assets (or asset: one, with its schedule per fiscal year and the months booked), count, totals (cost, accumulated depreciation, book value), due: what books_depreciate would book through the end of last month, and check: per account, the books' balance against the register. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
assetstringThe asset's number, like "FA-0001" (books_list_assets). 1 to 20 characters.
statusstringOne of: registered,disposed,all. Default: registered.
limitinteger1 to 500. Default: 100.
offsetintegerAt least 0. Default: 0.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/books_list_assets \
  -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).
not_found404No asset has that number.Leave asset out to list them all.

Give this to your agent.

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