Skip to content

MCP servers › io.usefulapi › billomat

MCP server · registry snapshot 2026-10-23 · last tested 2026-10-23

io.usefulapi/billomat

Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices. — the publisher's description

4 of 5 record checks metRead-only · tools listed 2026-10-23Topic: finance-and-payments · AI-classifiedPricing: freemium · AI-classifiedversion 1.3.4JavaScriptstreamable HTTP34 tools

Summary

io.usefulapi/billomat is a remote MCP server listed in the official MCP registry at version 1.3.4. On 2026-10-23 ProtocolProbe connected to it in read-only mode and read its inventory: 34 tools, 0 resources and 1 prompt.

Record checks

4 of 5 record checks met · 4 do not apply

  • met: Registry entry is active and says how to run it
  • met: Source repository link opens
  • met: Repository is not archived
  • met: Code pushed to the repository in the 90 days before our check
  • not met: Repository publishes a security policy (SECURITY.md)
  • not applicable: Package names its licence with a standard (SPDX) identifier
  • not applicable: The version the registry lists can be installed and is not withdrawn
  • not applicable: npm package carries build provenance (attestation)
  • not applicable: No known critical or high advisory in the package or its dependencies
  • Not ranked by downloads: a remote server publishes no download figure
  • Not ranked by stars: 0 stars (ranked from 10)

From public records, not a safety rating. Each check with its reason · Is it safe to install?

Key facts

Runs
remote (hosted by the publisher)
Transport
streamable HTTP
Sign-in
none needed to open a session
Repository
public
Tools
34
Described as changing data
6 of 34 toolsAI-classified
Mainly works on
accounts and data in outside web servicesAI-classified
Topic
finance-and-paymentsAI-classified
Pricing
freemiumAI-classified
Last tested
2026-10-23

Add to your client

Observed fact

This server accepted a session without any credential and lists 6 tools whose name or declaration suggests they change data (billomat_create_client, billomat_update_client, billomat_create_article, billomat_create_draft_invoice, billomat_add_invoice_item and 1 more). That is our reading of the names; we did not call them. Source: our connection, 2026-10-23.

Worth knowing before you connect it

  • 6 tools are described as changing something (billomat_create_client, billomat_update_client, billomat_create_article, …): our AI model's reading of the descriptions, not something we tested, and the server opened a session without any credential. We did not call them.

Each line comes from a section below, with its source and date.

How fresh this is

Live-tested
yes, a real session (not a text-only review)
Last tested
2026-10-23
Mode
read-only (no tool calls)
Latest version
1.3.4, published 2026-10-22 (registry, as of the 2026-10-23 snapshot)
First listed version
2026-10-11 (earliest version still in the registry; older removed versions would be earlier)
Version history
3 versions listed, 2026-10-11 to 2026-10-22; 3 in the 90 days before the 2026-10-23 snapshot.
Most recent 3 versions
  • 1.3.4 · 2026-10-22
  • 1.3.3 · 2026-10-21
  • 1.0.0 · 2026-10-11
(versions still listed in the registry only)
Registry data
snapshot 2026-10-23
Package and repository
checked 2026-10-23
Engine
mcp-runtime-engine@0.1.0 · sdk@1.32.0

Changes since the last refresh

New in the registry: not in the list of 2026-10-04, listed on 2026-10-23 with version 1.3.4 (published 2026-10-22).

Source: the official MCP Registry list on 2026-10-04 and on 2026-10-23.

What it is

What does this server offer?

Observed inventory
34tools
0resources
1prompts

What it mainly works on, as our AI model read its tool descriptions: accounts and data in outside web services.

6 of 34 tools are described as changing something (creating, editing, deleting, sending or running).

  • billomat_get_current_userreads or searches

    “Show the Billomat user the API key belongs to (name, email, role and rights).”

    Publisher declares: read-only yes

    Takes no inputs.

  • billomat_get_companyreads or searches

    “Show the own company data of the Billomat account (name, address, bank details, tax numbers, currency).”

    Publisher declares: read-only yes

    Takes no inputs.

  • billomat_list_clientsreads or searches

    “List the clients (customers) of the account, filtered by name, number, email, contact person, country, note or tags.”

    Publisher declares: read-only yes

    12 inputs
    • namestring“Company / name (case-insensitive).”
    • client_numberstring“Client number.”
    • emailstring“Email address.”
    • first_namestring“First name of the contact person.”
    • last_namestring“Last name of the contact person.”
    • country_codestring“ISO 3166 alpha-2 country code, e.g.”
    • notestring“Search in the note.”
    • invoice_idstring“Comma-separated invoice ids: the clients of these invoices.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_clientreads or searches

    “Get one client with address, contact person, bank details, payment terms and revenue.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The client id (from billomat_list_clients).”
  • billomat_list_articlesreads or searches

    “List the articles (products and services) with prices, units and tax.”

    Publisher declares: read-only yes

    10 inputs
    • article_numberstring“Article number.”
    • titlestring“Title (case-insensitive).”
    • descriptionstring“Search in the description.”
    • currency_codestring“ISO currency code, e.g.”
    • unit_idinteger or string“Only articles with this unit (from billomat_list_units).”
    • supplier_idinteger or string“Only articles of this supplier.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_articlereads or searches

    “Get one article with its prices, unit, tax and supplier.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The article id (from billomat_list_articles).”
  • billomat_list_suppliersreads or searches

    “List the suppliers of the account, filtered by name, email, contact person, country, note or tags.”

    Publisher declares: read-only yes

    11 inputs
    • namestring“Company / name.”
    • emailstring“Email address.”
    • first_namestring“First name of the contact person.”
    • last_namestring“Last name of the contact person.”
    • country_codestring“ISO 3166 alpha-2 country code, e.g.”
    • client_numberstring“Your customer number at the supplier.”
    • notestring“Search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_supplierreads or searches

    “Get one supplier with address and bank details.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The supplier id (from billomat_list_suppliers).”
  • billomat_list_invoicesreads or searches

    “List invoices (Rechnungen), filtered by client, status (DRAFT, OPEN, PAID, OVERDUE, CANCELED), number, date range, text or tags.”

    Publisher declares: read-only yes

    15 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • invoice_numberstring“Invoice number (case-insensitive).”
    • statusstring“Status filter: DRAFT, OPEN, PAID, OVERDUE, CANCELED; several separated by commas.”
    • payment_typestring“Payment type(s), e.g.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_invoice_totalsreads or searches

    “Invoice totals grouped by client, status, day, week, month or year (for example group_by=client,year).”

    Publisher declares: read-only yes

    13 inputs, 1 required
    • group_bystringrequired“Grouping: client, status, day, week, month, year; several separated by commas (the order sets the aggregation).”
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • invoice_numberstring“Invoice number (case-insensitive).”
    • statusstring“Status filter: DRAFT, OPEN, PAID, OVERDUE, CANCELED; several separated by commas.”
    • payment_typestring“Payment type(s), e.g.”
  • billomat_get_invoicereads or searches

    “Get one invoice (status, totals, dates, client, payment terms).”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The invoice id (from billomat_list_invoices).”
  • billomat_list_invoice_itemsreads or searches

    “List the line items (positions) of one invoice.”

    Publisher declares: read-only yes

    3 inputs, 1 required
    • invoice_idinteger or stringrequired“The invoice id.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
