MCP App Store
by KeenEthics
NULA icon

NULA MCP Server for ChatGPT

By Cloud Tech Ltd

Overview

NULA is cloud accounting software for Bulgarian companies and the accountants who serve them. Connect NULA to ChatGPT to ask about your books and prepare documents from the chat. When you connect, NULA asks which of your companies ChatGPT may use and whether it may only read or also make changes. ChatGPT works only with the companies you choose there. What you can ask about: - sales invoices and purchase bills, with their PDFs and payment status - bank balances and bank transactions - receivables and payables by age, top debtors and the balance with each customer or supplier - income statement, balance sheet, cash flow, trial balance and key figures for the period you choose - VAT return, sales and purchases registers and the VIES return - chart of accounts, account balances, account transactions and journal entries - fixed assets and depreciation, stock, batches and warehouse movements - scanned documents waiting for review after OCR What you can do when the connection may make changes: - prepare a sales invoice, purchase bill, expense or received payment; NULA shows a preview and saves it only after you confirm - correct a scanned document before it is booked, and add rules for how similar documents are booked - mark an invoice or bill as paid, email an invoice to the customer, or post a journal entry Where NULA has a page for a result, the answer links to it. Limits: - You need a NULA account. - NULA in ChatGPT does not send money. Bank transfers and payments are made in NULA or in your bank. - Documents, accounts and reports follow Bulgarian rules, and many names in the data are in Bulgarian. - Support: support@nula.bg, on working days.

How to connect

  1. ChatGPT: Open the NULA listing in the ChatGPT app directory and choose Connect. ChatGPT listing NULA exposes 90 tools here.

Tools

bank_balances

ChatGPT
Current balance for every bank account on the active team (банкови салда, наличности по банкови сметки, парични средства в банка). Returns each account with its IBAN so accounts at the same bank/currency can be told apart, plus server-computed per-currency totals — NEVER add balances across currencies and never sum rows yourself; answer aggregate questions from totals. Optionally filter by name substring or currency code.

cancel_accounting_treatment_rule_change_draft

ChatGPT
Discard a pending supplier-treatment rule change previewed with change_accounting_treatment_rule_draft. The current rule stays as it is and no accounting data changes.

cancel_accounting_treatment_rule_disable_draft

ChatGPT
Discard a pending preview from disable_accounting_treatment_rule_draft. The rule stays active and keeps being used in future document reviews; no accounting data changes.

cancel_accounting_treatment_rule_draft

ChatGPT
Discard a pending new supplier-treatment rule previewed with create_accounting_treatment_rule_draft, without saving the rule or changing accounting data.

cancel_bill_draft

ChatGPT
Discard a pending bill preview without posting anything to the books.

cancel_bill_update_draft

ChatGPT
Discard a pending bill-update preview without applying any changes.

cancel_expense_draft

ChatGPT
Discard a pending expense preview without posting anything to the books.

cancel_invoice_draft

ChatGPT
Discard a pending invoice preview without posting anything to the books. Requires the draft_id and the action_token returned by the create_invoice_draft response; both are mandatory and cannot be guessed or omitted.

cancel_invoice_payment_draft

ChatGPT
Discard a pending customer-payment preview without posting anything to the books. Requires the draft_id and the action_token returned by the record_invoice_payment_draft response; both are mandatory and cannot be guessed or omitted.

cancel_invoice_update_draft

ChatGPT
Discard a pending invoice-update preview without applying any changes. Requires the draft_id and the action_token returned by the update_invoice_draft response; both are mandatory and cannot be guessed or omitted.

cancel_ocr_document_removal_draft

ChatGPT
Keep the duplicate OCR upload in the queue and cancel its removal draft.

change_accounting_treatment_rule_draft

ChatGPT
Prepare a change to one active supplier accounting treatment rule: a new inventory item, purchase account or VAT treatment for the same supplier and line description. Find the rule with list_accounting_treatment_rules. On confirmation the current rule is retired and its successor is used in future document reviews; posted bills and journal entries are not changed. Nothing is saved until the user explicitly confirms with confirm_accounting_treatment_rule_change. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

confirm_accounting_treatment_rule_change

ChatGPT
Apply a supplier-treatment rule change previewed with change_accounting_treatment_rule_draft, after the user explicitly approves it. The current rule is retired and its successor is used in future document reviews. Posted bills and journal entries are not changed.

confirm_accounting_treatment_rule_disable

ChatGPT
Stop using a supplier-treatment rule, as previewed with disable_accounting_treatment_rule_draft, after the user explicitly approves it. Future document reviews no longer apply the rule; it stays in the history as disabled, and posted bills and journal entries are not changed.

confirm_accounting_treatment_rule_draft

ChatGPT
Save a new NULA supplier-treatment rule previewed with create_accounting_treatment_rule_draft, after the user explicitly approves it. This teaches future document reviews and does not post a bill or journal entry.

confirm_bill_draft

ChatGPT
Post a previewed incoming bill to the books. Use this only after the user has reviewed and approved the preview from create_bill_draft.

confirm_bill_update

ChatGPT
Apply the previewed changes to an existing bill. Use this only after the user has reviewed and approved the preview from update_bill_draft.

confirm_expense_draft

