Name: inv.bg MCP by usefulapi
Author: usefulapi

inv.bg MCP by usefulapi

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

Tool-list grade A Remote · Streamable HTTP No auth needed 27 tools v1.8.2 MIT

No reviews yet by usefulapiGitHub The publisher’s own endpoint — this marketplace is not in the path

93/100

tool-list score

tools declared

remote

at its publisher

—

calls last 7d

What it does

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

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http inv-bg-mcp-by-usefulapi https://inv-bg.usefulapi.io/mcp

# 2 — ask your agent for something these tools do
#   invbg_get_account, invbg_get_firm, invbg_list_invoices and 24 more

inv.bg MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

usefulapi421 servers

24 categories

All 421 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

The company (id, name, subdomain) and the user the API token belongs to. GET /account.

No parameter schema on file.

The issuing company's details: name, Bulstat, VAT registration and VAT number, address, MOL, contact email, custom properties. GET /firm.

No parameter schema on file.

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.

Parameter	Type	Required	Notes
type	array	no	Document types: dan = tax invoice, prof = proforma, deb = debit note, cred = credit note.
number	string	no	Document number (as printed, e.g. 0000000024).
date_from	string	no	Only documents dated on or after this date, yyyy-mm-dd.
date_to	string	no	Only documents dated on or before this date, yyyy-mm-dd.
amount_gt	number	no	Only documents with a total of at least this amount.
amount_lt	number	no	Only documents with a total of at most this amount.
amount_due_gt	number	no	Only documents with an outstanding balance of at least this amount.
amount_due_lt	number	no	Only documents with an outstanding balance of at most this amount.
status	array	no	Payment statuses to include. Use ["unpaid", "partially-paid"] to find open receivables.
client_id	integer	no	Only documents issued to this client (invbg_list_clients).
client_name	string	no	Client name filter; % matches any run of characters, _ one character.
is_draft	boolean	no	true = only drafts, false = no drafts.
is_annulled	boolean	no	true = only annulled documents, false = none.
send_status	array	no	Email status(es) to include.
currency	string	no	Only documents in this currency.
search	string	no	Free-text search over the results.
order_by	string	no	Field to sort by (for example id, date or name; see the vendor reference).
order	string	no	Sort direction (default desc).
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.

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}.

Parameter	Type	Required	Notes
invoice_id	integer	yes	inv.bg document id (the id field of invbg_list_invoices, not the printed number).
include_comments	boolean	no	Also return the document's comments.
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.

All document types of this company (tax invoice, proforma, debit/credit note and any custom types) with their codes. GET /invoices/types.

No parameter schema on file.

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.

Parameter	Type	Required	Notes
type	string	no	Document type (default: tax invoice).

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.

Parameter	Type	Required	Notes
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

The payment method codes a document accepts (cash, bank, card, ...) with their names. GET /invoices/payment-methods.

Parameter	Type	Required	Notes
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.

The legal reasons for issuing a document without VAT (use one as vat_exemption_reason in invbg_create_invoice). GET /invoices/without-vat-reasons.

Parameter	Type	Required	Notes
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.

List or search clients (customers): name, Bulstat, VAT number, address, MOL, whether it is a person. GET /clients.

Parameter	Type	Required	Notes
name	string	no	Filter by client name.
bulstat	string	no	Filter by EIK/Bulstat.
vat_number	string	no	Filter by VAT number.
code	string	no	Filter by the client code.
is_person	boolean	no	true = individuals only, false = companies only.
is_reg_vat	boolean	no	true = VAT-registered clients only.
search	string	no	Free-text search over the results.
order_by	string	no	Field to sort by (for example id, date or name; see the vendor reference).
order	string	no	Sort direction (default desc).
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

One client by id with all stored details (names in both languages, Bulstat, VAT, address, MOL, code, custom properties). GET /clients/{id}.

Parameter	Type	Required	Notes
client_id	integer	yes	inv.bg client id (invbg_list_clients).
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.

Contact people of a client (or of all clients) with their names and roles. GET /client-contacts.

Parameter	Type	Required	Notes
client_id	integer	no	Only the contacts of this client.
search	string	no	Free-text search over the results.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

The product/service catalogue: name, price, currency, unit, tags. GET /items.

Parameter	Type	Required	Notes
search	string	no	Free-text search over the results.
tag_name	string	no	Only items with this tag.
order_by	string	no	Field to sort by (for example id, date or name; see the vendor reference).
order	string	no	Sort direction (default desc).
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

