Read Yuki administrations, open invoices, ledger balances, contacts and documents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Details of one archive document by id (subject, type, contact, dates, amounts, folder). Archive.FindDocument.
Yuki document id (the ID in a document list).
Yuki domain id (from yuki_list_domains). Optional when the key has a single domain.
Details of one archive document by id (subject, type, contact, dates, amounts, folder). Archive.FindDocument.
| Argument | Type | Description |
|---|---|---|
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
| document_id* | string | Yuki document id (the ID in a document list). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
},
"document_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki document id (the ID in a document list)."
}
}
}A presigned download URL for the file of one archive document (the link works for a short time; open it in a browser). Archive.DocumentDownloadUrl.
| Argument | Type | Description |
|---|---|---|
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
| document_id* | string | Yuki document id (the ID in a document list). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
},
"document_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki document id (the ID in a document list)."
}
}
}The balance of every general ledger account of an administration on a date (yyyy-mm-dd): account code, description, amount. Accounting.GLAccountBalance.
| Argument | Type | Description |
|---|---|---|
| date* | string | Balance date, yyyy-mm-dd. |
| limit | integer | Most items to return (default 100, max 500). |
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Balance date, yyyy-mm-dd."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most items to return (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
}
}
}The general ledger accounts (chart of accounts) of an administration: code, description, type. Use the codes in yuki_list_gl_account_transactions. AccountingInfo.GetGLAccountScheme.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most items to return (default 100, max 500). |
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most items to return (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
}
}
}The net revenue (turnover) of an administration in a date range, by transaction date. Accounting.NetRevenue.
| Argument | Type | Description |
|---|---|---|
| end_date* | string | Last day, yyyy-mm-dd. |
| start_date* | string | First day, yyyy-mm-dd. |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
}
}
}List the administrations (companies with their own books) this access key can reach: id, name, address, Chamber of Commerce and VAT numbers, start date. Use the ids in the other tools. Accounting.Administrations.
| Argument | Type | Description |
|---|---|---|
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
}
}
}The tabs inside one archive folder (id, name). Archive.DocumentFolderTabs.
| Argument | Type | Description |
|---|---|---|
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
| folder_id* | integer | Folder id from yuki_list_document_folders. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"folder_id"
],
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
},
"folder_id": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "Folder id from yuki_list_document_folders."
}
}
}The folders of the document archive (id, name). With an accountant key that reaches several domains, pass domain_id so the archive of that domain is read (default: the key's only domain). Archive.DocumentFolders.
| Argument | Type | Description |
|---|---|---|
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
}
}
}Documents in the archive (invoices, receipts, bank statements...) with id, subject, type, contact, dates, amount. Narrow by archive folder or by document type, and by creation date range. Page with number_of_records and start_record. Archive.Documents / DocumentsInFolder / DocumentsByType.
| Argument | Type | Description |
|---|---|---|
| offset | integer | Skip this many documents of the fetched batch (default 0). A long batch is cut to fit the reply: use next_offset with the same arguments. |
| end_date | string | Last day, yyyy-mm-dd (default 2100-01-01). |
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
| folder_id | integer | Only this archive folder (id from yuki_list_document_folders). Not together with document_type. |
| sort_order | string | Sort order (default CreatedDesc). |
| start_date | string | First day, yyyy-mm-dd (default 1990-01-01). |
| start_record | integer | Offset of the first document (default 0). Add numberOfRecords to page on. |
| document_type |
List the Yuki domains (customer environments) this access key can reach: id, name and URL. Accountant keys reach many domains. Accounting.Domains.
| Argument | Type | Description |
|---|---|---|
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
}
}
}The transactions booked on one general ledger account in a date range: date, description, amount, contact, project. Get account codes from yuki_get_gl_account_scheme. Accounting.GLAccountTransactions.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most items to return (default 100, max 500). |
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
| end_date* | string | Last day, yyyy-mm-dd. |
| start_date* | string | First day, yyyy-mm-dd. |
| gl_account_code* | string | General ledger account code, e.g. 80000. |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"gl_account_code",
"start_date",
"end_date"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most items to return (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"gl_account_code": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 32,
"minLength": 1,
"description": "General ledger account code, e.g. 80000."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
}
}
}Open items on the creditors list (unpaid purchase invoices): date, description, contact, open and original amount, reference, due date. Optionally within a date range. Accounting.OutstandingCreditorItems / OutstandingCreditorItemsByDate.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most items to return (default 100, max 500). |
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
| end_date | string | With start_date: end of the range (yyyy-mm-dd). |
| sort_order | string | Sort order (default DateDesc). |
| start_date | string | With end_date: only items dated in this range (yyyy-mm-dd). |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
| include_bank_transactions | boolean | Also list unmatched bank transactions as open items (default false). |
Open items on the debtors list (unpaid sales invoices): date, description, contact, open and original amount, reference, due date. Optionally within a date range. Accounting.OutstandingDebtorItems / OutstandingDebtorItemsByDate.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most items to return (default 100, max 500). |
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
| end_date | string | With start_date: end of the range (yyyy-mm-dd). |
| sort_order | string | Sort order (default DateDesc). |
| start_date | string | With end_date: only items dated in this range (yyyy-mm-dd). |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
| include_bank_transactions | boolean | Also list unmatched bank transactions as open items (default false). |
Projects of an administration (code, description, company, contact, period, budgets), optionally filtered. AccountingInfo.GetProjects.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most items to return (default 100, max 500). |
| offset | integer | Skip this many items (default 0). Use the previous reply's next_offset to read on. |
| search_value | string | Text to search for (ignored for All). |
| search_option | string | Field to search in (default All). |
| administration_id | string | Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most items to return (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
},
"search_value": {
"type": "string",
"maxLength": 200,
"description": "Text to search for (ignored for All)."
},
"search_option": {
"enum": [
"All",
"Company",
"Code",
"Description"
],
"type": "string",
"description": "Field to search in (default All)."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
}
}
}Search the contacts (customers and suppliers) of a domain by name, city, postcode, tag, email, website, phone, code, Chamber of Commerce number, VAT number or bank account. Returns at most 100 contacts per page; ask for the next page_number until the reply is empty. Contact.SearchContacts.
| Argument | Type | Description |
|---|---|---|
| active | string | Active, inactive or both (default Both). |
| offset | integer | Skip this many contacts of the page (default 0). A long page is cut to fit the reply: use next_offset with the same page_number, then the next page_number. |
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
| sort_order | string | Sort order (default Name). |
| page_number | integer | Page number, starting at 1 (default 1). A page holds up to 100 contacts. |
| search_value | string | Text to search for. Empty lists all contacts. |
| search_option | string | Field to search in (default All). |
Search archive documents by text in the creator, contact, subject, tag or type (or all). Optionally limit to a folder or tab and a date range. Archive.SearchDocuments.
| Argument | Type | Description |
|---|---|---|
| offset | integer | Skip this many documents of the fetched batch (default 0). A long batch is cut to fit the reply: use next_offset with the same arguments. |
| tab_id | integer | Only this tab; -1 or omitted = all tabs. |
| end_date | string | Last day, yyyy-mm-dd. |
| domain_id | string | Yuki domain id (from yuki_list_domains). Optional when the key has a single domain. |
| folder_id | integer | Only this folder; -1 or omitted = all folders. |
| sort_order | string | Sort order (default CreatedDesc). |
| start_date | string | First day, yyyy-mm-dd. Omit with end_date to search all years. |
| search_text* | string | Text to search for. |
| integer |
| Only this Yuki document type number. Not together with folder_id. |
| number_of_records | integer | Documents per call (default 100, max 500). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many documents of the fetched batch (default 0). A long batch is cut to fit the reply: use next_offset with the same arguments."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd (default 2100-01-01)."
},
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
},
"folder_id": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "Only this archive folder (id from yuki_list_document_folders). Not together with document_type."
},
"sort_order": {
"enum": [
"CreatedDesc",
"CreatedAsc",
"ModifiedDesc",
"ModifiedAsc",
"DocumentDateDesc",
"DocumentDateAsc",
"ContactNameAsc",
"ContactNameDesc"
],
"type": "string",
"description": "Sort order (default CreatedDesc)."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd (default 1990-01-01)."
},
"start_record": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Offset of the first document (default 0). Add numberOfRecords to page on."
},
"document_type": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Only this Yuki document type number. Not together with folder_id."
},
"number_of_records": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Documents per call (default 100, max 500)."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most items to return (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "With start_date: end of the range (yyyy-mm-dd)."
},
"sort_order": {
"enum": [
"ContactAsc",
"ContactDesc",
"AmountAsc",
"AmountDesc",
"DateAsc",
"DateDesc"
],
"type": "string",
"description": "Sort order (default DateDesc)."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "With end_date: only items dated in this range (yyyy-mm-dd)."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
},
"include_bank_transactions": {
"type": "boolean",
"description": "Also list unmatched bank transactions as open items (default false)."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Most items to return (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many items (default 0). Use the previous reply's next_offset to read on."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "With start_date: end of the range (yyyy-mm-dd)."
},
"sort_order": {
"enum": [
"ContactAsc",
"ContactDesc",
"AmountAsc",
"AmountDesc",
"DateAsc",
"DateDesc"
],
"type": "string",
"description": "Sort order (default DateDesc)."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "With end_date: only items dated in this range (yyyy-mm-dd)."
},
"administration_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki administration id (from yuki_list_administrations). Optional when the key has a single administration."
},
"include_bank_transactions": {
"type": "boolean",
"description": "Also list unmatched bank transactions as open items (default false)."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"active": {
"enum": [
"Both",
"Active",
"Inactive"
],
"type": "string",
"description": "Active, inactive or both (default Both)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many contacts of the page (default 0). A long page is cut to fit the reply: use next_offset with the same page_number, then the next page_number."
},
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
},
"sort_order": {
"enum": [
"Name",
"LastName",
"CreatedAsc",
"CreatedDesc",
"ModifiedAsc",
"ModifiedDesc",
"HID"
],
"type": "string",
"description": "Sort order (default Name)."
},
"page_number": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number, starting at 1 (default 1). A page holds up to 100 contacts."
},
"search_value": {
"type": "string",
"maxLength": 200,
"description": "Text to search for. Empty lists all contacts."
},
"search_option": {
"enum": [
"All",
"Name",
"City",
"Postcode",
"Tag",
"Email",
"Website",
"Phone",
"Code",
"CoCNumber",
"VATNumber",
"BankAccount"
],
"type": "string",
"description": "Field to search in (default All)."
}
}
}| start_record |
| integer |
| Offset of the first document (default 0). Add numberOfRecords to page on. |
| search_option | string | Where to search (default All). |
| number_of_records | integer | Documents per call (default 100, max 500). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"search_text"
],
"properties": {
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Skip this many documents of the fetched batch (default 0). A long batch is cut to fit the reply: use next_offset with the same arguments."
},
"tab_id": {
"type": "integer",
"maximum": 1000000000,
"minimum": -1,
"description": "Only this tab; -1 or omitted = all tabs."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd."
},
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}$",
"description": "Yuki domain id (from yuki_list_domains). Optional when the key has a single domain."
},
"folder_id": {
"type": "integer",
"maximum": 1000000000,
"minimum": -1,
"description": "Only this folder; -1 or omitted = all folders."
},
"sort_order": {
"enum": [
"CreatedDesc",
"CreatedAsc",
"ModifiedDesc",
"ModifiedAsc",
"DocumentDateDesc",
"DocumentDateAsc",
"ContactNameAsc",
"ContactNameDesc"
],
"type": "string",
"description": "Sort order (default CreatedDesc)."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd. Omit with end_date to search all years."
},
"search_text": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Text to search for."
},
"start_record": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Offset of the first document (default 0). Add numberOfRecords to page on."
},
"search_option": {
"enum": [
"All",
"Creator",
"Contact",
"Subject",
"Tag",
"Type"
],
"type": "string",
"description": "Where to search (default All)."
},
"number_of_records": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Documents per call (default 100, max 500)."
}
}
}