ChatGPT
Post a previewed cash expense to the books. Use this only after the user has reviewed and approved the preview from log_expense_draft.

confirm_invoice_draft

ChatGPT
Post a previewed outgoing invoice to the books. Use this only after the user has reviewed and approved the preview from create_invoice_draft. Requires the draft_id and the action_token returned by that create_invoice_draft response; both are mandatory and cannot be guessed or omitted.

confirm_invoice_payment

ChatGPT
Commit a record_invoice_payment_draft. Re-validates the draft against current state (invoice ownership, currency match, status, fiscal year, amount), re-checks the invoice target fingerprint, then posts the BankTransaction + journal entry and transitions the invoice status. Returns the same shape as record_invoice_payment. Requires the draft_id and the action_token returned by that record_invoice_payment_draft response; both are mandatory and cannot be guessed or omitted. Bookkeeping only: it records a payment the customer already made and moves no money.

confirm_invoice_update

ChatGPT
Apply the previewed changes to an existing invoice. Use this only after the user has reviewed and approved the preview from update_invoice_draft. Requires the draft_id and the action_token returned by that update_invoice_draft response; both are mandatory and cannot be guessed or omitted.

confirm_ocr_document_removal_draft

ChatGPT
Confirm removal of one selected OCR purchase from the queue without changing any existing purchase or journal entry.

create_accounting_treatment_rule_draft

ChatGPT
Prepare a new supplier accounting treatment rule: which inventory item, purchase account and VAT treatment future purchase lines with this description from this supplier receive. Consumer-facing references such as supplier name, invoice number, item name, and account number are resolved within the selected company. Nothing is saved until the user explicitly confirms with confirm_accounting_treatment_rule_draft. To change an existing rule use change_accounting_treatment_rule_draft; to stop using one, disable_accounting_treatment_rule_draft. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

create_bill_draft

ChatGPT
Preview an incoming bill from a vendor before posting. Pass an exact purchase:<id> document_key to build the draft from a reviewed OCR document without copying fields. OCR-backed drafts preserve the source attachment and accounting preview and can be confirmed after explicit approval when posting_available=true. Manual drafts can also be confirmed through the existing flow. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

create_invoice_draft

ChatGPT
Preview an outgoing invoice before posting. Builds the invoice so the user can review the customer, totals, VAT, due date, and line items, and only commits to the books when the user confirms. Use this whenever the user is creating an invoice — never post in one step. Omit number unless the user asked for a specific invoice number: the number shown in a preview is only the expected next number. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

create_journal_entry

ChatGPT
Post a manual double-entry accounting article (journal entry / счетоводен запис) to a company's books. Provide a posting date, a memo, and balanced debit and credit lines — total debit must equal total credit, and one side must have a single line (one debit to many credits, or many debits to one credit; split a many-to-many posting into several entries). Each line references an account by its number (from get_chart_of_accounts / search_accounts) and a positive amount in the company currency. Requires accounting-edit permission.

create_ocr_document_removal_draft

ChatGPT
Prepare removal of one selected OCR purchase from the accounting queue. This removes only the uploaded OCR source and never changes an existing purchase or journal entry. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

disable_accounting_treatment_rule_draft

ChatGPT
Prepare to stop using one supplier accounting treatment rule in future document reviews. Find the rule with list_accounting_treatment_rules. The rule stays in the history as disabled; posted bills and journal entries are not changed. Nothing is saved until the user explicitly confirms with confirm_accounting_treatment_rule_disable. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

export_report

ChatGPT
Generate a downloadable accounting-report file (експорт на счетоводна справка към Excel или PDF — сваляне на баланс, ОПР, отчет за собствения капитал, ОПП, дълготрайни активи, оборотна ведомост, главна книга, хронологичен регистър, амортизационен план, амортизационна квота, инвентарна книга, дневник на продажбите, дневник на покупките, аналитичен регистър, аналитична ведомост, отворени позиции по сметка, справка продажби, доставки, оборот на стоково-материални запаси, среднопретеглена стойност като файл). Returns the real NULA product export file. Generation is asynchronous: the response is either status="ready" with a download_url, or status="pending" with an export_id to poll via get_report_export_status. Supported report_type: balance_sheet, income_statement, cash_flow_statement, statement_of_equity, long_term_assets, trial_balance, main_book, chronological_register, depreciation_schedule, depreciation_report, asset_register, sales_register, purchases_register, account_transactions, daily_account_movements, account_open_items, sales_report, deliveries_report, inventory_movements, average_values_report. Point-in-time reports (balance_sheet, statement_of_equity) need as_of; account_open_items (отворени позиции по точна сметка и всички аналитичности) needs account_number + as_of. Period reports (income_statement, cash_flow_statement, long_term_assets, trial_balance, main_book, chronological_register) need date_from and date_to. daily_account_movements (аналитична ведомост — per-day opening/turnover/closing balances of one account or group) takes account_number + date_from + date_to and optional group_by_month. main_book (главна книга) and sales_report (справка продажби — invoice-line sales list, NOT the VAT дневник на продажбите) are excel-only. sales_report takes date_from and date_to, optional account_number (701 = 701 и подсметките ѝ, 70 = цялата група) and optional group_by: "item" for the количествено-стойностна справка по артикули (по количество и стойност за всеки артикул), "account" for the справка, обобщено по сметка. depreciation_schedule and asset_register take as_of; depreciation_report takes year; without them they are drawn up at the company's last depreciation run (its year for depreciation_report). depreciation_schedule and depreciation_report accept is_tax (tax vs accounting); asset_register accepts an optional tag. The VAT registers (sales_register, purchases_register) take month (1-12) and year. account_transactions (аналитичен регистър) takes account_number (exact number or group prefix like 70) plus date_from and date_to. chronological_register accepts optional debit_account / credit_account filters (дебит 503 / кредит 411). Pass language ("bg" or "en") to control the file language — default it to the conversation language and honor explicit user requests.

