Skip to content
Agentmart
Submit a tool

NULA.BG

Bulgarian accounting platform nula.bg: invoices, bills, OCR, customers, inventory and banking.

Connector by encorp-io · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/encorp-io-nulabg-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Bulgarian accounting platform nula.bg: invoices, bills, OCR, customers, inventory and banking.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
14 read · 5 write · 3 delete · 4 not yet classified
Secrets
2 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 26

Read from the source code; the running server may list different tools.

Read 14 · Look things up without changing anything.

  • nula_list_bank_accounts
  • nula_list_bank_transactions
  • nula_list_companies
  • nula_list_item_categories
  • nula_lookup_company
  • nula_match_bank_transactions
  • nula_noi_documents
  • nula_nra_declarations
  • nula_nra_refresh_result
  • nula_ocr_status
  • nula_search_bills
  • nula_search_customers
Show 2 more tools
  • nula_search_invoices
  • nula_search_items

Write 5 · Create, change, send or run things.

  • nula_create_bill
  • nula_create_invoice
  • nula_ocr_upload
  • nula_update_bill_categories
  • nula_update_invoice_metadata

Delete 3 · Delete, drop, revoke or wipe things.

  • nula_delete_last_invoice
  • nula_email_invoice
  • nula_update_invoice

Not yet classified 4 · We could not tell from the name and description.

  • nula_get_invoice_pdf
  • nula_noi_get_document
  • nula_period_summary
  • nula_receivables_report

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • NULA_API_KEY
  • NULA_PROFILES

Other settings (environment variables or headers).

  • NULA_READ_ONLY

Network hosts it talks to 1

  • github.com · found in install command

Tools (26)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • nula_create_billRecord a purchase bill

    Record a purchase document (покупка / входяща фактура) from a supplier, optionally with a protocol under чл.117 ЗДДС. Call with preview_only: true first and confirm with the user. For scanned documents prefer nula_ocr_upload, which creates bills automatically.

  • nula_create_invoiceCreate a sales invoice

    Create a sales document (фактура, проформа, дебитно/кредитно известие, протокол) in nula.bg. ALWAYS call first with preview_only: true and show the user the preview (number, customer, lines, totals); create it only after the user confirms. Look up unfamiliar customers with nula_lookup_company first. A missing customer and missing items are created automatically in nula.bg.

  • nula_delete_last_invoiceDelete the most recent invoicecan change or delete data

    Delete the MOST RECENT invoice. nula.bg deletes only the last invoice in the sequence (the endpoint takes no parameters) and refuses invoices already posted to accounting (осчетоводена) with HTTP 403. In companies where accounting posts every invoice automatically, deletion via the API is not possible at all — issue a credit note instead. Pass the number you expect to delete; the call is refused if a different invoice is last.

  • nula_email_invoiceE-mail an invoicecan change or delete data

    E-mail an invoice to a recipient from nula.bg. This contacts a third party and cannot be undone: confirm the recipient address and language with the user first.

  • nula_get_invoice_pdfDownload invoice PDF

    Download the PDF of an invoice in Bulgarian or English and save it locally (or return it inline).

  • nula_list_bank_accountsList bank accounts

    List the bank accounts (банкови сметки) connected in nula.bg, with their ids for nula_list_bank_transactions.

  • nula_list_bank_transactionsList bank transactions

    List bank transactions (банкови движения) of one account for a period. Get account ids from nula_list_bank_accounts.

  • nula_list_companiesList configured companies

    List the nula.bg companies (profiles) configured in this MCP server. Pass the alias as `company` to other tools to act on that company. API keys are never shown.

  • nula_list_item_categoriesList item categories

    List item categories (категории на артикули) that have at least one item.

  • nula_lookup_companyLook up a company (ЕИК / VAT)

    Look up a company (фирма) by Bulgarian EIK (ЕИК/БУЛСТАТ), EU VAT number or name via nula.bg (Commercial Register / VIES). Use it BEFORE creating an invoice or bill for a counterparty you have not seen, to get the exact legal name and VAT number. Never invent an EIK.

  • nula_match_bank_transactionsSuggest bank ↔ invoice matches

    Suggest which incoming bank transactions pay which unpaid sales invoices (by amount, invoice number in the payment reason, customer name/EIK). Only suggestions: nothing is changed. Mark invoices paid with nula_update_invoice_metadata after the user agrees.

  • nula_noi_documentsНОИ documents (Прил. 9/10/11)

    List НОИ (NOI) documents for employee leave (болнични, майчинство: Приложения 9/10/11) with period, employee, status and входящ номер. Download one with nula_noi_get_document.

  • nula_noi_get_documentDownload НОИ document

    Download the НОИ XML (BPril9/10/11) of a leave, or the PDF with НОИ's submission result.

  • nula_nra_declarationsНАП declarations

    List declarations prepared or submitted to НАП (NRA) from nula.bg (e.g. VAT returns), newest first, with status and входящ номер. Give submission_id and download_file to save one of its files. Monitoring only: this server cannot sign or file declarations.

  • nula_nra_refresh_resultRefresh НАП processing result

    Ask НАП (NRA) again for the processing result of one submitted declaration and update its status in nula.bg.