Show 22 more tools
  • billomat_list_invoice_paymentsreads or searches

    “List the payments that were recorded on invoices (read-only), optionally for one invoice, a date range or payment types.”

    Publisher declares: read-only yes

    8 inputs
    • invoice_idinteger or string“Only payments of this invoice.”
    • fromstring“Payments on or after this day (yyyy-mm-dd).”
    • tostring“Payments on or before this day (yyyy-mm-dd).”
    • typestring“Payment type(s), e.g.”
    • user_idinteger or string“Only payments recorded by this user.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_list_recurring_invoicesreads or searches

    “List recurring invoices (Abo-Rechnungen): name, cycle (DAILY, WEEKLY, MONTHLY, YEARLY), client and next run.”

    Publisher declares: read-only yes

    12 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • namestring“Name of the recurring invoice.”
    • payment_typestring“Payment type(s), e.g.”
    • cyclestring“Interval.”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_list_offersreads or searches

    “List offers (Angebote), filtered by client, status (DRAFT, OPEN, WON, LOST, CANCELED, CLEARED), number, date range or text.”

    Publisher declares: read-only yes

    14 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • offer_numberstring“Offer number (partial, case-insensitive).”
    • statusstring“Status filter: DRAFT, OPEN, WON, LOST, CANCELED, CLEARED; several separated by commas.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_offerreads or searches

    “Get one offer (status, totals, validity, client).”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The offer id (from billomat_list_offers).”
  • billomat_list_confirmationsreads or searches

    “List order confirmations (Auftragsbestaetigungen), filtered by client, status (DRAFT, COMPLETED, CANCELED, CLEARED), number, date range or text.”

    Publisher declares: read-only yes

    14 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • confirmation_numberstring“Confirmation number (partial, case-insensitive).”
    • statusstring“Status filter: DRAFT, COMPLETED, CANCELED, CLEARED; several separated by commas.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_confirmationreads or searches

    “Get one order confirmation.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The confirmation id (from billomat_list_confirmations).”
  • billomat_list_delivery_notesreads or searches

    “List delivery notes (Lieferscheine), filtered by client, status (DRAFT, CREATED), number, date range or text.”

    Publisher declares: read-only yes

    14 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • delivery_note_numberstring“Delivery note number (case-insensitive).”
    • statusstring“Status filter: DRAFT, CREATED; several separated by commas.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_delivery_notereads or searches

    “Get one delivery note.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The delivery note id (from billomat_list_delivery_notes).”
  • billomat_list_credit_notesreads or searches

    “List credit notes (Gutschriften), filtered by client, status (DRAFT, OPEN, PAID), date range or text.”

    Publisher declares: read-only yes

    14 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • credit_note_numberstring“Credit note number (case-insensitive).”
    • statusstring“Status filter: DRAFT, OPEN, PAID; several separated by commas.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_credit_notereads or searches

    “Get one credit note.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The credit note id (from billomat_list_credit_notes).”
  • billomat_list_remindersreads or searches

    “List payment reminders (Mahnungen), filtered by client, status (DRAFT, OPEN, OVERDUE, PAID, CANCELED), invoice number, date range or text.”

    Publisher declares: read-only yes

    15 inputs
    • client_idinteger or string“Only documents of this client (from billomat_list_clients).”
    • contact_idinteger or string“Only documents of this client contact.”
    • invoice_numberstring“Number of the reminded invoice (case-insensitive).”
    • statusstring“Status filter: DRAFT, OPEN, PAID, OVERDUE, CANCELED; several separated by commas.”
    • fromstring“Documents dated on or after this day (yyyy-mm-dd).”
    • tostring“Documents dated on or before this day (yyyy-mm-dd).”
    • labelstring“Free-text search in the label.”
    • subjectstring“Free-text search in the subject.”
    • introstring“Free-text search in the introduction text.”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • article_idinteger or string“Only documents containing this article.”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_reminderreads or searches

    “Get one payment reminder.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The reminder id (from billomat_list_reminders).”
  • billomat_list_incoming_invoicesreads or searches

    “List incoming invoices (Eingangsrechnungen, from suppliers), filtered by supplier, status (OPEN, PAID, OVERDUE), number, date range, note or tags.”

    Publisher declares: read-only yes

    10 inputs
    • supplier_idinteger or string“Only incoming invoices of this supplier.”
    • incoming_numberstring“Incoming invoice number.”
    • statusstring“Status filter: OPEN, PAID, OVERDUE; several separated by commas.”
    • fromstring“Dated on or after this day (yyyy-mm-dd).”
    • tostring“Dated on or before this day (yyyy-mm-dd).”
    • notestring“Free-text search in the note.”
    • tagsstring“Comma-separated tags (Schlagworte).”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_get_incoming_invoicereads or searches

    “Get one incoming invoice with amounts and open amount.”

    Publisher declares: read-only yes

    1 input, 1 required
    • idinteger or stringrequired“The incoming invoice id (from billomat_list_incoming_invoices).”
  • billomat_list_taxesreads or searches

    “List the tax rates (Steuersaetze) of the account, with the default one.”

    Publisher declares: read-only yes

    3 inputs
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_list_unitsreads or searches

    “List the units (Einheiten) used for article and item quantities, optionally filtered by name.”

    Publisher declares: read-only yes

    4 inputs
    • namestring“Unit name (substring, case-insensitive).”
    • order_bystring“Sort order: field name plus ASC or DESC, several separated by commas, e.g.”
    • pageinteger“Page number, 1-based (default 1).”
    • per_pageinteger“Results per page, 1-1000 (default 100).”
  • billomat_create_clientcreates or changes datadescribed as changing data

    “WRITE: create a new client (customer) in Billomat.”

    Publisher declares: read-only no · destructive yes · idempotent no

    18 inputs
    • namestring“Company name.”
    • streetstring“Street and number.”
    • zipstring“ZIP code.”
    • citystring“City.”
    • statestring“State / region.”
    • country_codestring“ISO 3166 alpha-2 country code, e.g.”
    • first_namestring“First name of the contact person.”
    • last_namestring“Last name of the contact person.”
    • salutationstring“Salutation, e.g.”
    • phonestring“Phone.”
    • mobilestring“Mobile phone.”
    • emailstring“Email address.”
    • wwwstring“Website (without http).”
    • tax_numberstring“Tax number.”
    • vat_numberstring“VAT ID.”
    • notestring“Internal note.”
    • currency_codestring“ISO currency code, e.g.”
    • localestring“Locale of the documents, e.g.”
  • billomat_update_clientcreates or changes datadescribed as changing data

    “WRITE: change fields of an existing client (only the fields you pass are changed; everything else stays).”

    Publisher declares: read-only no · destructive yes · idempotent yes

    19 inputs, 1 required
    • idinteger or stringrequired“The client id.”
    • namestring“Company name.”
    • streetstring“Street and number.”
    • zipstring“ZIP code.”
    • citystring“City.”
    • statestring“State / region.”
    • country_codestring“ISO 3166 alpha-2 country code, e.g.”
    • first_namestring“First name of the contact person.”
    • last_namestring“Last name of the contact person.”
    • salutationstring“Salutation, e.g.”
    • phonestring“Phone.”
    • mobilestring“Mobile phone.”
    • emailstring“Email address.”
    • wwwstring“Website (without http).”
    • tax_numberstring“Tax number.”
    • vat_numberstring“VAT ID.”
    • notestring“Internal note.”
    • currency_codestring“ISO currency code, e.g.”
    • localestring“Locale of the documents, e.g.”
  • billomat_create_articlecreates or changes datadescribed as changing data

    “WRITE: create a new article (product or service) with a price.”

    Publisher declares: read-only no · destructive yes · idempotent no

    8 inputs, 1 required
    • titlestringrequired“Article title.”
    • descriptionstring“Description.”
    • sales_pricenumber“Sales price (net or gross as the account is set up).”
    • currency_codestring“ISO currency code, e.g.”
    • unit_idinteger or string“Unit id (from billomat_list_units).”
    • tax_idinteger or string“Tax rate id (from billomat_list_taxes).”
    • purchase_pricenumber“Purchase price.”
    • typestring“PRODUCT or SERVICE.”
  • billomat_create_draft_invoicecreates or changes datadescribed as changing data

    “WRITE: create an invoice as a DRAFT (Entwurf) for a client, with optional line items.”

    Publisher declares: read-only no · destructive yes · idempotent no

    11 inputs, 1 required
    • client_idinteger or stringrequired“The client id (from billomat_list_clients).”
    • contact_idinteger or string“A contact of that client.”
    • datestring“Document date (yyyy-mm-dd; today when omitted).”
    • titlestring“Document title.”
    • labelstring“Label / subject.”
    • introstring“Introduction text.”
    • notestring“Closing note.”
    • currency_codestring“ISO currency code, e.g.”
    • net_grossstring“Whether prices are net or gross.”
    • itemsarray“Line items (up to 200).”
    • due_daysinteger“Days until payment is due.”
  • billomat_add_invoice_itemcreates or changes datadescribed as changing data

    “WRITE: add one line item to an invoice that is still a DRAFT (Billomat refuses it for any other status).”

    Publisher declares: read-only no · destructive yes · idempotent no

    12 inputs, 1 required
    • invoice_idinteger or stringrequired“The draft invoice id.”
    • titlestring“Item title (required unless article_id is given).”
    • descriptionstring“Item description.”
    • quantitynumber“Quantity (required unless article_id is given).”
    • unitstring“Unit, e.g.”
    • unit_pricenumber“Unit price, net or gross as net_gross of the document (required unless article_id is given).”
    • tax_namestring“Tax name; with tax_rate overrides the standard tax of the account.”
    • tax_ratenumber“Tax rate in percent; the account's standard rate when omitted.”
    • article_idinteger or string“An article id (from billomat_list_articles): title, unit, price and tax missing here are taken from the article.”
    • typestring“PRODUCT or SERVICE.”
    • optionalboolean“Offers only: mark the item as optional (its price is left out of the total).”
    • reductionstring“Discount: absolute (10) or percent (10%).”
  • billomat_create_draft_offercreates or changes datadescribed as changing data

    “WRITE: create an offer (Angebot) as a DRAFT for a client, with optional line items.”

    Publisher declares: read-only no · destructive yes · idempotent no

    11 inputs, 1 required
    • client_idinteger or stringrequired“The client id (from billomat_list_clients).”
    • contact_idinteger or string“A contact of that client.”
    • datestring“Document date (yyyy-mm-dd; today when omitted).”
    • titlestring“Document title.”
    • labelstring“Label / subject.”
    • introstring“Introduction text.”
    • notestring“Closing note.”
    • currency_codestring“ISO currency code, e.g.”
    • net_grossstring“Whether prices are net or gross.”
    • itemsarray“Line items (up to 200).”
    • validity_daysinteger“Days the offer stays valid.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