get_account_balances

ChatGPT
Closing balance and period turnover for SPECIFIC accounting accounts, for ONE OR MANY companies in a single call (крайно салдо по сметка към дата, салда по сметки, обороти по сметка, дебитен/кредитен оборот, справка по сметки за няколко фирми едновременно). THE tool for questions like "какво е салдото по сметка 501 към 30.06 за тези 10 фирми" or "дебитен оборот по 425 за юни" — never derive balances from ledger-line listings or turnover-only reports. Returns per company × per account: opening balance, debit/credit turnover, closing balance. Accepts exact account numbers (501) or group prefixes (70 = whole group). An account missing from a company's chart is flagged found=false — that is NOT a zero balance. Balances are cumulative from the fiscal-year start of as_of unless date_from is given.

get_account_open_items

ChatGPT
Open ledger positions under one EXACT accounting account and all of its analytical descendants (отворени позиции по сметка и аналитичностите ѝ, вземания по 411, задължения по 401 според оборотната ведомост). This is the ledger/trial-balance source of truth for a specific account as of a date, not an invoice-status list. It returns invoice- and bill-linked positions when available, plus imported balances, direct root or intermediate balances, and generic analytical positions that have no linked document. Use it when the user asks for the remaining balance under 411/401 and its analytics. Answer totals from totals, never by summing one page. Follow next_cursor until has_more=false; if reconciliation.reconciled=false, report the discrepancy instead of presenting the positions as a complete reconciliation. For a complete Excel or PDF file, call export_report with report_type="account_open_items", the same exact account_number and as_of date.

get_account_transactions

ChatGPT
List posted transactions for one accounting account OR an account group/section over a date range — the analytical/chronological ledger (аналитичен регистър, аналитичен регистър на сметка или група, движения по сметка, група 70, раздел 7, account ledger). Accepts an exact account number (501) or a 1-2 digit group/section prefix (70, 7) that aggregates all matching accounts. Returns bounded ledger lines with post date, debit, credit, memo, and first counterparty account when available. The response includes server-computed totals (debit/credit turnover over ALL transactions in the period, not just the returned page) — ALWAYS answer turnover/aggregate questions from totals, never by summing rows.

get_accounting_document_file

ChatGPT
Fetch a short-lived signed URL for the original PDF or image attached to an OCR accounting document. Pass the exact document_key returned by list_accounting_documents_for_review. The URL is valid for 15 minutes and live access is checked again when downloaded.

get_accounting_document_review

ChatGPT
Get the normalized OCR review model for one purchase or sales document before accounting. Purchase reviews include deterministic proposals from active explicit rules and verified history, alternatives, evidence, conflicts, and a balanced journal preview when all mappings resolve. Pass the exact document_key returned by list_accounting_documents_for_review. This is read-only and does not save, post, or modify accounting data.

get_ap_aging_report

ChatGPT
Accounts Payable aging (задължения по падеж) — open vendor bills bucketed by days past due (current, 1-30, 31-60, 61-90, 90+) as of a date. Totals are reported per settlement currency and never summed across currencies. Also lists the largest open payables so you can plan supplier payments.

get_ar_aging_report

ChatGPT
Accounts Receivable aging (вземания по падеж) — open customer receivables bucketed by days past due (current, 1-30, 31-60, 61-90, 90+) as of a date. Totals are reported per settlement currency and never summed across currencies. Also lists the largest open items so you can prioritise collections.

get_asset_details

ChatGPT
Full detail for a single fixed asset (дълготраен актив): acquisition cost, accumulated depreciation, current book value, НСС category, useful life, acquisition date, last depreciation date and currency. Acquisition cost, accumulated depreciation and book value are the figures the NULA asset page shows for the user's selected fiscal year: valued at the last depreciation booked in that year (as_of; 31.12 when none was booked), in that year's reporting currency (BGN up to 2025, EUR from 2026) returned in currency; an asset disposed of by the end of that year has a book value of 0. Always state as_of when quoting the figures. last_depreciation_date is the last depreciation posted for this asset; company_last_depreciation_date is the end of the company's last depreciation run.

get_asset_register

ChatGPT
Asset inventory book (инвентарна книга) as of a date, the company's last depreciation run unless as_of is given, or the assets as entered when no depreciation was ever run (as_of, dated_at, last_depreciation_date, dating_note) — per asset: acquisition value, total annual depreciation, end-of-depreciation date and accounting journal, plus the grand total. total_amount and asset_count cover EVERY asset in the book as of that date, while the assets listing is capped at limit rows — answer "how many assets / what is the total" from those two fields, never by counting or summing the returned rows. Money is reported in the company reporting currency for the period.