Show 11 more tools
  • nula_ocr_statusOCR uploads and quota

    List documents sent to OCR (newest first) with their recognition status, or get one recognised document with its lines (give document_type and id). Also reports the remaining OCR quota.

  • nula_ocr_uploadScan documents with OCR

    Send 1–10 scanned documents (PDF/JPG/PNG) to nula.bg OCR, which creates purchase bills (покупки) or sales invoices from them. Each document uses OCR quota. By default waits for recognition and returns the extracted data so you can review it with the user.

  • nula_period_summarySales and purchases summary

    Summary for a month or period: number and totals of sales and purchases, VAT charged vs VAT on purchases, top customers and suppliers. Indicative only: this is NOT the official VAT return (справка-декларация).

  • nula_receivables_reportReceivables and overdue invoices

    Unpaid and overdue sales invoices (вземания, просрочени фактури) as of a date, grouped by customer with aging buckets (0–30 / 31–60 / 61–90 / 90+ days overdue). Read-only.

  • nula_search_billsSearch purchase bills

    Find purchase documents (покупки, входящи фактури от доставчици) by period, supplier or number. Pass bill_id to get one bill in full with its lines.

  • nula_search_customersSearch customers

    Find customers/counterparties (клиенти, контрагенти) by name, EIK or VAT number, or get one by id. nula.bg has no API to create customers directly: nula_create_invoice creates a missing customer automatically.

  • nula_search_invoicesSearch sales invoices

    Find sales documents (фактури, проформи, дебитни/кредитни известия) by period, customer, type or number. Pass `number` to get one document in full, including its lines. Without document_type, proformas are excluded.

  • nula_search_itemsSearch items and stock

    Find products/services (артикули) with prices and available stock (наличност). Give sku for an exact match, or query/name to match the name. Use it before invoicing to reuse the correct item name, sku and price.

  • nula_update_bill_categoriesSet bill categories

    Replace the categories (категории/тагове) of a purchase bill.

  • nula_update_invoiceReplace an invoice’s contentcan change or delete data

    Replace the content (customer, dates, lines, amounts) of an existing invoice. nula.bg overwrites the whole document, so first read it with nula_search_invoices(number) and send the COMPLETE corrected document. For paid/sent status or categories only, use nula_update_invoice_metadata instead.

  • nula_update_invoice_metadataMark paid/sent, set categories, attach file

    Change an invoice's paid/sent status, replace its categories (категории) or attach a file, without touching its lines or amounts. Give at least one of is_paid, is_sent, categories, attachment.

Signals

Stars
0
Forks
0
Open issues
0
Last commit
Sep 26, 2026 (1 month ago)
Last release
Sep 26, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.encorp-io/nulabg-mcp
Version
0.1.0
Auth
API key
Packages
npm nulabg-mcpmcpb https://github.com/encorp-io/nulabg-mcp/releases/download/v0.1.0/nulabg-mcp-0.1.0.mcpb
License
MIT
Repository
github.com/encorp-io/nulabg-mcp
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

NULA.BG MCP server. Agent Mart. https://agentmart.dev/connectors/encorp-io-nulabg-mcp (last updated 2026-10-25)