How well are its tools described?

Features #4 and #5

How clearly this server's own tool descriptions say what a tool does, and how consistent its tool list is. The first part is an AI model's yes/no reading of each description; the second part is counted. We do not turn it into a grade.

Descriptions

AI reading of each description

Says what the tool does
100% of 34 tools
Says what it returns
39% of 33 tools
States limits, defaults or errors
32% of 28 tools
Says when to use it
15% of 34 tools
Items covered per tool
1.8 of 4 on average

Counted from the listing

Parameters with a description
100% of 261
Tools with a description
100% of 34
Typical description length
106 characters

The tool set

Counted from the listing

Tools
34
Size of the list
about 11,990 tokens for an agent to load (characters ÷ 4)
Naming
34 of 34 names use snake_case

AI reading: easy to mix up

No pair found.

The AI items cover 34 of 34 tools: for a tool where two differently worded runs disagreed, that item is left out. They were not checked by hand, and no tool was called. “Easy to mix up” means two tools whose names or descriptions overlap without saying how they differ; the AI found none. We do not rate whether the tool set is complete or whether side effects are spelled out, because our AI reading of those was not reliable enough.

How do I add it to my client?

Config from the registry entry

From the remote endpoint (Streamable HTTP)

We connected to this URL on 2026-10-23 (a read-only session: no tool was called).