One catalogue item by id. GET /items/{id}.

Parameter	Type	Required	Notes
item_id	integer	yes	inv.bg item id (invbg_list_items).
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.

Units of measure accepted as quantity_unit on items and invoice lines. GET /items/units.

Parameter	Type	Required	Notes
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.

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.

Parameter	Type	Required	Notes
payment_processor	array	no	How the payment was received.
paid_from	string	no	Paid on or after this date.
paid_to	string	no	Paid on or before this date.
amount_gt	number	no	Amount of at least this value.
amount_lt	number	no	Amount of at most this value.
contragent	string	no	Counterparty name; % matches any run of characters.
contragent_id	integer	no	Counterparty (client) id.
is_expense	boolean	no	true = expenses only, false = income only.
search	string	no	Free-text search over the results.
order_by	string	no	Field to sort by (for example id, date or name; see the vendor reference).
order	string	no	Sort direction (default desc).
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

One payment by id with its allocations to invoices (invoice_payments). GET /payments/{id}.

Parameter	Type	Required	Notes
payment_id	integer	yes	inv.bg payment id (invbg_list_payments).

The company's bank accounts (alias, bank, IBAN, BIC, currency). GET /bank/accounts.

Parameter	Type	Required	Notes
language	string	no	Language of names in the reply: bg (default) or en, where the record has both.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

Imported bank transactions with amount, date, counterparty, and whether they are linked to a document. Useful for reconciliation (linked=false = unmatched). GET /bank/transactions.

Parameter	Type	Required	Notes
bank_account_id	array	no	Only these bank accounts (invbg_list_bank_accounts).
type	string	no	deb = debit (money out), cred = credit (money in).
date_from	string	no	On or after this date, yyyy-mm-dd.
date_to	string	no	On or before this date, yyyy-mm-dd.
amount_gt	number	no	Amount of at least this value.
amount_lt	number	no	Amount of at most this value.
linked	boolean	no	true = only transactions linked to documents, false = only unlinked ones.
search	string	no	Free-text search over the results.
order_by	string	no	Field to sort by (for example id, date or name; see the vendor reference).
order	string	no	Sort direction (default desc).
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

The company's cash registers (cashboxes) with names and balances. GET /cashboxes.

Parameter	Type	Required	Notes
search	string	no	Free-text search over the results.
page	integer	no	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	no	Results per page, 1-100 (default 25).

The exchange rate of a currency to BGN on a date (default: today), as inv.bg uses it for documents. GET /currency/rates/{currency}.

Parameter	Type	Required	Notes
currency	string	yes	Currency, ISO 4217 code such as BGN or EUR.
date	string	no	Rate date, yyyy-mm-dd (default today).

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.

Parameter	Type	Required	Notes
name	string	yes	Company name.
bulstat	string	yes	EIK/Bulstat of the company.
is_reg_vat	boolean	no	Whether the company is VAT-registered (default false).
vat_number	string	no	VAT number; required when is_reg_vat is true.
town	string	no	—
address	string	no	—
country	string	no	Country name or code as inv.bg stores it, e.g. BG.
mol	string	no	Accountable person (MOL).
code	string	no	Your own unique client code.
delivery_address	string	no	—

WRITE: change fields of an existing client (only the fields you pass are changed). PATCH /clients/{id}.

Parameter	Type	Required	Notes
client_id	integer	yes	inv.bg client id.
name	string	no	—
bulstat	string	no	—
is_reg_vat	boolean	no	—
vat_number	string	no	—
town	string	no	—
address	string	no	—
country	string	no	—
mol	string	no	—
code	string	no	—
delivery_address	string	no	—

WRITE: add a product or service to the catalogue (name, price, unit). POST /items.

Parameter	Type	Required	Notes
name	string	yes	Item name.
price	number	yes	Price per unit.
quantity_unit	string	yes	Unit of measure (invbg_list_item_units).
currency	string	no	Price currency (default BGN).
name_en	string	no	Item name in English.
tags	array	no	Tags to attach.

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

