Skip to main content
All e-conomic tools are read-only and called via tools/call over POST /economic/mcp. The connector is connected with a grant token (see Forbind e-conomic).
Endpoint: https://mcp.consile.ai/economic/mcp — e-conomic is its own named connector with only its own tools.

​
Shared list parameters

The list tools (those returning a collection) accept e-conomic’s pagination, filter and sort parameters:
​
pagesize
integer
default:"20"
Rows per page. e-conomic max is 1000.
​
skippages
integer
default:"0"
0-based page index to skip to.
​
filter
string
e-conomic filter expression, e.g. name$like:*acme* or date$gte:2025-01-01$and:date$lte:2025-12-31.
​
sort
string
Sort expression, e.g. name (asc) or -date (desc); sortable fields only.
A list result is shaped as { items: [...], pagination: { results, pageSize, skipPages, hasMore } }.
Not every list tool takes all four. list_accounting_years, list_accounting_periods and list_vat_accounts accept only pagesize / skippages (no filter / sort); list_account_entries accepts pagesize / skippages / filter but not sort. The single-resource tools (get_*, download_invoice_pdf) take their own required arguments instead.

​
Receivables & cash-flow

​
get_invoice_totals

Accounts-receivable summary in one call: drafts vs booked, booked unpaid (split overdue / not overdue) and paid amounts. Arguments: none.

​
list_invoices_overdue

Booked invoices past their due date with an outstanding balance. Arguments: shared list parameters.

​
list_customers

Customers (debtors) with name, currency, balance (outstanding), dueAmount (overdue), payment terms, group and VAT zone. Arguments: shared list parameters (use filter to search).

​
get_customer

One customer by number, including balance and dueAmount.
​
customerNumber
integer
required
The customer (debtor) number.

​
Invoices

​
list_booked_invoices

Booked (final, legal) invoices with bookedInvoiceNumber, dates, net/gross/VAT amounts, remainder (outstanding) and customer. Arguments: shared list parameters (filter by date range or customer).

​
get_booked_invoice

One booked invoice including its line items (description, quantity, prices, VAT).
​
bookedInvoiceNumber
integer
required
The booked invoice number.

​
download_invoice_pdf

Download a booked invoice as a PDF, returned base64-encoded.
​
bookedInvoiceNumber
integer
required
​
bookedInvoiceNumber
integer
​
contentType
string
application/pdf.
​
pdfBase64
string
The PDF bytes, base64-encoded.

​
list_draft_invoices

Editable draft (unbooked) invoices — no ledger effect yet. Arguments: shared list parameters.

​
Accounting

​
list_chart_of_accounts

Chart of accounts with live balances. Each row carries accountNumber, name, accountType, balance and debitCredit. Arguments: shared list parameters.

​
list_year_account_totals

All-account totals for an accounting year (one row per account) — join with each account’s accountType to build P&L / balance-sheet lines.
​
year
string
required
Accounting year as e-conomic returns it, e.g. "2024".
​
pagesize
integer
default:"20"
​
skippages
integer
default:"0"

​
get_account_year_total

Balance/movement of one account for a full accounting year — answers “balance of account X in year Y”.
​
accountNumber
integer
required
Ledger account number, e.g. 1010.
​
year
string
required

​
list_accounting_years

Fiscal years with fromDate / toDate and the year string. Arguments: pagesize / skippages.

​
list_accounting_periods

Periods of an accounting year (periodNumber, fromDate, toDate).
​
year
string
required
​
pagesize
integer
default:"20"
​
skippages
integer
default:"0"

​
list_account_entries

Posted general-ledger entries for one account in an accounting year (an account statement). Always scoped by account + year.
​
accountNumber
integer
required
​
year
string
required
​
pagesize
integer
default:"20"
​
skippages
integer
default:"0"
​
filter
string

​
Lookup & support

​
list_products

Products with productNumber, name, salesPrice, costPrice and group. Arguments: shared list parameters.

​
list_suppliers

Suppliers (creditors) for accounts-payable / spend questions. Arguments: shared list parameters.

​
list_vat_accounts

VAT codes with rates (vatCode, name, ratePercentage, account, vatType). Arguments: pagesize / skippages.

​
validate_connection

Connectivity/credential health check: an authenticated request to the API root. Use it after connecting and to detect a revoked grant. Arguments: none. 
{
  "name": "list_customers",
  "arguments": { "filter": "name$like:*acme*", "pagesize": 50 }
}
A revoked or invalid grant token returns a “reconnect required” error (the upstream responded 401/403). See Errors & limits.