get_balance_sheet

ChatGPT
Balance Sheet (Счетоводен баланс) for a company as of a date — assets, liabilities, and equity, cumulative from the start of the as-of date's fiscal year. Returns statement lines (code, label, level, amount) in the company reporting currency. Provide as_of (YYYY-MM-DD).

get_bill

ChatGPT
Fetch a single supplier bill by id within the active team (фактура от доставчик, покупна фактура, разходна фактура). Returns a flat summary, line items, and posted accounting entries.

get_bill_pdf

ChatGPT
Fetch a download URL for the PDF on file for a bill the team received (свали фактура от доставчик като PDF, изтегли разходен документ). Bills are vendor-supplied documents — this returns the PDF that was uploaded with the bill. If no PDF is on file, returns a clean message saying so. The URL is signed and valid for 15 minutes.

get_cash_flow_statement

ChatGPT
Cash Flow Statement (Отчет за паричните потоци, ОПП) for a company over a period — operating, investing, and financing activities. Returns statement lines (code, label, level, amount) in the company reporting currency. Provide date_from and date_to (YYYY-MM-DD).

get_chart_of_accounts

ChatGPT
List the company chart of accounts (сметкоплан, индивидуален сметкоплан, списък на счетоводните сметки). Returns account number, name, and cached current balance in the company reporting currency. Optionally filter by account-number prefix.

get_company_key_figures

