MCP server

inv.bg MCP by usefulapi

io.usefulapi/inv-bg

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read inv.bg invoices, clients, items, payments and banking; create clients, items, invoices.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

27

Token cost

About 8,172 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http inv-bg https://inv-bg.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.inv-bg]
url = "https://inv-bg.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"inv-bg":{"httpUrl":"https://inv-bg.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"inv-bg":{"url":"https://inv-bg.usefulapi.io/mcp"}}}

VS Code

{"servers":{"inv-bg":{"type":"http","url":"https://inv-bg.usefulapi.io/mcp"}}}

Antigravity

agy mcp add inv-bg https://inv-bg.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"inv-bg","server_url":"https://inv-bg.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"inv-bg","server_url":"https://inv-bg.usefulapi.io/mcp"}

Tools

• invbg_create_client ~377 tokens
  WRITE: add a company client (name, Bulstat, VAT, address, MOL). Check invbg_list_clients first to avoid a duplicate. For an individual (EGN) issue the document with invbg_create_invoice and is_to_person instead. POST /clients.
• invbg_create_invoice Moves money · ~1425 tokens
  WRITE: create a document (tax invoice by default; proforma, debit/credit note via type). It is saved as a DRAFT unless draft is false: an issued document takes the next legal number and cannot be undone through this tool. Address it to an existing client_id, or give to_name + to_address (+ to_mol an
• invbg_create_item ~246 tokens
  WRITE: add a product or service to the catalogue (name, price, unit). POST /items.
• invbg_get_account ~68 tokens
  The company (id, name, subdomain) and the user the API token belongs to. GET /account.
• invbg_get_client ~169 tokens
  One client by id with all stored details (names in both languages, Bulstat, VAT, address, MOL, code, custom properties). GET /clients/{id}.
• invbg_get_exchange_rate ~157 tokens
  The exchange rate of a currency to BGN on a date (default: today), as inv.bg uses it for documents. GET /currency/rates/{currency}.
• invbg_get_firm ~82 tokens
  The issuing company's details: name, Bulstat, VAT registration and VAT number, address, MOL, contact email, custom properties. GET /firm.
• invbg_get_invoice ~228 tokens
  One document by id: number, type, issuer and recipient, line items, VAT, totals, balance_paid and balance_due, dates, bank accounts, sent/confirmation status. Optionally with its comments. GET /invoices/{id}.
• invbg_get_item ~138 tokens
  One catalogue item by id. GET /items/{id}.
• invbg_get_next_invoice_number ~124 tokens
  The next free document number of the default number set for a document type. Read-only: it does not reserve the number. GET /invoices/free-number.
• invbg_get_payment ~116 tokens
  One payment by id with its allocations to invoices (invoice_payments). GET /payments/{id}.
• invbg_list_bank_accounts ~187 tokens
  The company's bank accounts (alias, bank, IBAN, BIC, currency). GET /bank/accounts.
• invbg_list_bank_transactions ~518 tokens
  Imported bank transactions with amount, date, counterparty, and whether they are linked to a document. Useful for reconciliation (linked=false = unmatched). GET /bank/transactions.
• invbg_list_cashboxes ~175 tokens
  The company's cash registers (cashboxes) with names and balances. GET /cashboxes.
• invbg_list_client_contacts ~218 tokens
  Contact people of a client (or of all clients) with their names and roles. GET /client-contacts.
• invbg_list_clients ~464 tokens
  List or search clients (customers): name, Bulstat, VAT number, address, MOL, whether it is a person. GET /clients.
• invbg_list_invoice_types ~85 tokens
  All document types of this company (tax invoice, proforma, debit/credit note and any custom types) with their codes. GET /invoices/types.
• invbg_list_invoices ~924 tokens
  List documents (tax invoices, proformas, debit and credit notes) with filters: type, number, issue-date range, amount ranges, payment status, client, draft/annulled, sent status, currency. Each row has number, client, totals, balance_paid, balance_due and dates. GET /invoices.
• invbg_list_item_units ~110 tokens
  Units of measure accepted as quantity_unit on items and invoice lines. GET /items/units.
• invbg_list_items ~320 tokens
  The product/service catalogue: name, price, currency, unit, tags. GET /items.
• invbg_list_number_sets ~164 tokens
  The company's invoice number sets (separate numbering series) with ids; pass an id as number_set to invbg_create_invoice. GET /invoices/number-sets.
• invbg_list_payment_methods ~120 tokens
  The payment method codes a document accepts (cash, bank, card, ...) with their names. GET /invoices/payment-methods.
• invbg_list_payments ~556 tokens
  Recorded payments (income and expense) with amount, method, date, counterparty, how much is allocated to invoices (amount_used) and what is left (amount_left). GET /payments.
• invbg_list_vat_exemption_reasons ~130 tokens
  The legal reasons for issuing a document without VAT (use one as vat_exemption_reason in invbg_create_invoice). GET /invoices/without-vat-reasons.
• invbg_record_invoice_payment ~439 tokens
  WRITE: record a payment received for a document and allocate it, which updates the document's balance_paid/balance_due and payment status. Two calls: POST /payments, then POST /payments/{id}/invoices. If the allocation fails the payment stays recorded: the error names its id (see invbg_get_payment).
• invbg_send_invoice_email Sends messages · ~362 tokens
  WRITE: email a document to a recipient (as a download link or an attached file). The email goes out immediately and cannot be recalled. POST /invoices/{id}/emails.
• invbg_update_client ~270 tokens
  WRITE: change fields of an existing client (only the fields you pass are changed). PATCH /clients/{id}.

Browse

• Email
• Payments
• Invoicing and accounting
• Legal research

Related MCP servers

• SuperFaktura MCP by usefulapi
  Read SuperFaktura invoices, clients, expenses, bank and stock; create clients, expenses and drafts.
• Billomat MCP by usefulapi
  Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices.
• SmartAccounts MCP by usefulapi
  Read SmartAccounts clients, vendors, invoices, payments, ledger, accounts; create and book records.
• Vyfakturuj MCP by usefulapi
  Read and create Vyfakturuj invoices and contacts: search, number series, payment methods, tags.
• Lexware Office MCP by usefulapi
  Read Lexware Office contacts, articles, invoices and vouchers; create contacts and draft invoices.
• Hiveage MCP by usefulapi
  Manage Hiveage clients, invoices, estimates and payments; send invoices and record payments.
• Merit Aktiva MCP by usefulapi
  Read Merit Aktiva invoices, customers, vendors, items, payments and reports; create a customer.
• Practice Better MCP by usefulapi
  Read Practice Better clients, sessions, availability, services, packages, invoices and forms.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/inv-bg.svg)](https://aptlynx.net/servers/io.usefulapi/inv-bg)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents