CashCtrl MCP by usefulapi is an MCP server published by io.usefulapi, hosted at cashctrl.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 28 tools, including cashctrl_list_accounts, cashctrl_get_account, cashctrl_get_account_balance, cashctrl_list_account_categories, cashctrl_list_bank_accounts.
Read CashCtrl accounts, journal, orders, people, articles, salaries and reports; book and create.
4,007 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
The chart of accounts: number, name, category and the balance for the fiscal period. Not paged. GET /account/list.json.
| Parameter | Type | Description |
|---|---|---|
| dir | string | Sort direction (each list has its own default). |
| sort | string | Column to sort by (a column name of the list reply; each list has its own default). |
| query | string | Full-text search. |
| filter | array | Column filters, all must match (AND). |
| category_id | integer | Only accounts of this category (cashctrl_list_account_categories). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| only_active | boolean | Only active accounts. |
| fiscal_period_id | integer | Fiscal period id (cashctrl_list_fiscal_periods); default is the current period. |
{
"name": "cashctrl_list_accounts",
"title": "List accounts",
"description": "The chart of accounts: number, name, category and the balance for the fiscal period. Not paged. GET /account/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (each list has its own default)."
},
"sort": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column to sort by (a column name of the list reply; each list has its own default)."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Full-text search."
},
"filter": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value"
],
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column name of the list reply."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
]
},
"maxItems": 50
}
],
"description": "Value, or an array of values (any matches)."
},
"comparison": {
"enum": [
"eq",
"like",
"gt",
"lt"
],
"type": "string",
"description": "Default like."
}
}
},
"maxItems": 10,
"description": "Column filters, all must match (AND)."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only accounts of this category (cashctrl_list_account_categories).",
"exclusiveMinimum": 0
},
"only_active": {
"type": "boolean",
"description": "Only active accounts."
},
"fiscal_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fiscal period id (cashctrl_list_fiscal_periods); default is the current period.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List accounts",
"readOnlyHint": true
}
}One account of the chart of accounts by id. GET /account/read.json.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The account id (from cashctrl_list_accounts; not the account number). |
{
"name": "cashctrl_get_account",
"title": "Get an account",
"description": "One account of the chart of accounts by id. GET /account/read.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The account id (from cashctrl_list_accounts; not the account number).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an account",
"readOnlyHint": true
}
}The balance of one account at the end of a day (default: the last day of the current fiscal period). GET /account/balance.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The account id (from cashctrl_list_accounts). |
| date | string | Balance at the end of this day, yyyy-mm-dd. |
{
"name": "cashctrl_get_account_balance",
"title": "Get an account balance",
"description": "The balance of one account at the end of a day (default: the last day of the current fiscal period). GET /account/balance.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The account id (from cashctrl_list_accounts).",
"exclusiveMinimum": 0
},
"date": {
"type": "string",
"description": "Balance at the end of this day, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Get an account balance",
"readOnlyHint": true
}
}The categories of the chart of accounts (assets, liabilities, expenses, revenue and their sub-categories). GET /account/category/list.json.
No parameters.
{
"name": "cashctrl_list_account_categories",
"title": "List account categories",
"description": "The categories of the chart of accounts (assets, liabilities, expenses, revenue and their sub-categories). GET /account/category/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List account categories",
"readOnlyHint": true
}
}The bank accounts set up in CashCtrl (name, IBAN, linked ledger account). GET /account/bank/list.json.
No parameters.
{
"name": "cashctrl_list_bank_accounts",
"title": "List bank accounts",
"description": "The bank accounts set up in CashCtrl (name, IBAN, linked ledger account). GET /account/bank/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List bank accounts",
"readOnlyHint": true
}
}Book entries of the journal (date, title, debit and credit account, amount, reference), newest first, for the current fiscal period unless fiscal_period_id is set. GET /journal/list.json.
| Parameter | Type | Description |
|---|---|---|
| dir | string | Sort direction (each list has its own default). |
| sort | string | Column to sort by (a column name of the list reply; each list has its own default). |
| limit | integer | Rows to return, 1-500 (default 100). |
| query | string | Full-text search. |
| start | integer | Index of the first row (default 0). Use next_start from the previous reply. |
| filter | array | Column filters, all must match (AND). |
| account_id | integer | Only entries of this account (cashctrl_list_accounts). |
| only_sales | boolean | Only entries created by sales orders. |
| only_manual | boolean | Only manual entries. |
| only_salary | boolean | Only entries created by salary statements. |
| associate_id | integer | Only entries of this person (cashctrl_list_persons). |
| only_imported | boolean | Only imported (bank) entries. |
| only_purchase | boolean | Only entries created by purchase orders. |
| only_collective | boolean | Only collective entries. |
| fiscal_period_id | integer | Fiscal period id (cashctrl_list_fiscal_periods); default is the current period. |
{
"name": "cashctrl_list_journal",
"title": "List journal entries",
"description": "Book entries of the journal (date, title, debit and credit account, amount, reference), newest first, for the current fiscal period unless fiscal_period_id is set. GET /journal/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (each list has its own default)."
},
"sort": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column to sort by (a column name of the list reply; each list has its own default)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows to return, 1-500 (default 100)."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Full-text search."
},
"start": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first row (default 0). Use next_start from the previous reply."
},
"filter": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value"
],
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column name of the list reply."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
]
},
"maxItems": 50
}
],
"description": "Value, or an array of values (any matches)."
},
"comparison": {
"enum": [
"eq",
"like",
"gt",
"lt"
],
"type": "string",
"description": "Default like."
}
}
},
"maxItems": 10,
"description": "Column filters, all must match (AND)."
},
"account_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries of this account (cashctrl_list_accounts).",
"exclusiveMinimum": 0
},
"only_sales": {
"type": "boolean",
"description": "Only entries created by sales orders."
},
"only_manual": {
"type": "boolean",
"description": "Only manual entries."
},
"only_salary": {
"type": "boolean",
"description": "Only entries created by salary statements."
},
"associate_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries of this person (cashctrl_list_persons).",
"exclusiveMinimum": 0
},
"only_imported": {
"type": "boolean",
"description": "Only imported (bank) entries."
},
"only_purchase": {
"type": "boolean",
"description": "Only entries created by purchase orders."
},
"only_collective": {
"type": "boolean",
"description": "Only collective entries."
},
"fiscal_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fiscal period id (cashctrl_list_fiscal_periods); default is the current period.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List journal entries",
"readOnlyHint": true
}
}One book entry by id, with its items for a collective entry. GET /journal/read.json.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The journal entry id (from cashctrl_list_journal). |
{
"name": "cashctrl_get_journal_entry",
"title": "Get a journal entry",
"description": "One book entry by id, with its items for a collective entry. GET /journal/read.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The journal entry id (from cashctrl_list_journal).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a journal entry",
"readOnlyHint": true
}
}Sales or purchase documents (quotes, order confirmations, invoices, delivery notes, credit notes, vendor bills) with number, date, customer, status and total. Newest first. GET /order/list.json.
| Parameter | Type | Description |
|---|---|---|
| dir | string | Sort direction (each list has its own default). |
| sort | string | Column to sort by (a column name of the list reply; each list has its own default). |
| type | string | SALES or PURCHASE documents. |
| limit | integer | Rows to return, 1-500 (default 100). |
| query | string | Full-text search. |
| start | integer | Index of the first row (default 0). Use next_start from the previous reply. |
| filter | array | Column filters, all must match (AND). |
| only_open | boolean | Only open (not completed) orders, for example unpaid invoices. |
| person_id | integer | Only orders of this person (cashctrl_list_persons). |
| status_id | integer | Only this status (the status ids are in cashctrl_list_order_categories). |
| category_id | integer | Only this order category (cashctrl_list_order_categories), for example Invoice. |
| only_overdue | boolean | Only orders past their due date. |
| fiscal_period_id | integer | Fiscal period id (cashctrl_list_fiscal_periods); default is the current period. |
{
"name": "cashctrl_list_orders",
"title": "List orders",
"description": "Sales or purchase documents (quotes, order confirmations, invoices, delivery notes, credit notes, vendor bills) with number, date, customer, status and total. Newest first. GET /order/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (each list has its own default)."
},
"sort": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column to sort by (a column name of the list reply; each list has its own default)."
},
"type": {
"enum": [
"SALES",
"PURCHASE"
],
"type": "string",
"description": "SALES or PURCHASE documents."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows to return, 1-500 (default 100)."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Full-text search."
},
"start": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first row (default 0). Use next_start from the previous reply."
},
"filter": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value"
],
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column name of the list reply."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
]
},
"maxItems": 50
}
],
"description": "Value, or an array of values (any matches)."
},
"comparison": {
"enum": [
"eq",
"like",
"gt",
"lt"
],
"type": "string",
"description": "Default like."
}
}
},
"maxItems": 10,
"description": "Column filters, all must match (AND)."
},
"only_open": {
"type": "boolean",
"description": "Only open (not completed) orders, for example unpaid invoices."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only orders of this person (cashctrl_list_persons).",
"exclusiveMinimum": 0
},
"status_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this status (the status ids are in cashctrl_list_order_categories).",
"exclusiveMinimum": 0
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this order category (cashctrl_list_order_categories), for example Invoice.",
"exclusiveMinimum": 0
},
"only_overdue": {
"type": "boolean",
"description": "Only orders past their due date."
},
"fiscal_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fiscal period id (cashctrl_list_fiscal_periods); default is the current period.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true
}
}One order (invoice, quote, purchase document) by id, with its items, totals and status. GET /order/read.json.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The order id (from cashctrl_list_orders). |
{
"name": "cashctrl_get_order",
"title": "Get an order",
"description": "One order (invoice, quote, purchase document) by id, with its items, totals and status. GET /order/read.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The order id (from cashctrl_list_orders).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true
}
}The order categories (Quote, Invoice, Credit note, Purchase invoice and so on) with their statuses (Draft, Open, Paid) and the default accounts and sequence numbers. Use it to find category_id and status_id (type PURCHASE for purchase documents). GET /order/category/list.json.
| Parameter | Type | Description |
|---|---|---|
| type | string | SALES (default) or PURCHASE categories. |
| fiscal_period_id | integer | Fiscal period id (cashctrl_list_fiscal_periods); default is the current period. |
{
"name": "cashctrl_list_order_categories",
"title": "List order categories",
"description": "The order categories (Quote, Invoice, Credit note, Purchase invoice and so on) with their statuses (Draft, Open, Paid) and the default accounts and sequence numbers. Use it to find category_id and status_id (type PURCHASE for purchase documents). GET /order/category/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"SALES",
"PURCHASE"
],
"type": "string",
"description": "SALES (default) or PURCHASE categories."
},
"fiscal_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fiscal period id (cashctrl_list_fiscal_periods); default is the current period.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List order categories",
"readOnlyHint": true
}
}Customers, vendors, employees and other contacts (name, company, number, roles, addresses). GET /person/list.json.
| Parameter | Type | Description |
|---|---|---|
| dir | string | Sort direction (each list has its own default). |
| sort | string | Column to sort by (a column name of the list reply; each list has its own default). |
| limit | integer | Rows to return, 1-500 (default 100). |
| query | string | Full-text search. |
| start | integer | Index of the first row (default 0). Use next_start from the previous reply. |
| filter | array | Column filters, all must match (AND). |
| category_id | integer | Only this person category. |
| only_active | boolean | Only active people. |
| only_vendors | boolean | Only vendors. |
| only_customers | boolean | Only customers. |
| only_employees | boolean | Only employees. |
{
"name": "cashctrl_list_persons",
"title": "List people",
"description": "Customers, vendors, employees and other contacts (name, company, number, roles, addresses). GET /person/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (each list has its own default)."
},
"sort": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column to sort by (a column name of the list reply; each list has its own default)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows to return, 1-500 (default 100)."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Full-text search."
},
"start": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first row (default 0). Use next_start from the previous reply."
},
"filter": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value"
],
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column name of the list reply."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
]
},
"maxItems": 50
}
],
"description": "Value, or an array of values (any matches)."
},
"comparison": {
"enum": [
"eq",
"like",
"gt",
"lt"
],
"type": "string",
"description": "Default like."
}
}
},
"maxItems": 10,
"description": "Column filters, all must match (AND)."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this person category.",
"exclusiveMinimum": 0
},
"only_active": {
"type": "boolean",
"description": "Only active people."
},
"only_vendors": {
"type": "boolean",
"description": "Only vendors."
},
"only_customers": {
"type": "boolean",
"description": "Only customers."
},
"only_employees": {
"type": "boolean",
"description": "Only employees."
}
}
},
"annotations": {
"title": "List people",
"readOnlyHint": true
}
}One person or company by id, with addresses, contact data and bank accounts. GET /person/read.json.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The person id (from cashctrl_list_persons). |
{
"name": "cashctrl_get_person",
"title": "Get a person",
"description": "One person or company by id, with addresses, contact data and bank accounts. GET /person/read.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The person id (from cashctrl_list_persons).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a person",
"readOnlyHint": true
}
}Inventory articles (products and services) with number, name, price, stock and accounts. GET /inventory/article/list.json.
| Parameter | Type | Description |
|---|---|---|
| dir | string | Sort direction (each list has its own default). |
| sort | string | Column to sort by (a column name of the list reply; each list has its own default). |
| limit | integer | Rows to return, 1-500 (default 100). |
| query | string | Full-text search. |
| start | integer | Index of the first row (default 0). Use next_start from the previous reply. |
| filter | array | Column filters, all must match (AND). |
| category_id | integer | Only this article category. |
| only_active | boolean | Only active articles. |
| only_restock | boolean | Only articles that need restocking. |
{
"name": "cashctrl_list_articles",
"title": "List inventory articles",
"description": "Inventory articles (products and services) with number, name, price, stock and accounts. GET /inventory/article/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (each list has its own default)."
},
"sort": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column to sort by (a column name of the list reply; each list has its own default)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows to return, 1-500 (default 100)."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Full-text search."
},
"start": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first row (default 0). Use next_start from the previous reply."
},
"filter": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value"
],
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column name of the list reply."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
]
},
"maxItems": 50
}
],
"description": "Value, or an array of values (any matches)."
},
"comparison": {
"enum": [
"eq",
"like",
"gt",
"lt"
],
"type": "string",
"description": "Default like."
}
}
},
"maxItems": 10,
"description": "Column filters, all must match (AND)."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this article category.",
"exclusiveMinimum": 0
},
"only_active": {
"type": "boolean",
"description": "Only active articles."
},
"only_restock": {
"type": "boolean",
"description": "Only articles that need restocking."
}
}
},
"annotations": {
"title": "List inventory articles",
"readOnlyHint": true
}
}One inventory article by id. GET /inventory/article/read.json.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The article id (from cashctrl_list_articles). |
{
"name": "cashctrl_get_article",
"title": "Get an inventory article",
"description": "One inventory article by id. GET /inventory/article/read.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The article id (from cashctrl_list_articles).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an inventory article",
"readOnlyHint": true
}
}Payroll statements (employee, date, status, gross and net amounts), newest first. Sensitive personal data. GET /salary/statement/list.json.
| Parameter | Type | Description |
|---|---|---|
| dir | string | Sort direction (each list has its own default). |
| sort | string | Column to sort by (a column name of the list reply; each list has its own default). |
| limit | integer | Rows to return, 1-500 (default 100). |
| query | string | Full-text search. |
| start | integer | Index of the first row (default 0). Use next_start from the previous reply. |
| only_open | boolean | Only open (not yet paid) statements. |
| person_id | integer | Only statements of this employee (cashctrl_list_persons). |
| only_overdue | boolean | Only statements past their payment date. |
| fiscal_period_id | integer | Fiscal period id (cashctrl_list_fiscal_periods); default is the current period. |
{
"name": "cashctrl_list_salary_statements",
"title": "List salary statements",
"description": "Payroll statements (employee, date, status, gross and net amounts), newest first. Sensitive personal data. GET /salary/statement/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (each list has its own default)."
},
"sort": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.]{0,59}$",
"description": "Column to sort by (a column name of the list reply; each list has its own default)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows to return, 1-500 (default 100)."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Full-text search."
},
"start": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first row (default 0). Use next_start from the previous reply."
},
"only_open": {
"type": "boolean",
"description": "Only open (not yet paid) statements."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only statements of this employee (cashctrl_list_persons).",
"exclusiveMinimum": 0
},
"only_overdue": {
"type": "boolean",
"description": "Only statements past their payment date."
},
"fiscal_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fiscal period id (cashctrl_list_fiscal_periods); default is the current period.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List salary statements",
"readOnlyHint": true
}
}One payroll statement by id, with its salary items. Sensitive personal data. GET /salary/statement/read.json.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The statement id (from cashctrl_list_salary_statements). |
{
"name": "cashctrl_get_salary_statement",
"title": "Get a salary statement",
"description": "One payroll statement by id, with its salary items. Sensitive personal data. GET /salary/statement/read.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The statement id (from cashctrl_list_salary_statements).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a salary statement",
"readOnlyHint": true
}
}All fiscal periods (id, name, start, end, current flag). The id is the fiscal_period_id of the other tools. GET /fiscalperiod/list.json.
No parameters.
{
"name": "cashctrl_list_fiscal_periods",
"title": "List fiscal periods",
"description": "All fiscal periods (id, name, start, end, current flag). The id is the fiscal_period_id of the other tools. GET /fiscalperiod/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List fiscal periods",
"readOnlyHint": true
}
}The VAT tax codes (id, code, name, rates). The id is the tax_id of the write tools. GET /tax/list.json.
No parameters.
{
"name": "cashctrl_list_tax_codes",
"title": "List tax codes",
"description": "The VAT tax codes (id, code, name, rates). The id is the tax_id of the write tools. GET /tax/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List tax codes",
"readOnlyHint": true
}
}The number sequences (for journal references, order numbers, customer numbers). The id is the sequence_number_id of the write tools. GET /sequencenumber/list.json.
No parameters.
{
"name": "cashctrl_list_sequence_numbers",
"title": "List sequence numbers",
"description": "The number sequences (for journal references, order numbers, customer numbers). The id is the sequence_number_id of the write tools. GET /sequencenumber/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List sequence numbers",
"readOnlyHint": true
}
}The currencies set up in CashCtrl with their exchange rates. GET /currency/list.json.
No parameters.
{
"name": "cashctrl_list_currencies",
"title": "List currencies",
"description": "The currencies set up in CashCtrl with their exchange rates. GET /currency/list.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List currencies",
"readOnlyHint": true
}
}The reports set up in CashCtrl (balance sheet, income statement, and so on) as a tree of collections and elements. The element id is the input of cashctrl_get_report_data. GET /report/tree.json.
No parameters.
{
"name": "cashctrl_get_report_tree",
"title": "Get the report tree",
"description": "The reports set up in CashCtrl (balance sheet, income statement, and so on) as a tree of collections and elements. The element id is the input of cashctrl_get_report_data. GET /report/tree.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the report tree",
"readOnlyHint": true
}
}The data of one report element (for example the balance sheet or the income statement) for a fiscal period or a date range. GET /report/element/data.json.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | End of the period, yyyy-mm-dd. |
| element_id * | integer | The report element id (from cashctrl_get_report_tree). |
| start_date | string | Start of the period, yyyy-mm-dd. |
| fiscal_period_id | integer | Fiscal period id (cashctrl_list_fiscal_periods). It replaces start_date and end_date. |
{
"name": "cashctrl_get_report_data",
"title": "Get report data",
"description": "The data of one report element (for example the balance sheet or the income statement) for a fiscal period or a date range. GET /report/element/data.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"element_id"
],
"properties": {
"end_date": {
"type": "string",
"description": "End of the period, yyyy-mm-dd."
},
"element_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The report element id (from cashctrl_get_report_tree).",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"description": "Start of the period, yyyy-mm-dd."
},
"fiscal_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fiscal period id (cashctrl_list_fiscal_periods). It replaces start_date and end_date.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get report data",
"readOnlyHint": true
}
}WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates a manual book entry in the journal. Either a simple entry (debit_account_id, credit_account_id, amount) or a collective entry (items, whose debit and credit sums must match). POST /journal/create.json.
| Parameter | Type | Description |
|---|---|---|
| date | string | Booking date, yyyy-mm-dd (CashCtrl uses today when omitted). |
| items | array | Lines of a collective entry. Use it instead of debit_account_id, credit_account_id and amount. |
| title * | string | Description of the entry (max 250 characters). |
| amount | number | Amount of a simple entry, for example 125.50. |
| tax_id | integer | Tax code id of a simple entry (cashctrl_list_tax_codes). |
| reference | string | Receipt or reference text (max 100). |
| associate_id | integer | The person this entry belongs to (cashctrl_list_persons). |
| debit_account_id | integer | Debit account id (cashctrl_list_accounts). For a simple entry. |
| credit_account_id | integer | Credit account id (cashctrl_list_accounts). For a simple entry. |
| sequence_number_id | integer | Sequence number that generates the reference (cashctrl_list_sequence_numbers). |
{
"name": "cashctrl_create_journal_entry",
"title": "Create a journal entry",
"description": "WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates a manual book entry in the journal. Either a simple entry (debit_account_id, credit_account_id, amount) or a collective entry (items, whose debit and credit sums must match). POST /journal/create.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title"
],
"properties": {
"date": {
"type": "string",
"description": "Booking date, yyyy-mm-dd (CashCtrl uses today when omitted)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"account_id"
],
"properties": {
"debit": {
"type": "number",
"maximum": 1000000000000,
"description": "Amount on the debit side; give debit or credit.",
"exclusiveMinimum": 0
},
"credit": {
"type": "number",
"maximum": 1000000000000,
"description": "Amount on the credit side; give debit or credit.",
"exclusiveMinimum": 0
},
"tax_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tax code id (cashctrl_list_tax_codes).",
"exclusiveMinimum": 0
},
"account_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Account id.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 250,
"description": "Description of this line."
}
}
},
"maxItems": 100,
"minItems": 2,
"description": "Lines of a collective entry. Use it instead of debit_account_id, credit_account_id and amount."
},
"title": {
"type": "string",
"maxLength": 250,
"minLength": 1,
"description": "Description of the entry (max 250 characters)."
},
"amount": {
"type": "number",
"maximum": 1000000000000,
"description": "Amount of a simple entry, for example 125.50.",
"exclusiveMinimum": 0
},
"tax_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tax code id of a simple entry (cashctrl_list_tax_codes).",
"exclusiveMinimum": 0
},
"reference": {
"type": "string",
"maxLength": 100,
"description": "Receipt or reference text (max 100)."
},
"associate_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The person this entry belongs to (cashctrl_list_persons).",
"exclusiveMinimum": 0
},
"debit_account_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Debit account id (cashctrl_list_accounts). For a simple entry.",
"exclusiveMinimum": 0
},
"credit_account_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Credit account id (cashctrl_list_accounts). For a simple entry.",
"exclusiveMinimum": 0
},
"sequence_number_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Sequence number that generates the reference (cashctrl_list_sequence_numbers).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a journal entry",
"destructiveHint": true
}
}WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. DELETES manual journal entries by id (entries created by orders or salary statements cannot be deleted this way). Deleted entries are gone from the books; confirm the ids with the user first. POST /journal/delete.json.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | 1-20 journal entry ids. |
{
"name": "cashctrl_delete_journal_entries",
"title": "Delete journal entries",
"description": "WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. DELETES manual journal entries by id (entries created by orders or salary statements cannot be deleted this way). Deleted entries are gone from the books; confirm the ids with the user first. POST /journal/delete.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"description": "A journal entry id (cashctrl_list_journal).",
"exclusiveMinimum": 0
},
"maxItems": 20,
"minItems": 1,
"description": "1-20 journal entry ids."
}
}
},
"annotations": {
"title": "Delete journal entries",
"destructiveHint": true
}
}WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates ONE order document for ONE customer or vendor: a quote, invoice, credit note, purchase bill and so on, depending on category_id. Without status_id the first status of the category is used; a booking status (for example Open) also creates journal entries, so use a draft status unless the user asks otherwise. No e-mail is sent. POST /order/create.json.
| Parameter | Type | Description |
|---|---|---|
| nr | string | Order number. Leave empty to use the sequence number of the category. |
| date * | string | Document date, yyyy-mm-dd. |
| items * | array | 1-200 order items. |
| due_days | integer | Days until payment is due. |
| language | string | Language of the document. |
| status_id | integer | Status id (cashctrl_list_order_categories). Default: the first status of the category. |
| account_id | integer | Debtors or creditors account id; default from the category. |
| category_id * | integer | Order category id (cashctrl_list_order_categories), for example the Invoice category. |
| description | string | Description of the document (max 200). |
| associate_id * | integer | The customer or vendor (cashctrl_list_persons). |
| sequence_number_id | integer | Sequence number for the order number (cashctrl_list_sequence_numbers). |
| discount_percentage | number | Discount of the whole order in percent. |
{
"name": "cashctrl_create_order",
"title": "Create an order",
"description": "WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates ONE order document for ONE customer or vendor: a quote, invoice, credit note, purchase bill and so on, depending on category_id. Without status_id the first status of the category is used; a booking status (for example Open) also creates journal entries, so use a draft status unless the user asks otherwise. No e-mail is sent. POST /order/create.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_id",
"associate_id",
"date",
"items"
],
"properties": {
"nr": {
"type": "string",
"maxLength": 50,
"description": "Order number. Leave empty to use the sequence number of the category."
},
"date": {
"type": "string",
"description": "Document date, yyyy-mm-dd."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"account_id",
"name",
"unit_price"
],
"properties": {
"name": {
"type": "string",
"maxLength": 250,
"minLength": 1,
"description": "Item name."
},
"tax_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tax code id (cashctrl_list_tax_codes).",
"exclusiveMinimum": 0
},
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Unit id (pieces, hours; from the units of the inventory).",
"exclusiveMinimum": 0
},
"quantity": {
"type": "number",
"maximum": 1000000000,
"description": "Quantity (default 1).",
"exclusiveMinimum": 0
},
"account_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Revenue account id (sales) or expense account id (purchase), from cashctrl_list_accounts.",
"exclusiveMinimum": 0
},
"article_nr": {
"type": "string",
"maxLength": 100,
"description": "Article number."
},
"unit_price": {
"type": "number",
"maximum": 1000000000000,
"minimum": -1000000000000,
"description": "Price of one unit."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Item description."
},
"inventory_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Inventory article id (cashctrl_list_articles).",
"exclusiveMinimum": 0
},
"discount_percentage": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Discount of this item in percent."
}
}
},
"maxItems": 200,
"minItems": 1,
"description": "1-200 order items."
},
"due_days": {
"type": "integer",
"maximum": 3650,
"minimum": 0,
"description": "Days until payment is due."
},
"language": {
"enum": [
"DE",
"EN",
"FR",
"IT"
],
"type": "string",
"description": "Language of the document."
},
"status_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Status id (cashctrl_list_order_categories). Default: the first status of the category.",
"exclusiveMinimum": 0
},
"account_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Debtors or creditors account id; default from the category.",
"exclusiveMinimum": 0
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Order category id (cashctrl_list_order_categories), for example the Invoice category.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 200,
"description": "Description of the document (max 200)."
},
"associate_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The customer or vendor (cashctrl_list_persons).",
"exclusiveMinimum": 0
},
"sequence_number_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Sequence number for the order number (cashctrl_list_sequence_numbers).",
"exclusiveMinimum": 0
},
"discount_percentage": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Discount of the whole order in percent."
}
}
},
"annotations": {
"title": "Create an order",
"destructiveHint": true
}
}WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Sets the status of 1-20 orders (for example Draft to Open, or Open to Paid). A status can book journal entries or move stock, so the books change. POST /order/update_status.json.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | 1-20 order ids. |
| status_id * | integer | The new status id (from the statuses of the order category, cashctrl_list_order_categories). |
{
"name": "cashctrl_update_order_status",
"title": "Change the status of orders",
"description": "WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Sets the status of 1-20 orders (for example Draft to Open, or Open to Paid). A status can book journal entries or move stock, so the books change. POST /order/update_status.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ids",
"status_id"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"description": "An order id (cashctrl_list_orders).",
"exclusiveMinimum": 0
},
"maxItems": 20,
"minItems": 1,
"description": "1-20 order ids."
},
"status_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The new status id (from the statuses of the order category, cashctrl_list_order_categories).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Change the status of orders",
"destructiveHint": true
}
}WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. DELETES orders (invoices, quotes, purchase documents) by id, with the journal entries they created. Deleted documents are gone; confirm the ids with the user first. POST /order/delete.json.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | 1-20 order ids. |
{
"name": "cashctrl_delete_orders",
"title": "Delete orders",
"description": "WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. DELETES orders (invoices, quotes, purchase documents) by id, with the journal entries they created. Deleted documents are gone; confirm the ids with the user first. POST /order/delete.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"description": "An order id (cashctrl_list_orders).",
"exclusiveMinimum": 0
},
"maxItems": 20,
"minItems": 1,
"description": "1-20 order ids."
}
}
},
"annotations": {
"title": "Delete orders",
"destructiveHint": true
}
}WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates a customer, vendor or other contact. Give company, first_name or last_name (at least one). Search first with cashctrl_list_persons so no duplicate is created. POST /person/create.json.
| Parameter | Type | Description |
|---|---|---|
| nr | string | Person number, for example the customer number. |
| company | string | Company name. |
| vat_uid | string | VAT number (UID), for example CHE-123.456.789 MWST. |
| contacts | array | E-mail addresses, phone numbers and websites. |
| language | string | Language of documents for this person. |
| addresses | array | Addresses. |
| is_vendor | boolean | Mark as vendor. |
| last_name | string | Last name. |
| first_name | string | First name. |
| category_id | integer | Person category id. |
| is_customer | boolean | Mark as customer. |
{
"name": "cashctrl_create_person",
"title": "Create a person or company",
"description": "WRITE: changes the accounting records. Makes one request that is never repeated; check the result before trying again. Creates a customer, vendor or other contact. Give company, first_name or last_name (at least one). Search first with cashctrl_list_persons so no duplicate is created. POST /person/create.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"nr": {
"type": "string",
"maxLength": 50,
"description": "Person number, for example the customer number."
},
"company": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Company name."
},
"vat_uid": {
"type": "string",
"maxLength": 32,
"description": "VAT number (UID), for example CHE-123.456.789 MWST."
},
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"address"
],
"properties": {
"type": {
"enum": [
"EMAIL_INVOICE",
"EMAIL_WORK",
"EMAIL_PRIVATE",
"PHONE_WORK",
"PHONE_PRIVATE",
"MOBILE_WORK",
"MOBILE_PRIVATE",
"WEBSITE",
"OTHER"
],
"type": "string",
"description": "Kind of contact data."
},
"address": {
"type": "string",
"maxLength": 250,
"minLength": 1,
"description": "The e-mail address, phone number or URL."
}
}
},
"maxItems": 20,
"description": "E-mail addresses, phone numbers and websites."
},
"language": {
"enum": [
"DE",
"EN",
"FR",
"IT"
],
"type": "string",
"description": "Language of documents for this person."
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 20,
"description": "Postal code."
},
"city": {
"type": "string",
"maxLength": 100,
"description": "City."
},
"type": {
"enum": [
"MAIN",
"INVOICE",
"DELIVERY",
"OTHER"
],
"type": "string",
"description": "Address type."
},
"address": {
"type": "string",
"maxLength": 500,
"description": "Street and number; may have several lines."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Country as a 3-letter code, for example CHE, DEU, AUT."
}
}
},
"maxItems": 10,
"description": "Addresses."
},
"is_vendor": {
"type": "boolean",
"description": "Mark as vendor."
},
"last_name": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Last name."
},
"first_name": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "First name."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Person category id.",
"exclusiveMinimum": 0
},
"is_customer": {
"type": "boolean",
"description": "Mark as customer."
}
}
},
"annotations": {
"title": "Create a person or company",
"destructiveHint": true
}
}Tools for CashCtrl, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which invoices are still open and who owes us money?"; "What is our income statement for the current fiscal year?"; "Show the bookkeeping entries from last month.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes CashCtrl data. Free plan: 50 tool calls per month. Run cashctrl_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run cashctrl_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run cashctrl_upgrade without a plan: it returns both plans, each with a payment link for the user to open. cashctrl_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.