{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-05T17:38:35.459Z","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg","markdownUrl":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg.md","server":{"slug":"io-usefulapi-inv-bg","name":"inv.bg MCP by usefulapi","registryName":"io.usefulapi/inv-bg","description":"Read inv.bg invoices, clients, items, payments and banking; create clients, items, invoices.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"inv-bg","type":"remote","identifier":"https://inv-bg.usefulapi.io/mcp","withdrawn":false,"url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg","version":"1.14.3","transport":null,"scoredAt":"2026-11-05T15:03:33.636Z"},"score":{"total":18,"tier":"low","status":"scored","weekDelta":-45,"history":[{"date":"2026-11-05","total":18},{"date":"2026-11-04","total":18},{"date":"2026-11-03","total":18},{"date":"2026-11-02","total":18},{"date":"2026-11-01","total":67},{"date":"2026-10-31","total":67},{"date":"2026-10-30","total":64},{"date":"2026-10-29","total":63},{"date":"2026-10-28","total":63},{"date":"2026-10-27","total":62},{"date":"2026-10-26","total":62},{"date":"2026-10-25","total":61}]},"categories":[{"name":"Endpoint Security","score":46,"verdict":"fail","reasons":["The endpoint's TLS certificate is valid, in date, and uses a strong key.","Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.","HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.","HSTS check failed: the Strict-Transport-Security header is absent.","DNSSEC check failed: this domain isn't protected by DNSSEC."],"codes":[{"code":"tls.valid","args":{}},{"code":"auth.unreachable","args":{}},{"code":"https.inconclusive","args":{"reason":"redirect_not_https"}},{"code":"headers.hsts_absent","args":{}},{"code":"dnssec.absent","args":{}}]},{"name":"Transport & Reachability","score":0,"verdict":"fail","reasons":["Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly."],"codes":[{"code":"transport.redirected","args":{"transport":"streamable-http"}}]},{"name":"Schema Quality & AI Usability","score":0,"verdict":"unverified","reasons":["Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list."],"codes":[{"code":"schema.unreachable","args":{}}]},{"name":"Stability & Change Management","score":0,"verdict":"unverified","reasons":["Stability not yet verified: not enough scan history yet (needs a 30-day window)."],"codes":[{"code":"stability.insufficient_history","args":{}}]},{"name":"Tool Coverage","score":0,"verdict":"unverified","reasons":["Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list."],"codes":[{"code":"toolquality.unreachable","args":{}}]},{"name":"Tool Safety","score":0,"verdict":"unverified","reasons":["Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list."],"codes":[{"code":"toolsafety.unreachable","args":{}}]},{"name":"Capabilities","score":0,"verdict":"unverified","reasons":["Capabilities not yet verified: we couldn't read the endpoint's capabilities."],"codes":[{"code":"cap.unreachable","args":{}}]}],"inconclusive":["Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.","HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.","Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.","Stability not yet verified: not enough scan history yet (needs a 30-day window).","Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.","Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.","Capabilities not yet verified: we couldn't read the endpoint's capabilities."],"malware":[],"components":[{"slug":"inv-bg","type":"remote","identifier":"https://inv-bg.usefulapi.io/mcp","withdrawn":false,"score":18,"current":true,"url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg","markdownUrl":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg.md"}],"facts":[{"label":"Endpoint","value":"https://inv-bg.usefulapi.io/mcp"},{"label":"Transports","value":"streamable-http"},{"label":"Auth","value":"none"},{"label":"Version","value":"1.14.3"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"invbg_get_account","title":"Get account","description":"The company (id, name, subdomain) and the user the API token belongs to. GET /account.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":33},{"name":"invbg_get_firm","title":"Get company","description":"The issuing company's details: name, Bulstat, VAT registration and VAT number, address, MOL, contact email, custom properties. GET /firm.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":41},{"name":"invbg_list_invoices","title":"List invoices","description":"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.","inputs":[{"name":"amount_due_gt","type":"number","required":false,"description":"Only documents with an outstanding balance of at least this amount."},{"name":"amount_due_lt","type":"number","required":false,"description":"Only documents with an outstanding balance of at most this amount."},{"name":"amount_gt","type":"number","required":false,"description":"Only documents with a total of at least this amount."},{"name":"amount_lt","type":"number","required":false,"description":"Only documents with a total of at most this amount."},{"name":"client_id","type":"integer","required":false,"description":"Only documents issued to this client (invbg_list_clients)."},{"name":"client_name","type":"string","required":false,"description":"Client name filter; % matches any run of characters, _ one character."},{"name":"currency","type":"string","required":false,"description":"Only documents in this currency."},{"name":"date_from","type":"string","required":false,"description":"Only documents dated on or after this date, yyyy-mm-dd."},{"name":"date_to","type":"string","required":false,"description":"Only documents dated on or before this date, yyyy-mm-dd."},{"name":"is_annulled","type":"boolean","required":false,"description":"true = only annulled documents, false = none."},{"name":"is_draft","type":"boolean","required":false,"description":"true = only drafts, false = no drafts."},{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."},{"name":"number","type":"string","required":false,"description":"Document number (as printed, e.g. 0000000024)."},{"name":"order","type":"string","required":false,"description":"Sort direction (default desc)."},{"name":"order_by","type":"string","required":false,"description":"Field to sort by (for example id, date or name; see the vendor reference)."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."},{"name":"send_status","type":"array","required":false,"description":"Email status(es) to include."},{"name":"status","type":"array","required":false,"description":"Payment statuses to include. Use [\"unpaid\", \"partially-paid\"] to find open receivables."},{"name":"type","type":"array","required":false,"description":"Document types: dan = tax invoice, prof = proforma, deb = debit note, cred = credit note."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":497},{"name":"invbg_get_invoice","title":"Get invoice","description":"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}.","inputs":[{"name":"include_comments","type":"boolean","required":false,"description":"Also return the document's comments."},{"name":"invoice_id","type":"integer","required":true,"description":"inv.bg document id (the id field of invbg_list_invoices, not the printed number)."},{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":126},{"name":"invbg_list_invoice_types","title":"List document types","description":"All document types of this company (tax invoice, proforma, debit/credit note and any custom types) with their codes. GET /invoices/types.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":43},{"name":"invbg_get_next_invoice_number","title":"Get next invoice number","description":"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.","inputs":[{"name":"type","type":"string","required":false,"description":"Document type (default: tax invoice)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":58},{"name":"invbg_list_number_sets","title":"List number sets","description":"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.","inputs":[{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":91},{"name":"invbg_list_payment_methods","title":"List payment methods","description":"The payment method codes a document accepts (cash, bank, card, ...) with their names. GET /invoices/payment-methods.","inputs":[{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":64},{"name":"invbg_list_vat_exemption_reasons","title":"List VAT exemption reasons","description":"The legal reasons for issuing a document without VAT (use one as vat_exemption_reason in invbg_create_invoice). GET /invoices/without-vat-reasons.","inputs":[{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":75},{"name":"invbg_list_clients","title":"List clients","description":"List or search clients (customers): name, Bulstat, VAT number, address, MOL, whether it is a person. GET /clients.","inputs":[{"name":"bulstat","type":"string","required":false,"description":"Filter by EIK/Bulstat."},{"name":"code","type":"string","required":false,"description":"Filter by the client code."},{"name":"is_person","type":"boolean","required":false,"description":"true = individuals only, false = companies only."},{"name":"is_reg_vat","type":"boolean","required":false,"description":"true = VAT-registered clients only."},{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."},{"name":"name","type":"string","required":false,"description":"Filter by client name."},{"name":"order","type":"string","required":false,"description":"Sort direction (default desc)."},{"name":"order_by","type":"string","required":false,"description":"Field to sort by (for example id, date or name; see the vendor reference)."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."},{"name":"vat_number","type":"string","required":false,"description":"Filter by VAT number."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":244},{"name":"invbg_get_client","title":"Get client","description":"One client by id with all stored details (names in both languages, Bulstat, VAT, address, MOL, code, custom properties). GET /clients/{id}.","inputs":[{"name":"client_id","type":"integer","required":true,"description":"inv.bg client id (invbg_list_clients)."},{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":87},{"name":"invbg_list_client_contacts","title":"List client contacts","description":"Contact people of a client (or of all clients) with their names and roles. GET /client-contacts.","inputs":[{"name":"client_id","type":"integer","required":false,"description":"Only the contacts of this client."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":106},{"name":"invbg_list_items","title":"List items","description":"The product/service catalogue: name, price, currency, unit, tags. GET /items.","inputs":[{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."},{"name":"order","type":"string","required":false,"description":"Sort direction (default desc)."},{"name":"order_by","type":"string","required":false,"description":"Field to sort by (for example id, date or name; see the vendor reference)."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."},{"name":"tag_name","type":"string","required":false,"description":"Only items with this tag."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":163},{"name":"invbg_get_item","title":"Get item","description":"One catalogue item by id. GET /items/{id}.","inputs":[{"name":"item_id","type":"integer","required":true,"description":"inv.bg item id (invbg_list_items)."},{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":65},{"name":"invbg_list_item_units","title":"List units of measure","description":"Units of measure accepted as quantity_unit on items and invoice lines. GET /items/units.","inputs":[{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":56},{"name":"invbg_list_payments","title":"List payments","description":"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.","inputs":[{"name":"amount_gt","type":"number","required":false,"description":"Amount of at least this value."},{"name":"amount_lt","type":"number","required":false,"description":"Amount of at most this value."},{"name":"contragent","type":"string","required":false,"description":"Counterparty name; % matches any run of characters."},{"name":"contragent_id","type":"integer","required":false,"description":"Counterparty (client) id."},{"name":"is_expense","type":"boolean","required":false,"description":"true = expenses only, false = income only."},{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."},{"name":"order","type":"string","required":false,"description":"Sort direction (default desc)."},{"name":"order_by","type":"string","required":false,"description":"Field to sort by (for example id, date or name; see the vendor reference)."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"paid_from","type":"string","required":false,"description":"Paid on or after this date."},{"name":"paid_to","type":"string","required":false,"description":"Paid on or before this date."},{"name":"payment_processor","type":"array","required":false,"description":"How the payment was received."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":291},{"name":"invbg_get_payment","title":"Get payment","description":"One payment by id with its allocations to invoices (invoice_payments). GET /payments/{id}.","inputs":[{"name":"payment_id","type":"integer","required":true,"description":"inv.bg payment id (invbg_list_payments)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":48},{"name":"invbg_list_bank_accounts","title":"List bank accounts","description":"The company's bank accounts (alias, bank, IBAN, BIC, currency). GET /bank/accounts.","inputs":[{"name":"language","type":"string","required":false,"description":"Language of names in the reply: bg (default) or en, where the record has both."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":104},{"name":"invbg_list_bank_transactions","title":"List bank transactions","description":"Imported bank transactions with amount, date, counterparty, and whether they are linked to a document. Useful for reconciliation (linked=false = unmatched). GET /bank/transactions.","inputs":[{"name":"amount_gt","type":"number","required":false,"description":"Amount of at least this value."},{"name":"amount_lt","type":"number","required":false,"description":"Amount of at most this value."},{"name":"bank_account_id","type":"array","required":false,"description":"Only these bank accounts (invbg_list_bank_accounts)."},{"name":"date_from","type":"string","required":false,"description":"On or after this date, yyyy-mm-dd."},{"name":"date_to","type":"string","required":false,"description":"On or before this date, yyyy-mm-dd."},{"name":"linked","type":"boolean","required":false,"description":"true = only transactions linked to documents, false = only unlinked ones."},{"name":"order","type":"string","required":false,"description":"Sort direction (default desc)."},{"name":"order_by","type":"string","required":false,"description":"Field to sort by (for example id, date or name; see the vendor reference)."},{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."},{"name":"type","type":"string","required":false,"description":"deb = debit (money out), cred = credit (money in)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":263},{"name":"invbg_list_cashboxes","title":"List cashboxes","description":"The company's cash registers (cashboxes) with names and balances. GET /cashboxes.","inputs":[{"name":"page","type":"integer","required":false,"description":"Page number, from 1 (default 1). Pass the previous reply's next_page."},{"name":"per_page","type":"integer","required":false,"description":"Results per page, 1-100 (default 25)."},{"name":"search","type":"string","required":false,"description":"Free-text search over the results."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":87},{"name":"invbg_get_exchange_rate","title":"Get exchange rate","description":"The exchange rate of a currency to BGN on a date (default: today), as inv.bg uses it for documents. GET /currency/rates/{currency}.","inputs":[{"name":"currency","type":"string","required":true,"description":"Currency, ISO 4217 code such as BGN or EUR."},{"name":"date","type":"string","required":false,"description":"Rate date, yyyy-mm-dd (default today)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":80},{"name":"invbg_create_client","title":"Create client","description":"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.","inputs":[{"name":"address","type":"string","required":false,"description":null},{"name":"bulstat","type":"string","required":true,"description":"EIK/Bulstat of the company."},{"name":"code","type":"string","required":false,"description":"Your own unique client code."},{"name":"country","type":"string","required":false,"description":"Country name or code as inv.bg stores it, e.g. BG."},{"name":"delivery_address","type":"string","required":false,"description":null},{"name":"is_reg_vat","type":"boolean","required":false,"description":"Whether the company is VAT-registered (default false)."},{"name":"mol","type":"string","required":false,"description":"Accountable person (MOL)."},{"name":"name","type":"string","required":true,"description":"Company name."},{"name":"town","type":"string","required":false,"description":null},{"name":"vat_number","type":"string","required":false,"description":"VAT number; required when is_reg_vat is true."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":196},{"name":"invbg_update_client","title":"Update client","description":"WRITE: change fields of an existing client (only the fields you pass are changed). PATCH /clients/{id}.","inputs":[{"name":"address","type":"string","required":false,"description":null},{"name":"bulstat","type":"string","required":false,"description":null},{"name":"client_id","type":"integer","required":true,"description":"inv.bg client id."},{"name":"code","type":"string","required":false,"description":null},{"name":"country","type":"string","required":false,"description":null},{"name":"delivery_address","type":"string","required":false,"description":null},{"name":"is_reg_vat","type":"boolean","required":false,"description":null},{"name":"mol","type":"string","required":false,"description":null},{"name":"name","type":"string","required":false,"description":null},{"name":"town","type":"string","required":false,"description":null},{"name":"vat_number","type":"string","required":false,"description":null}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":121},{"name":"invbg_create_item","title":"Create item","description":"WRITE: add a product or service to the catalogue (name, price, unit). POST /items.","inputs":[{"name":"currency","type":"string","required":false,"description":"Price currency (default BGN)."},{"name":"name","type":"string","required":true,"description":"Item name."},{"name":"name_en","type":"string","required":false,"description":"Item name in English."},{"name":"price","type":"number","required":true,"description":"Price per unit."},{"name":"quantity_unit","type":"string","required":true,"description":"Unit of measure (invbg_list_item_units)."},{"name":"tags","type":"array","required":false,"description":"Tags to attach."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":102},{"name":"invbg_create_invoice","title":"Create invoice","description":"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 details (an existing client matched by Bulstat or VAT number is UPDATED with the address, MOL and other details you pass). VAT: set vat_percent on the document, or on every item. POST /invoices.","inputs":[{"name":"client_id","type":"integer","required":false,"description":"Existing client id (invbg_list_clients). Then the to_* fields are ignored."},{"name":"currency","type":"string","required":false,"description":"Document currency (default BGN)."},{"name":"currency_rate","type":"number","required":false,"description":"Exchange rate to BGN (BGN/XXX). Required when currency is not BGN: take it from invbg_get_exchange_rate."},{"name":"date_create","type":"string","required":false,"description":"Issue date (default now)."},{"name":"date_event","type":"string","required":false,"description":"Tax event date (default: issue date)."},{"name":"date_mature","type":"string","required":false,"description":"Due date."},{"name":"draft","type":"boolean","required":false,"description":"Save as a draft (default true). Pass false to issue the document and consume its number."},{"name":"is_to_person","type":"boolean","required":false,"description":"true when the recipient is an individual (then to_egn is needed)."},{"name":"items","type":"array","required":true,"description":"Line items."},{"name":"items_with_vat","type":"boolean","required":false,"description":"true if item prices already include VAT (default false)."},{"name":"notes","type":"string","required":false,"description":"Notes printed on the document."},{"name":"number_set","type":"integer","required":false,"description":"Number set id to take the number from (invbg_list_number_sets); omit unless you use several series."},{"name":"payment_method","type":"string","required":false,"description":"How the client pays."},{"name":"po_number","type":"string","required":false,"description":"The buyer's purchase order number."},{"name":"reduction_percent","type":"number","required":false,"description":"Discount on the whole document in percent."},{"name":"to_address","type":"string","required":false,"description":"Recipient address (required when no client_id)."},{"name":"to_bulstat","type":"string","required":false,"description":"Recipient EIK/Bulstat (companies)."},{"name":"to_country","type":"string","required":false,"description":"Recipient country, ISO 3166-1 alpha-2."},{"name":"to_egn","type":"string","required":false,"description":"Recipient EGN, 10 digits (individuals), as text so leading zeros survive."},{"name":"to_is_reg_vat","type":"boolean","required":false,"description":"Whether the recipient company is VAT-registered."},{"name":"to_mol","type":"string","required":false,"description":"Recipient accountable person (MOL); required for companies when no client_id."},{"name":"to_name","type":"string","required":false,"description":"Recipient name (when no client_id)."},{"name":"to_town","type":"string","required":false,"description":null},{"name":"to_vat_number","type":"string","required":false,"description":"Recipient VAT number (needed when to_is_reg_vat is true)."},{"name":"type","type":"string","required":false,"description":"dan = tax invoice (default), prof = proforma, deb = debit note, cred = credit note."},{"name":"vat_exemption_reason","type":"string","required":false,"description":"Why no VAT is charged (when VAT is 0); see invbg_list_vat_exemption_reasons."},{"name":"vat_percent","type":"number","required":false,"description":"VAT rate for the whole document in percent; ignored where items carry their own vat_percent."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":673},{"name":"invbg_send_invoice_email","title":"Email invoice","description":"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.","inputs":[{"name":"delivery","type":"string","required":false,"description":"link = a download link (default), file = attached PDF."},{"name":"email","type":"string","required":true,"description":"Recipient email address."},{"name":"invoice_id","type":"integer","required":true,"description":"inv.bg document id."},{"name":"language","type":"string","required":false,"description":"Language of the document (default: the document's own)."},{"name":"message","type":"string","required":false,"description":"Message text placed in the email."},{"name":"name","type":"string","required":false,"description":"Recipient name used in the text."},{"name":"subject","type":"string","required":false,"description":"Email subject (default: the document number)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":148},{"name":"invbg_record_invoice_payment","title":"Record invoice payment","description":"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).","inputs":[{"name":"amount","type":"number","required":true,"description":"Amount received and allocated to this document."},{"name":"contragent_id","type":"integer","required":false,"description":"The paying client's id."},{"name":"currency","type":"string","required":true,"description":"Currency of the payment (required by inv.bg), e.g. BGN or EUR."},{"name":"currency_rate","type":"number","required":true,"description":"Exchange rate to BGN (required by inv.bg): 1 for BGN; otherwise the rate from invbg_get_exchange_rate."},{"name":"invoice_id","type":"integer","required":true,"description":"inv.bg document id the payment is for."},{"name":"note","type":"string","required":false,"description":"Note stored on the payment."},{"name":"paid_at","type":"string","required":false,"description":"When it was paid (default now)."},{"name":"payment_processor","type":"string","required":true,"description":"How the money was received."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":217}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-05T15:03:33.000Z","track":"remote","endpoint":"https://inv-bg.usefulapi.io/mcp","declaredUrl":null,"truncated":false,"tls":{"outcome":"valid","label":"Valid","version":"TLS 1.3","cipherSuite":"TLS_AES_128_GCM_SHA256","chainError":null,"certificates":[{"subject":"CN=usefulapi.io","issuer":"CN=WE1,O=Google Trust Services,C=US","notBefore":"2026-09-13T08:55:39Z","notAfter":"2026-12-12T09:54:12Z","keyType":"ECDSA","keyBits":256,"isCa":false},{"subject":"CN=WE1,O=Google Trust Services,C=US","issuer":"CN=GTS Root R4,O=Google Trust Services LLC,C=US","notBefore":"2023-12-13T09:00:00Z","notAfter":"2029-02-20T14:00:00Z","keyType":"ECDSA","keyBits":256,"isCa":true},{"subject":"CN=GTS Root R4,O=Google Trust Services LLC,C=US","issuer":"CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE","notBefore":"2023-11-15T03:43:21Z","notAfter":"2028-01-28T00:00:42Z","keyType":"ECDSA","keyBits":384,"isCa":true}]},"dnssec":{"result":"insecure","label":"Not signed","name":"inv-bg.usefulapi.io.","steps":[{"zone":".","outcome":"verified","label":"Verified"},{"zone":"io.","outcome":"verified","label":"Verified"},{"zone":"usefulapi.io.","outcome":"insecure_proven","label":"Unsigned (proven)"}]},"auth":{"outcome":"inconclusive","label":"Inconclusive","gate":null,"gateLabel":null,"status":302,"authorizationServers":[]},"httpsRedirect":{"outcome":"inconclusive","label":"Inconclusive","status":302},"transports":[{"transport":"streamable-http","outcome":"redirected","label":"Redirected","status":302,"followed":false}],"provenance":null,"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":null},"mismatches":[],"changelog":{"trackingSince":"2026-10-25","recent":[{"id":"chg_01a19b23-b188-7868-9238-2c74549fc765","kind":"check.unverifiable","summary":"Stability (0.23 → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b188-7868-9238-2c74549fc765"},{"id":"chg_01a19b23-b189-7c63-beab-84614dac56d7","kind":"check.unverifiable","summary":"Tool safety (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b189-7c63-beab-84614dac56d7"},{"id":"chg_01a19b23-b18a-73c6-a32c-b7602d30b494","kind":"check.unverifiable","summary":"Authorization (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b18a-73c6-a32c-b7602d30b494"},{"id":"chg_01a19b23-b18a-799f-b4b0-e35de2992f8b","kind":"check.unverifiable","summary":"Schema quality (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b18a-799f-b4b0-e35de2992f8b"},{"id":"chg_01a19b23-b18b-7008-90eb-16d03552c580","kind":"check.unverifiable","summary":"Capabilities (pass → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b18b-7008-90eb-16d03552c580"},{"id":"chg_01a19b23-b18b-7bd6-bbd7-b981b84d7d75","kind":"check.unverifiable","summary":"Tool coverage (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b18b-7bd6-bbd7-b981b84d7d75"},{"id":"chg_01a19b23-b18c-7243-be43-1e05fc986fe5","kind":"capture.status_changed","summary":"Endpoint reachability (reachable → not serving MCP)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b18c-7243-be43-1e05fc986fe5"},{"id":"chg_01a19b23-b18c-77f3-9044-44e22757f3b6","kind":"score.total_changed","summary":"Trust score (67 → 18)","materiality":"functional","direction":"regression","scoreDelta":-49,"occurredOn":"2026-11-02","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a19b23-b18c-77f3-9044-44e22757f3b6"},{"id":"chg_01a193fb-adde-79be-8e37-d8f380e8f052","kind":"check.verdict","summary":"Authorization (partial → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-adde-79be-8e37-d8f380e8f052"},{"id":"chg_01a193fb-addf-7500-8e7c-9579bca3bfa2","kind":"check.verdict","summary":"MCP protocol (fail → pass)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-addf-7500-8e7c-9579bca3bfa2"},{"id":"chg_01a193fb-addf-7974-b5a1-a0a7b79013b2","kind":"prompt.added","summary":"New prompt “add_or_update_a_client_or_add_an_item”","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-addf-7974-b5a1-a0a7b79013b2"},{"id":"chg_01a193fb-addf-7e02-a1ed-b041c37df044","kind":"prompt.added","summary":"New prompt “create_a_draft_invoice_for_a_client”","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-addf-7e02-a1ed-b041c37df044"},{"id":"chg_01a193fb-ade0-735c-a8dd-dc3783352a13","kind":"prompt.added","summary":"New prompt “email_an_invoice_or_record_a_payment”","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade0-735c-a8dd-dc3783352a13"},{"id":"chg_01a193fb-ade0-791b-b419-a7faa33876d4","kind":"prompt.added","summary":"New prompt “find_bank_transactions_not_linked_to_an_invoice”","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade0-791b-b419-a7faa33876d4"},{"id":"chg_01a193fb-ade0-7d94-9c99-21fd995c5f02","kind":"prompt.added","summary":"New prompt “find_unpaid_invoices_oldest_first”","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade0-7d94-9c99-21fd995c5f02"},{"id":"chg_01a193fb-ade1-73a6-b651-e6776e61df32","kind":"prompt.added","summary":"New prompt “see_everything_invoiced_to_a_client”","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade1-73a6-b651-e6776e61df32"},{"id":"chg_01a193fb-ade1-789f-b379-d1ecc49f3951","kind":"server.version_changed","summary":"Server version (1.10.0 → 1.12.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade1-789f-b379-d1ecc49f3951"},{"id":"chg_01a193fb-ade1-7f0e-ba3d-f4fcae7016ef","kind":"protocol.version_changed","summary":"MCP protocol version (2025-06-18 → 2025-11-25)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade1-7f0e-ba3d-f4fcae7016ef"},{"id":"chg_01a193fb-ade2-7513-8e8c-ef8ef460f395","kind":"score.total_changed","summary":"Trust score (64 → 67)","materiality":"functional","direction":"improvement","scoreDelta":3,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a193fb-ade2-7513-8e8c-ef8ef460f395"},{"id":"chg_01a1931f-6f4e-7b97-b4c9-c0d8d845350a","kind":"server.version_changed","summary":"Server version (1.9.0 → 1.10.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg#chg-chg_01a1931f-6f4e-7b97-b4c9-c0d8d845350a"}],"truncated":true,"feedUrl":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg/changelog.json"},"links":{"html":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg","markdown":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg.md","changelogJson":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg/changelog.json","changelogRss":"https://verifymcp.io/servers/io-usefulapi-inv-bg/inv-bg.xml","external":[{"label":"Remote endpoint","href":"https://inv-bg.usefulapi.io/mcp"},{"label":"Repository","href":"https://github.com/m190/usefulapi-mcp"},{"label":"Website","href":"https://usefulapi.io/inv-bg/"}]}}