ChatGPT
Key financial figures of ONE company per closed calendar year, for screening companies against thresholds the user gives (категория по чл. 19 ЗСч — микро/малко/средно/голямо, SAF-T, регистрация по ДДС и др.). For a portfolio, call it once per company (team ids from list_teams). Per year, in EUR (years kept in BGN are converted at the fixed 1.95583, like the web report in EUR): net_revenue = the income statement line „Нетни приходи от продажби“ exactly as the web ОПР shows it; total_assets = „Сума на актива“ of the balance sheet at 31.12; average_staff = average monthly number of staff on employment contracts in the payroll statements kept in Nula (part-time by their share of full time, the year's sum divided by 12; payroll_months = months with a statement); nap_net_receipts (taxes and social security paid to НАП minus refunds) is not computed by Nula and is always null. Also the legal form and the current VAT registration status. A figure Nula cannot support is null with its reason in missing — never read a null as zero. Reasons: year_not_closed, no_postings_in_year (Nula has neither postings in that year nor balances brought into it), no_payroll_in_nula, not_computed, not_tracked_in_nula (Nula does not keep the VAT registration date), not_in_company_record, report_line_missing, unsupported_currency, country_not_set, time_budget_exceeded (ask again for fewer years), computation_failed.

get_counterparty_balance

ChatGPT
Салдо на контрагент — клиент или доставчик — от счетоводството към дата, по аналитичност, както е в оборотната ведомост на NULA (салдо на контрагент, салдо на доставчик, салдо на клиент, какво дължи, какво му дължим, разлика между двете салда). Контрагентът се търси по име (цяло или част от него, на кирилица или латиница) или по ЕИК / ДДС номер. За всяка разчетна сметка, под която контрагентът има аналитичност — 401 Доставчици, 411 Клиенти и другите сметки от група 4, ако има — връща крайното салдо със страната му (дебит или кредит) към края на as_of, със същото изчисление като оборотната ведомост за периода от 1 януари до as_of. В totals: колко той дължи на нас (дебитните салда), колко ние му дължим (кредитните салда) и разликата между тях. Отговаряй от totals, не събирай редовете сам. Ако търсенето съвпада с няколко контрагента, отговорът е result=multiple_matches със списък за избор, без салда и без сбор: попитай потребителя кой от тях има предвид и извикай отново със същия counterparty и counterparty_key на избрания. Салдата са от счетоводството, не от статуса на фактурите; отделните фактури под аналитичността дава get_account_open_items.

get_current_draft_audit

ChatGPT
Explain the decisions made on the current pending draft in plain business language. Use this when the user asks why a draft looks the way it does, or to review auto-resolved choices (e.g. which bank account, which inventory item) before confirming.

get_depreciation_report

ChatGPT
Depreciation quota report (амортизационна квота) — the monthly and annual depreciation booked per asset, broken down by year and month, for the year of the company's last depreciation run unless year is given, or the year the assets stand as entered when no depreciation was ever run (dated_at, last_depreciation_date, dating_note). Pass is_tax=true for the tax (данъчна) quota; defaults to the accounting (счетоводна) quota. Money is reported in major units in the asset reporting currency.

get_depreciation_schedule

ChatGPT
Depreciation schedule (амортизационен план) as of a date — per asset: depreciable value, accrued (accumulated) depreciation, remaining book value, year-to-date depreciation, useful life and annual rate, plus per-currency totals, drawn up at the company's last depreciation run unless as_of is given, or the assets as entered when no depreciation was ever run (as_of, dated_at, last_depreciation_date, dating_note). Pass is_tax=true for the tax (данъчен) schedule; defaults to the accounting (счетоводен) schedule. Money is reported per currency.

get_draft_status

ChatGPT
Check whether the user has a pending draft ready to confirm. Returns a short business-language status (none / one ready / multiple pending). Use this when the user asks "do I have anything in flight?" or before suggesting they start a new draft.

get_fixed_assets_inventory

ChatGPT
Fixed-assets inventory list (инвентаризационен опис на ДМА) as of a date, the company's last depreciation run unless as_of is given, or the assets as entered when no depreciation was ever run (as_of, dated_at, last_depreciation_date, dating_note) — per asset: accounting journal, acquisition value, accumulated depreciation, book value, depreciation charged this year and end-of-depreciation date. Only assets acquired by that date and not disposed of before it are included. asset_count and totals (per column, per currency) cover EVERY asset in the list, while the assets listing is capped at limit rows — answer "how many / what is the total" from those fields, never by counting or summing rows. Money is reported in the reporting currency of the date (BGN up to 2025, EUR from 2026).

get_income_statement

ChatGPT
Profit & Loss / Income Statement / P&L (Отчет за приходите и разходите, ОПР) for a company over a period. This is the single source for any REVENUE, INCOME, EXPENSE, COST, or PROFIT figure, including individual expense or income line items such as "outside services" (външни услуги), materials, raw materials, personnel/salary costs, depreciation, other operating expenses, net sales revenue, financial income/expenses, and the resulting profit or loss. Returns the statement lines — code, label, hierarchy level, and amount — in the company reporting currency. Figures are net accounting amounts derived from the posted double-entry ledger. Use this (NOT journal entries or the trial balance) whenever the user asks for a specific expense, cost, revenue, or income line over a date range. Provide date_from and date_to (YYYY-MM-DD).

get_inventory_batch_stock

ChatGPT
Batch quantities in ONE company warehouse as of a date. Requires read-bills. Uses dated opening balances and movements at that warehouse. Each row is a distinct batch; duplicate lot numbers are not combined. Zero-quantity batches with historical activity are included. For accounting value use get_inventory_stock; for transaction history use list_warehouse_movements.

get_inventory_stock

ChatGPT
Stock quantities and accounting value in ONE warehouse as of a date. Select a warehouse by location_id; if omitted, returns accessible warehouse choices. Rows use the same opening balances, transactions, and currency conversion as the NULA warehouse report. totals cover the returned page; when has_more is true they are not totals for the entire filtered warehouse. Never add quantities across different units.

get_invoice

ChatGPT
Fetch a single invoice by id within the active team (фактура към клиент, продажна фактура, изходяща фактура). Returns a flat summary plus line items (what was invoiced — name, quantity, price, description).

get_invoice_pdf

ChatGPT
Fetch a fresh download URL for an invoice PDF in the active team (нов линк за сваляне, свали фактура като PDF, изтегли фактурата, фактура в PDF). Resolve it by invoice_number and optional customer_name when the user provides consumer-facing details; invoice_id is supported only when copied from list_invoices. The URL is signed and valid for 15 minutes.

get_journal_entry

ChatGPT
Fetch one posted journal entry with its debit and credit lines (счетоводен запис, счетоводна статия, мемориален ордер). Lines include account number, account name, debit, and credit in major units. account_name is always the name of the GL account itself; when a line posts to a per-document analytic sub-account, that sub-account's narration is reported separately as line_detail — it is not the account name and often repeats the entry memo.

get_long_term_assets_report

ChatGPT
Long-term assets statement (справка за дълготрайните активи, part of the annual financial statements / ГФО) for a period — per asset group (intangible, tangible, financial, deferred taxes, and the grand total of all four in total) its cost at the beginning, receipts, disposals, cost at the end, revaluation, depreciation at the beginning, accrued, written off and at the end, and the carrying amount at the end (the 15 columns of the official form, named in columns). Defaults to 1 January to the company's last depreciation run of that year, or the assets as entered when no depreciation was ever run (dated_at, last_depreciation_date, dating_note). Rows that are zero in every column are left out (zero_rows_omitted). Money is in the company reporting currency of the period unless currency is given.

get_management_report

ChatGPT
Management / budget-vs-actuals reports — user-defined report templates (custom rows of accounts × period columns, e.g. budget vs actual, month-over-month). Call without report_id to list the saved templates for the company; call with report_id to run one and get its computed grid (columns with periods, rows with a value per column). Money values are in the company currency.

get_purchases_register

ChatGPT
Purchases VAT register / дневник на покупките for a monthly tax period — the per-document list of received bills that feed the VAT return. Each row carries the document's NAP cell codes and values (taxable base, input VAT with full/partial/no credit). Use columns to interpret the cell codes. The response includes server-computed totals (per money column, over ALL rows in the period) and a summary with the period's taxable bases and input VAT — ALWAYS answer aggregate questions from totals/summary, never by summing the paginated rows. Provide month (1-12) and year. Rows are paginated.

get_report_export_status

ChatGPT
Check the status of an accounting-report export started by export_report (проверка на статуса на експорта на справка). Returns status="pending"|"processing"|"ready"|"failed"; when "ready" it includes a fresh download_url.

get_sales_register

ChatGPT
Sales VAT register / дневник на продажбите for a monthly tax period — the per-document list of issued sales that feed the VAT return. Each row carries the document's NAP cell codes and values (taxable base, VAT charged, exempt/zero-rated amounts). Use columns to interpret the cell codes. The response includes server-computed totals (per money column, over ALL rows in the period) and a summary with the period's total taxable base and total VAT charged — ALWAYS answer aggregate questions from totals/summary, never by summing the paginated rows. Provide month (1-12) and year. Rows are paginated.

get_sales_report

ChatGPT
Справка продажби (sales report, Бизнес > Справка продажби) за фирма и период — продадените артикули по редове от фактури: дата, документ, сметка за продажба, код и име на артикула, мерна единица, клиент, количество, единична цена и стойност в основната валута. За количествено-стойностна справка по артикули (по количество и стойност за всеки артикул) подай group_by="item"; за справка, обобщено по сметка за продажба — group_by="account". account_number ограничава справката до една сметка: 701 включва 701 и подсметките ѝ (701/…), 70 — цялата група. totals са сборовете за целия период, изчислени на сървъра: отговаряй на въпроси за общо количество и стойност само от тях и никога не сумирай редове или групи сам. Количествата се събират само в рамките на една мерна единица (totals.by_unit) — никога не събирай м2, MWh, брой и т.н. в едно число. Без проформи и анулирани документи, както уеб справката. За Excel файл със същите редове или същото обобщение използвай export_report с report_type="sales_report" и същите group_by и account_number.

get_trial_balance

ChatGPT
Trial Balance (оборотна ведомост) for a company over a period — for each account that moved in the period: opening balance, debit turnover, credit turnover, closing balance, in the company reporting currency. Total debit turnover equals total credit turnover (balanced double-entry). Accounts are returned largest-turnover first. Use before period close to spot anomalies. Provide date_from and date_to (YYYY-MM-DD).

get_vat_register_counts

ChatGPT
Number of entries (брой записи) in the purchases and sales VAT registers (дневник покупки / дневник продажби) for ONE OR MANY companies for a monthly tax period, plus their sum per company and across all companies. THE tool for "колко записа има в дневниците", "брой документи по ДДС дневници за всички фирми", "кои дружества имат над 120 записа", billing an accounting firm's clients by register volume. Pass every target company in one call (up to 500 team ids from list_teams) and never split the list yourself; the server reports as many companies as fit its time budget and returns the rest in remaining_team_ids. Companies not registered for VAT are listed in not_vat_registered instead of being shown as zero. The counts equal the total of get_purchases_register and get_sales_register for the same company and month.

get_vat_return

ChatGPT
VAT return / ДДС справка-декларация for a monthly tax period (Bulgarian VAT is filed monthly). Returns the declaration cells — code, label, value — covering taxable bases, output VAT charged, input VAT credit, and the VAT payable or refundable for the period. Every amount in fields is in currency (ISO 4217 code), the currency the return for that month is kept in: BGN for periods before 01.01.2026, EUR from 01.01.2026 for a Bulgarian company. Read it from the response instead of assuming the company's current currency, and compare these amounts with another report only when both are in the same currency. Provide month (1-12) and year. To cover a quarter, call once per month and sum. A company that is not registered for VAT has no VAT return: the tool answers error="not_vat_registered" instead of a declaration, and that answer means no return is due for the period — never present it as a zero declaration. A month that has not begun is not a tax period either: it answers error="period_not_started", which means the question is invalid, NOT that the return is zero. When a declaration IS returned, period_status says whether the month is closed (final) or still in_progress (provisional), declaration_filed says whether a declaration is actually stored for the period. When every cell is zero, zero_reason says WHY: "unfinished_period" (the month is not over), "filed_nil_return" (a stored declaration reports nil), or "no_records" (nothing is recorded for the period at all — an absence of records, NOT a reported nil position and NOT proof that nothing was due). Read these as different statements; all of them used to look like the same all-zero form.

get_vies_return

ChatGPT
VIES return / VIES декларация for a monthly tax period — the per-document list of intra-community supplies (sales to VAT-registered counterparties in other EU member states) reported to NAP alongside the VAT return. Each row carries the document's NAP cell codes and values. Use columns to interpret the cell codes. The response includes server-computed totals (per money column, over ALL rows in the period) — ALWAYS answer aggregate questions from totals, never by summing the paginated rows. Provide month (1-12) and year. Rows are paginated. An empty rows set means no intra-community supplies for the period.

list_accounting_documents_for_review

ChatGPT
List all active OCR purchase and sales documents waiting for final accounting save in Nula. Pass one team_id, or scope=all_accessible for one globally paginated queue across every live company this connection may read. Saving OCR fields does not remove a document from this queue; creating the Bill or Invoice does. The list includes every OCR extraction state. Use document_key and its team.id from this response with get_accounting_document_review. Results omit extracted OCR text and storage paths.

list_accounting_treatment_rules

ChatGPT
List persisted supplier accounting treatment rules and their lifecycle lineage. Use this before change_accounting_treatment_rule_draft or disable_accounting_treatment_rule_draft to resolve the exact active rule id.

list_bank_transactions

ChatGPT
Latest bank transactions for ONE bank account from the Banking module — the real bank-feed movements (банкови транзакции, движения по банкова сметка, извлечение, последни плащания по сметката), NOT accounting ledger entries. The user MUST specify which bank account first: pass iban (preferred, from bank_balances), account_id, or account_name; when the account is not specified or several accounts match, show the user the accounts by IBAN and ask which one they mean — IBAN is the identifier users recognise, account_id is internal. Returns the most recent transactions with date (the bank booking date — the same date Nula shows in its bank and reconciliation screens; use it whenever you cite a transaction date), value_date (the operation date — for card/POS payments it is usually 1–2 days before date, and the exact time often appears inside the description), counterparty/description, amount, direction (incoming/outgoing), currency, and whether the transaction is booked/reconciled in accounting, plus server-computed totals (incoming/outgoing/net over the returned window) — ALWAYS answer aggregate questions from totals and the account balance, never by summing rows.

list_bills

ChatGPT
List supplier bills (accounts payable; задължения към доставчици, фактури от доставчици, покупни фактури) for the active team, filtered by number, status, vendor, or date range. status=unpaid is a derived predicate for every not-fully-paid bill (the full open-payables set, regardless of due date). status=overdue narrows that to unpaid + past due_at. The response includes has_more (true when further pages exist) and next_cursor — to capture ALL results, pass next_cursor back as cursor until has_more is false; do NOT walk with page, which can silently skip a bill when documents are written between two calls. The response also includes server-computed totals (document totals per currency over the ENTIRE filtered set, not just the returned page) — ALWAYS answer aggregate questions from totals, never by summing rows. For REMAINING amounts owed (partially-paid aware) use get_ap_aging_report. To MIRROR bills into another system, use updated_since instead of a date range: it sweeps by modification time, so a document entered or corrected today but dated earlier is still seen, and it is the only mode that reports DELETED bills (as a tombstone) — without it a mirror can never learn a bill was removed. It excludes totals and refuses the other filters — walk it with next_cursor, checkpoint on the highest updated_at, and upsert by id. During the one repeated hour of the autumn DST rollback the stored local time is ambiguous; overlap that checkpoint by an hour, or rely on the upsert.

list_fixed_assets

ChatGPT
The company's fixed-asset list (дълготрайни активи) exactly as the NULA Assets page shows it for the user's selected fiscal year: number, name, НСС category with its default rate, acquisition date, acquisition cost, accumulated depreciation and residual (book) value, plus whether the asset is active, sold or written off. Every amount is valued at the last depreciation booked in that fiscal year (as_of; 31.12 when none was booked) in that year's reporting currency (BGN up to 2025, EUR from 2026); an asset disposed of by the end of that year has a residual value of 0. Always state as_of when quoting the figures, and last_depreciation_date (the end of the company's last depreciation run, null when none was run) when asked how current they are. Ordered by asset number, highest first, like the page. Filter by name/number, tag, category, acquisition year or date range, and active/sold/written off. total counts every matching asset; the per-currency totals cover only the RETURNED rows — answer aggregate questions from totals, never by summing rows; for the authoritative full register with grand total use get_asset_register.

list_inventory_items

ChatGPT
List products and materials in one company inventory catalog, including SKU, unit, and tracking flags. Search by name, SKU, or barcode. This is a catalog, not a stock balance; use get_inventory_stock for quantities and value in a warehouse.

list_invoices

ChatGPT
List invoices (фактури към клиенти, продажни фактури, вземания от клиенти) for the active team, filtered by number, status, customer, or date range. status=unpaid is a derived predicate for every open receivable (issued + not fully paid, regardless of due date; unissued drafts, proformas and credit notices excluded). status=overdue narrows that to past-due receivables. The response includes has_more (true when further pages exist) and next_cursor — to capture ALL results, pass next_cursor back as cursor until has_more is false; do NOT walk with page, which can silently skip an invoice when documents are written between two calls. Results are flat summaries — call get_invoice for full detail. The response includes server-computed totals (document totals per currency over the ENTIRE filtered set, not just the returned page) — ALWAYS answer aggregate questions from totals, never by summing rows. For REMAINING amounts owed (partially-paid aware) use get_ar_aging_report. To MIRROR invoices into another system, use updated_since instead of a date range: it sweeps by modification time, so a document entered or corrected today but dated earlier is still seen. It excludes totals and refuses the other filters — walk it with next_cursor, checkpoint on the highest updated_at, and upsert by id. During the one repeated hour of the autumn DST rollback the stored local time is ambiguous; overlap that checkpoint by an hour, or rely on the upsert.

list_journal_entries

ChatGPT
List posted journal entries for a company over a date range (счетоводни записи, журнал на операциите, статии, дневник на операциите). Returns bounded journal groups with post date, memo, and total debit in major units, plus server-computed totals (entry count and debit turnover over ALL entries in the period, not just the returned page) — ALWAYS answer aggregate questions from totals, never by summing rows.

list_teams

ChatGPT
List the companies this connection can act on. Always call this first. Each row includes: company_name (the legal name of the company — this is the name the user sees in NULA and the one they will call it by; it can differ from name/display_name, which are the team's own labels; null when the team has no company), default_currency (the company's invoicing currency this fiscal year), default_currency_for_year (a 3-year map — Bulgarian companies switch BGN→EUR on 2026-01-01), company_eik (legal identifier / ЕИК / БУЛСТАТ), vat_id (VAT registration number, null when not VAT-registered), and is_vat_registered (whether the company is VAT-registered). IMPORTANT: when more than one company is returned, active_team_id is null and requires_team_selection is true — there is NO default company. Ask the user which company they mean and pass its id as team_id on every call; do not guess. Only when a single company is returned is it the implicit default.

list_vendors

ChatGPT
List vendors for the active team (доставчици, контрагенти-доставчици), optionally filtered by name substring. Includes total unpaid balance per vendor in the team default currency, plus server-computed totals (sum of the RETURNED page unpaid balances) — answer aggregate questions from totals, never by summing rows; for the full AP picture use get_ap_aging_report.

