Skip to content
MCP server

inv.bg MCP by usefulapi

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

Install
Runs
Remotely
Version
1.19.0
Listing updated
4 days ago

About inv.bg MCP by usefulapi

inv.bg MCP by usefulapi is an MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://inv-bg.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "inv-bg": {
      "url": "https://inv-bg.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (27)

Read directly from the server.

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/annulled, sent status, currency. Each row has number, client, totals, balance_paid, balance_due and dates. GET /invoices.
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. Optionally with its comments. GET /invoices/{id}.
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). GET /payments.
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 /bank/transactions.
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 with invbg_create_invoice and is_to_person instead. POST /clients.
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 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 and to_bulstat for a company, to_egn for a person) and inv.bg matches or creates the client from those
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}/emails.
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 /payments, then POST /payments/{id}/invoices. If the allocation fails the payment stays recorded: the error names its id (see invbg_get_payment).

inv.bg MCP by usefulapi FAQ

How do I add inv.bg MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http inv-bg https://inv-bg.usefulapi.io/mcp

What are the best alternatives to inv.bg MCP by usefulapi?

The closest alternatives to inv.bg MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to inv.bg MCP by usefulapi

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government