Add to CursorAn install link in the format Cursor documents, holding the Cursor config below.

Claude Desktop or claude.ai
Settings → Connectors → Add custom connector, then paste:
https://billomat.usefulapi.io/mcp
Cursor · .cursor/mcp.json in a project, or ~/.cursor/mcp.json
{
  "mcpServers": {
    "billomat": {
      "url": "https://billomat.usefulapi.io/mcp"
    }
  }
}
VS Code · .vscode/mcp.json
{
  "servers": {
    "billomat": {
      "type": "http",
      "url": "https://billomat.usefulapi.io/mcp"
    }
  }
}
VS Code (command line) · Bash or zsh terminal (macOS, Linux)
code --add-mcp '{"name":"billomat","type":"http","url":"https://billomat.usefulapi.io/mcp"}'
Claude Code
claude mcp add --transport http billomat https://billomat.usefulapi.io/mcp
Try it in the MCP Inspector · runs on your machine, opens in your browser · Node 22.19+
npx @modelcontextprotocol/inspector@2.11.0 --server-url https://billomat.usefulapi.io/mcp --transport http
  • The server runs on the operator's infrastructure; it may ask you to sign in when you first connect.
  • The MCP Inspector lists the server's tools, resources and prompts; a tool you call there runs for real.

Built from the server's registry entry with each client's documented format (checked 2026-10-14; the Cursor link and the VS Code command 2026-10-19; the MCP Inspector command 2026-10-21). Values in < > are yours to fill in; this page never contains a key. Where the server needs a setting the entry does not declare, it can still fail to start.

Does the registry listing match what we found?

Feature #6

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.

Registry saysWe foundResultSource · date
Remote endpoint billomat.usefulapi.io/mcpSession openedmatchesour test · 2026-10-23
No credential declared as requiredOpened a session without any credentialmatchesour test · 2026-10-23
Repository github.com/m190/usefulapi-mcpOpens publiclymatchesapi.github.com · 2026-10-23

Who made it?

Feature #7 · lineage

Facts about the publisher. We do not turn them into a trust score.

Namespace
io.usefulapi · 341 servers
GitHub owner
a personal account (m190)
Repository
github.com/m190/usefulapi-mcp
Stars
0
Repository age
91–180 days
Last push
0–30 days ago
Archived
no
Security policy
none found (we looked for SECURITY.md in the repository and in its owner’s .github repository)

Source: the registry entry and api.github.com · 2026-10-23; security policy read from GitHub · 2026-10-23.

Publish this server? Run these checks against it yourself before release, from your own machine: a server the command starts, or your own server at its URL after a one-time proof that you control it: npx protocolprobe-selftest.

Choosing

Record checks

Public records · not a safety rating

4 of 5 record checks met · 4 do not apply

  • Not ranked by downloads: a remote server publishes no download figure
  • Not ranked by stars: 0 stars (ranked from 10)
  • MetRegistry entry is active and says how to run itActive, with a package or a remote address.
  • MetSource repository link opensThe linked GitHub repository is public.
  • MetRepository is not archivedNot archived.
  • MetCode pushed to the repository in the 90 days before our checkLast push 0-30 days before our check.
  • Not metRepository publishes a security policy (SECURITY.md)No SECURITY.md in the places GitHub reads it from.
  • Does not applyPackage names its licence with a standard (SPDX) identifierRemote server: it ships no package.
  • Does not applyThe version the registry lists can be installed and is not withdrawnRemote server: it ships no package.
  • Does not applynpm package carries build provenance (attestation)Remote server: it ships no package.
  • Does not applyNo known critical or high advisory in the package or its dependenciesRemote server: it ships no package.

Read from public records only: the registry entry, npm/PyPI, GitHub and advisory databases, checked 2026-10-23. No tool was called. Only “met” and “not met” are counted, so the total differs between servers; a check that does not apply or that we could not run is listed, never counted against it. It is not a safety rating. How each check works · Leaderboards

Common questions about io.usefulapi/billomat

Answered from the data above

Is io.usefulapi/billomat safe to install?

We do not rate servers as safe or unsafe. 4 of its 5 applicable record checks are met (facts from public records, each listed on this page). What the records show: Its source repository opens publicly. Its repository had a push in the last 90 days. 6 of its tools describe changing data (our AI model's reading of the descriptions). These are facts with their sources on this page, not a safety guarantee, and we did not run its tools.

Is io.usefulapi/billomat free to use?

Its website (usefulapi.io/billomat/) describes a freemium pricing model. This is an AI-classified reading of the page on 2026-10-23, so check the page itself before relying on it.

Does io.usefulapi/billomat need an API key or sign-in?

It opened a session without any credential on 2026-10-23. The registry entry declares no required credential; no declaration is not a guarantee.

Has io.usefulapi/billomat been security tested?

Partly. 3 of the 16 checks that apply to it were exercised. It accepted a session without any credential and lists tools whose names suggest they change data. We did not call them. No security verdict is published before verification.

What can io.usefulapi/billomat do?

It lists 34 tools. In our AI model's reading of their descriptions (two runs had to agree, nobody checked it by hand), they include tools that read or search and create or change data. We did not call any tool, so this describes the text, not the behaviour.

Can io.usefulapi/billomat change or delete data?

6 of its tools say in their description that they create, edit, delete, send or run something (our AI model's reading). We did not call any tool, so we cannot say what actually happens.

Does io.usefulapi/billomat publish a security policy?

We found no SECURITY.md in its repository (root, .github/ or docs/) or in its owner's .github repository.

Where is the source code of io.usefulapi/billomat?

In github.com/m190/usefulapi-mcp, which opens publicly.

Found this page useful?

Anonymous · no sign-in

A quick, anonymous reaction — no account, no email. One per kind from your browser. The tally updates when the page is next refreshed, and it is only a rough count, never a safety rating or a measured number of people.

Similar servers

Same topic · AI-read

Active servers whose topic is also “finance-and-payments” and that have at least one tool of the same kind; most kinds in common first, then most GitHub stars. The topic and the tool kinds are an AI model's reading of the publishers' descriptions, not checked by hand. Similar is not a recommendation.

Compare with another server

Side by side: registry entry, our read-only session, the tools and the 18 classification fields. Same values as each page; no score.

Security testing

What did we test, and what did we leave out?

18 checks · features #1, #2

Open without sign-in

It accepted a session without any credential and lists tools whose names suggest they change data. We did not call them. No security score is given; a check we did not run is never counted as passed.

The 18 checks at a glanceour test · 2026-10-23
  1. Inventory: exercised
  2. Hidden instructions: exercised
  3. Real execution: not run · our policy
  4. Secret leak: not run · nothing to check it against
  5. Internal addresses: not run · our policy
  6. Unconfirmed changes: not run · our policy
  7. Bad input: not run · our policy
  8. Model requests: not run · nothing to check it against
  9. Sensitive questions: not run · nothing to check it against
  10. Folder boundary: not run · our policy
  11. Log leaks: not run · nothing to check it against
  12. Hidden content: not run · nothing to check it against
  13. Fake assistant turns: not run · an error was returned
  14. Token passthrough: not applicable
  15. Token audience: not applicable
  16. Sign-in redirect: not run · our policy
  17. Consent handling: not testable from outside
  18. Sign-in metadata: exercised

3 exercised13 not run (reason given)2 not applicable

Each check ends in exactly one state: exercised, not run (with the reason), or not applicable (with the reason). 3 of the 16 checks that apply to it were exercised. We do not publish security-check outcomes for named servers.

Exercised · 3
  • 1Inventory
    tool-list
    Reads the declared tools, resources and prompts.exercised
  • 2Hidden instructions
    description-poisoning
    Looks for hidden instructions in tool descriptions.exercised
  • 18Sign-in metadata
    oauth-url-scheme
    Checks the published sign-in metadata for unsafe URLs.exercised
Not run, with the reason · 13
  • 3Real execution
    real-execution
    Calls a tool and checks what really happens.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 4Secret leak
    canary-leak
    Plants a fake secret and checks whether it leaks.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 5Internal addresses
    ssrf
    Checks whether a tool can be steered to internal addresses.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 6Unconfirmed changes
    write-without-confirmation
    Checks whether tools that change data act without asking.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 7Bad input
    error-handling
    Sends bad input and watches how the server answers.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 8Model requests
    sampling
    Checks whether the server asks the client's model to act for it.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 9Sensitive questions
    elicitation-sensitive-data
    Checks whether the server asks users for sensitive data.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 10Folder boundary
    root-boundary
    Checks whether the server reaches outside the folders it was given.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 11Log leaks
    logging-side-channel
    Checks whether log messages carry data they should not.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 12Hidden content
    audience-hiding
    Checks resources that hide content from the user.This check needs content the server returns, and nothing was read or called.not run · nothing to check it against
  • 13Fake assistant turns
    fake-assistant-turn
    Checks prompts that pose as the assistant's own words.The server returned an error when its prompts were read.not run · an error was returned
  • 16Sign-in redirect
    open-redirect
    Checks the sign-in redirect for abuse.Testing the sign-in redirect means sending probes to the operator's sign-in service, which we do not do.not run · our policy
  • 17Consent handling
    confused-deputy
    Checks consent handling when one service acts for another.Depends on the operator's own consent screen, which differs per server and cannot be tested from outside.not testable from outside
Does not apply to this server · 2
  • 14Token passthrough
    token-passthrough
    Checks whether the server forwards a user's token to other services.The server opened a session without sign-in, so there is no token flow to check.not applicable
  • 15Token audience
    token-audience-validation
    Checks whether tokens meant for another service are accepted.The server opened a session without sign-in, so there is no token flow to check.not applicable

Source: our own test, 2026-10-23, mcp-runtime-engine@0.1.0. Which checks count and why follows our published scoring model.

What happened during the test?

Feature #8

The steps in order, as the test record holds them.

  1. 0 msStarted a read-only session with the server's remote endpoint
  2. 459 msConnected after 0 redirects. No credential was sent or needed.
  3. Read the inventory: 34 tools, 0 resources, 1 prompt.
  4. 1,599 msFinished: 3 checks exercised.

Reference

How is it classified?

18 fields

One value per field, each with its source. Fields written by AI models are marked. A field with no value says why.

TopicAI-classified
AI-classified · 2026-10-23
Pricing modelAI-classified
freemium
read from usefulapi.io/billomat/ · 2026-10-23

“live 38 tools Free 50 tool calls / month”

Programming language
api.github.com · 2026-10-23
Hosting type
registry · 2026-10-23
MCP capability
prompts, tools
our test · 2026-10-23
Transport
streamable HTTP
registry · 2026-10-23
Required credentials
none declared
registry · no declaration is not a guarantee
Package registry
does not apply
remote-only server: no package is shipped, so there is no package registry
Freshness
0–30 days
registry updatedAt · 2026-10-23
Lifecycle status
registry · 2026-10-23
License class
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Integrity hash
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Signature / provenance
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Dependency advisories
does not apply
ships no package, so there are no dependencies to audit
Popularity
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Publisher signals
owner: a personal account · repository age: 91–180 days · stars: 0–9
api.github.com · 2026-10-23
Maintenance
api.github.com · 2026-10-23
Environment
the publisher's infrastructure
where it runs, from the hosting type

“Not stated” means the source did not state it; “does not apply” means it does not apply to this kind of server; “our limit” means our own lookup failed. A linked value opens the directory filtered to the same value.

Cite or correct this page

Sources and corrections

Suggested citation

ProtocolProbe. “io.usefulapi/billomat: MCP server record.” Data checked 2026-10-23. https://protocolprobe.com/mcp/servers/io.usefulapi/billomat

Figures are valid for the date shown. Our facts on this page are CC BY 4.0: reuse them with a link and the check date. Quoted text (the publisher’s descriptions, website quotes, tool names) is not ours to license.

As JSON: this record in the API · API documentation.

Badge for your README

ProtocolProbe: 4 of 5 record checks met

[![ProtocolProbe](https://protocolprobe.com/api/v1/badge/io.usefulapi/billomat)](https://protocolprobe.com/mcp/servers/io.usefulapi/billomat)

It shows this server's record-check count: facts from public records, no tool called. It is not a security rating or a pass. It links here and updates after each data reload.

Something wrong, or is this yours?

If a fact here is wrong, tell us and we will re-check it. If you operate this server, you can run our checks on it yourself with the free self-test command; we call no server’s tools ourselves for anything shown here.

Write to hello@protocolprobe.com · corrections log · methodology