list_warehouse_movements

ChatGPT
Dated incoming and outgoing inventory transactions in ONE company warehouse. Requires read-bills. Omit location_id for warehouse choices. Filter by item or exact batch. Opening balances are excluded. Accounting-amount and quantity totals cover only the returned page, grouped by currency and unit; use get_inventory_stock for as-of stock.

log_expense_draft

ChatGPT
Preview a cash-paid expense before posting. Builds the expense receipt so the user can review the vendor, total, VAT, and date, and only commits to the books when the user confirms. Use this whenever the user is logging a cash expense. Bookkeeping only: it records an expense that was already paid and moves no money. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

mark_bill_paid

ChatGPT
Mark a vendor bill as paid without creating a payment, bank transaction, or bank transfer. Use only when the user explicitly wants to update the bill status without recording how it was settled. Bookkeeping only: it changes the bill status and moves no money.

mark_invoice_paid

ChatGPT
Mark a customer invoice as paid without recording a specific bank or cash payment leg. Use only when the user has settled the invoice off-the-books and just wants the status updated. Prefer record_invoice_payment for real bank-received invoices. Bookkeeping only: it changes the invoice status and moves no money.

record_invoice_payment_draft

ChatGPT
Preview a customer bank payment against an outstanding invoice before posting. Validates the invoice and bank account and shows the resulting invoice status (paid or partially paid) so the user can review before committing. Bookkeeping only: it records a payment the customer already made and moves no money. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

retry_accounting_document_ocr

ChatGPT
Retry OCR extraction for one exact failed or stalled purchase or sales document. This does not create or post accounting records. Pass the exact document_key from list_accounting_documents_for_review.

search_accounting_document_inventory_items

ChatGPT
Search existing purchasable inventory items for one processed purchase OCR document. Results include the purchase account derived from each item and whether it can safely be selected for the requested source line. This is read-only and never creates or changes items, rules, bills, or journal entries.

search_accounting_document_vendors

ChatGPT
Search existing active vendors for one processed purchase OCR document. Results expose stable vendor record identifiers and matching evidence for explicit UI selection. This is read-only and never creates or changes vendors, documents, bills, rules, or journal entries.

search_accounts

ChatGPT
Търсене на сметка по номер или име в сметкоплана на избраната фирма (намери сметка по номер или име), включително аналитичностите на контрагенти — клиенти и доставчици под 401, 411 и другите разчетни сметки. Номерът съвпада точно или по начало: 41 намира 410, 410/1 и 411. Подредба: точен номер, после начало на номер, после име на сметка, после аналитичност на контрагент с пътя си (kind=counterparty_analytic, path например „401 / ИМЕ ЕООД“) и накрая аналитичните партиди на стоки, така че сметкопланът не се зарива. Търсене по номер не връща партиди на стоки и аналитичности по име, и казва ясно, ако няма сметка с този номер. Отделните фактури под аналитичностите не се връщат. Връща до 50 резултата с кешираното текущо салдо; за салдо на контрагент към дата от оборотната ведомост ползвай get_counterparty_balance.

send_invoice_email

ChatGPT
Email an invoice PDF to one or more recipients. Use only when the user has approved sending — and verified the recipient addresses are correct.

top_debtors

ChatGPT
Top customers with the largest outstanding (unpaid) balance for the active team (най-големи длъжници, вземания от клиенти, кой ми дължи най-много). Each debtor carries amounts_by_currency — the outstanding balance per settlement currency, never summed across currencies. total_owed is that same debtor converted into the team reporting currency (reporting_currency) for ranking, and is null when part of the balance has no trustworthy rate.

update_accounting_document_review

ChatGPT
Apply explicitly confirmed document-detail, vendor, payment, and inventory-item accounting corrections to one processed purchase OCR review. Vendor identity and the purchase account are derived from selected existing records. This changes only OCR staging data and never creates a vendor, item, rule, bill, or journal entry.

update_bill_draft

ChatGPT
Preview changes to an existing incoming bill before posting them. Shows what would change so the user can review before committing. Use this whenever the user asks to edit a bill. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

update_invoice_draft

ChatGPT
Preview a patch to an existing outgoing invoice before saving it. Resolve the invoice by consumer-facing invoice_number and optional customer_name, then pass only the fields the user asked to change: every change requested so far for that invoice, including the changes of an earlier unconfirmed preview this one replaces. Omitted fields and lines are preserved. Returns explicit before/after changes for review. A preview changes no saved data and never changes or cancels another preview. To change a preview, make a new one with all its values and cancel the old one with the matching cancel tool.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/nula"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/nula)