Parameter	Type	Required	Notes
type	string	no	dan = tax invoice (default), prof = proforma, deb = debit note, cred = credit note.
draft	boolean	no	Save as a draft (default true). Pass false to issue the document and consume its number.
client_id	integer	no	Existing client id (invbg_list_clients). Then the to_* fields are ignored.
to_name	string	no	Recipient name (when no client_id).
is_to_person	boolean	no	true when the recipient is an individual (then to_egn is needed).
to_bulstat	string	no	Recipient EIK/Bulstat (companies).
to_egn	string	no	Recipient EGN, 10 digits (individuals), as text so leading zeros survive.
to_is_reg_vat	boolean	no	Whether the recipient company is VAT-registered.
to_vat_number	string	no	Recipient VAT number (needed when to_is_reg_vat is true).
to_mol	string	no	Recipient accountable person (MOL); required for companies when no client_id.
to_town	string	no	—
to_address	string	no	Recipient address (required when no client_id).
to_country	string	no	Recipient country, ISO 3166-1 alpha-2.
items	array	yes	Line items.
vat_percent	number	no	VAT rate for the whole document in percent; ignored where items carry their own vat_percent.
vat_exemption_reason	string	no	Why no VAT is charged (when VAT is 0); see invbg_list_vat_exemption_reasons.
items_with_vat	boolean	no	true if item prices already include VAT (default false).
currency	string	no	Document currency (default BGN).
currency_rate	number	no	Exchange rate to BGN (BGN/XXX). Required when currency is not BGN: take it from invbg_get_exchange_rate.
payment_method	string	no	How the client pays.

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.

Parameter	Type	Required	Notes
invoice_id	integer	yes	inv.bg document id.
email	string	yes	Recipient email address.
name	string	no	Recipient name used in the text.
subject	string	no	Email subject (default: the document number).
message	string	no	Message text placed in the email.
delivery	string	no	link = a download link (default), file = attached PDF.
language	string	no	Language of the document (default: the document's own).

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).

Parameter	Type	Required	Notes
invoice_id	integer	yes	inv.bg document id the payment is for.
amount	number	yes	Amount received and allocated to this document.
payment_processor	string	yes	How the money was received.
currency	string	yes	Currency of the payment (required by inv.bg), e.g. BGN or EUR.
currency_rate	number	yes	Exchange rate to BGN (required by inv.bg): 1 for BGN; otherwise the rate from invbg_get_exchange_rate.
paid_at	string	no	When it was paid (default now).
contragent_id	integer	no	The paying client's id.
note	string	no	Note stored on the payment.

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install inv.bg MCP by usefulapi or to call it, at any volume.

ATool-list grade · score 93 / 100

Release 1.8.2 · scanned 31 Oct 2026

Graded from the tools this server lists, not from its source code.

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score93

Findings0 threat · 1 capability

Capabilitymoderate

Coveragemanifest

Verificationnot in this report

Surface digestb8962771d66bbdca9b4e5a3ef0d92337493f8a950736c534b6ef9264318e76e7

Score vectorthreat 100 → client 93

Term	Level	What it prices	Points
capability-exposure	moderate	capability blast radius (moderate) — client exposure if the model is manipulated	−3
coverage-honesty	manifest	inspection depth (manifest) — how much of the target the scan could see	−4

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.

Tool surfaceread

Implementation sourcenot available

Package metadatanot available

Live transportnot available

The implementation source was not read — this reflects the declared tool metadata only.

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.

Tool	Capability tags	Why the tag was assigned
invbg_get_account	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_firm	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_invoices	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_invoice	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_invoice_types	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_next_invoice_number	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_number_sets	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_payment_methods	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_vat_exemption_reasons	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_clients	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_client	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_client_contacts	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_items	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_item	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_item_units	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_payments	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_payment	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_bank_accounts	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_bank_transactions	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_list_cashboxes	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_get_exchange_rate	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
invbg_create_client	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true
invbg_update_client	external-sink	external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true
invbg_create_item	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true
invbg_create_invoice	external-sink	external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true
invbg_send_invoice_email	untrusted-inputexternal-sink	untrusted-input: keyword "download"; external-sink: declares readOnlyHint: false, openWorldHint: true
invbg_record_invoice_payment	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

flow-1

Untrusted input can drive an external action even though no sensitive source is exposed.

Supply chain and provenance

Integrityfirst-seen

Surface digestb8962771d66bbdca

Scanned2026-10-31

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.

Where are you running it?

Tool surface

Release history

inv.bg MCP by usefulapi

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

What the scan could actually read

Capability — what it could do if the model were manipulated

Toxic-flow graph

Supply chain and provenance

Release history

See also