io.usefulapi/inv-bg

up checked 2026-11-11T07:39:45.980Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

inv.bg MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Reads and writes invoices, clients, catalogue items, payments and bank data for a Bulgarian accounting company, and can email documents.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add inv-bg --url https://inv-bg.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (27 tools)

Publisher-provided text

• invbg_get_account The company (id, name, subdomain) and the user the API token belongs to. GET /account.
• invbg_get_firm The issuing company's details: name, Bulstat, VAT registration and VAT number, address, MOL, contact email, custom properties. GET /firm.
• invbg_list_invoices List documents (tax invoices, proformas, debit and credit notes) with filters: type, number, issue-date range, amount ranges, payment status, client, draft/annu
• invbg_get_invoice One document by id: number, type, issuer and recipient, line items, VAT, totals, balance_paid and balance_due, dates, bank accounts, sent/confirmation status. O
• invbg_list_invoice_types All document types of this company (tax invoice, proforma, debit/credit note and any custom types) with their codes. GET /invoices/types.
• invbg_get_next_invoice_number 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_list_number_sets 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 The payment method codes a document accepts (cash, bank, card, ...) with their names. GET /invoices/payment-methods.
• invbg_list_vat_exemption_reasons 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_list_clients List or search clients (customers): name, Bulstat, VAT number, address, MOL, whether it is a person. GET /clients.
• invbg_get_client One client by id with all stored details (names in both languages, Bulstat, VAT, address, MOL, code, custom properties). GET /clients/{id}.
• invbg_list_client_contacts Contact people of a client (or of all clients) with their names and roles. GET /client-contacts.
• invbg_list_items The product/service catalogue: name, price, currency, unit, tags. GET /items.
• invbg_get_item One catalogue item by id. GET /items/{id}.
• invbg_list_item_units Units of measure accepted as quantity_unit on items and invoice lines. GET /items/units.
• invbg_list_payments Recorded payments (income and expense) with amount, method, date, counterparty, how much is allocated to invoices (amount_used) and what is left (amount_left).
• invbg_get_payment One payment by id with its allocations to invoices (invoice_payments). GET /payments/{id}.
• invbg_list_bank_accounts The company's bank accounts (alias, bank, IBAN, BIC, currency). GET /bank/accounts.
• invbg_list_bank_transactions Imported bank transactions with amount, date, counterparty, and whether they are linked to a document. Useful for reconciliation (linked=false = unmatched). GET
• invbg_list_cashboxes The company's cash registers (cashboxes) with names and balances. GET /cashboxes.
• invbg_get_exchange_rate 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_create_client 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
• invbg_update_client WRITE: change fields of an existing client (only the fields you pass are changed). PATCH /clients/{id}.
• invbg_create_item WRITE: add a product or service to the catalogue (name, price, unit). POST /items.
• invbg_create_invoice 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
• invbg_send_invoice_email 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}/emai
• invbg_record_invoice_payment 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 /paym

Details

• Version: 1.16.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 388 ms
• First indexed: 2026-11-01T10:05:01.437Z
• Last seen in registry: 2026-11-11T00:17:28.011Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/inv-bg/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/inv-bg.svg)](https://lookupd.com/servers/io.usefulapi/inv-bg)

• 62092 servers
• Last crawl: 2026-11-11T17:17:22.074Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp