MCP server

SmartBill MCP by usefulapi

io.usefulapi/smartbill

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read SmartBill series, taxes, stock, clients and products; draft and issue invoices and estimates.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

23

Token cost

About 7,647 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.smartbill]
url = "https://smartbill.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"smartbill":{"httpUrl":"https://smartbill.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"smartbill":{"url":"https://smartbill.usefulapi.io/mcp"}}}

VS Code

{"servers":{"smartbill":{"type":"http","url":"https://smartbill.usefulapi.io/mcp"}}}

Antigravity

agy mcp add smartbill https://smartbill.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"smartbill","server_url":"https://smartbill.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"smartbill","server_url":"https://smartbill.usefulapi.io/mcp"}

Tools

• smartbill_cancel_estimate ~137 tokens
  Cancel an existing proforma (smartbill_restore_estimate undoes it). PUT /estimate/cancel.
• smartbill_cancel_invoice ~197 tokens
  Cancel an existing invoice (it stays in the books as cancelled; smartbill_restore_invoice undoes it). Changes the document's fiscal status, so confirm with the user. PUT /invoice/cancel.
• smartbill_create_estimate ~1304 tokens
  Create a proforma (estimate) for a client with product/service lines. Default is a DRAFT (no number); with draft=false it takes the next number of the proforma series. A proforma is not a fiscal invoice. Returns series, number, documentId and links. POST /estimate/v2.
• smartbill_create_invoice Moves money · ~1387 tokens
  Create an invoice for a client with product/service lines. By default it is saved as a DRAFT (no number) for review in SmartBill Cloud. With draft=false the invoice is ISSUED: it takes the next number of the series, cannot be deleted or edited through this server, can only be cancelled or reversed (
• smartbill_create_invoice_from_estimate ~370 tokens
  Create an invoice from an existing proforma (client and lines are copied from it). Default is a DRAFT; with draft=false the invoice is ISSUED with the next number of the series and may be transmitted to e-Factura / ANAF. Stock is not discharged. POST /invoice/v2 (useEstimateDetails).
• smartbill_get_client ~131 tokens
  One client by V3 id (cus_...): name, CIF, address, bank, contact, VAT-payer flag and delivery addresses. Needs the API V3 token. GET /v3/companies/{cif}/clients/{id}.
• smartbill_get_estimate_invoices ~156 tokens
  Whether a proforma was invoiced and the invoices (series, number) made from it. A draft invoice shows with an empty number. GET /estimate/invoices.
• smartbill_get_invoice_payment_status ~187 tokens
  Whether an invoice is paid and how much remains: invoiceTotalAmount, paidAmount, unpaidAmount and the paid flag. GET /invoice/paymentstatus.
• smartbill_get_product ~115 tokens
  One product or service by V3 id (prod_...). Needs the API V3 token. GET /v3/companies/{cif}/products/{id}.
• smartbill_get_stock ~202 tokens
  Stock quantities per warehouse as of a date (needs the SmartBill stock module). Optional filters: warehouse_name (case-sensitive), product_name, product_code. No filters = all products in all warehouses. GET /stocks.
• smartbill_get_supplier ~112 tokens
  One supplier by V3 id (sup_...). Needs the API V3 token. GET /v3/companies/{cif}/suppliers/{id}.
• smartbill_list_clients ~337 tokens
  List clients from the SmartBill client list, optionally filtered by name (partial, case-insensitive), internal code (exact) or CIF (exact). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/clients.
• smartbill_list_products ~312 tokens
  List the product and service catalog (price, unit, VAT rate, currency), optionally filtered by name (whole-word match) or internal code (exact). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/products.
• smartbill_list_series ~143 tokens
  List the document series configured in SmartBill Cloud with their next number. Invoice and proforma tools need a series name from here. type: f = invoice series, p = proforma, c = receipt (chitanta); omit for all. GET /series.
• smartbill_list_suppliers ~327 tokens
  List suppliers, optionally filtered by name (partial), internal code (exact) or CIF (exact). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/suppliers.
• smartbill_list_taxes ~97 tokens
  List the VAT rates configured in the account (name and percentage). Use the name as tax_name and the percentage as tax_percentage on document lines. Works without a V3 token. GET /tax.
• smartbill_list_vat_rates ~312 tokens
  List VAT rates with ids, name, percentage and reverse-charge flag. Filter by name (partial) or percentage (exact). Needs the API V3 token (smartbill_list_taxes does the same without it). Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/vat-rates.
• smartbill_list_warehouses ~260 tokens
  List warehouses (name, type en gros / en detail, keeper, address). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/warehouses.
• smartbill_record_invoice_payment ~586 tokens
  Record a collection (incasare) against one or more issued invoices; client and amount are taken from the invoices. With value (single invoice only) a partial payment is recorded. type Chitanta issues a numbered RECEIPT on receipt_series (cannot be undone from this server); the other types (Card, Ord
• smartbill_restore_estimate ~130 tokens
  Restore a proforma that was cancelled. PUT /estimate/restore.
• smartbill_restore_invoice ~168 tokens
  Restore an invoice that was cancelled, making it active again. PUT /invoice/restore.
• smartbill_reverse_invoice ~240 tokens
  ISSUE a storno (credit) invoice that reverses an issued invoice. It takes the next number, an invoice can be reversed only once, and the storno cannot be undone; it may be transmitted to e-Factura / ANAF. Confirm the exact series and number with the user first. POST /invoice/reverse.
• smartbill_send_document Sends messages · ~437 tokens
  Send an issued invoice or proforma by email from SmartBill. This EMAILS A THIRD PARTY and cannot be recalled. Without `to` it goes to the client's email on the document; without subject/body_text the account's email template is used. Confirm the recipient with the user first. POST /document/send.

Browse

• PDF tools
• Payments
• Invoicing and accounting

Related MCP servers

• Lightspeed Retail (X-Series) MCP by usefulapi
  Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.
• Megaventory MCP by usefulapi
  Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.
• Bind ERP MCP by usefulapi
  Read Bind ERP clients, products, inventory, invoices, orders; create prospects, clients, orders.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Invoice Ninja MCP by usefulapi
  Manage Invoice Ninja clients, invoices, quotes, expenses, tasks and projects.
• Lightspeed Retail (R-Series) MCP by usefulapi
  Read Lightspeed R-Series items, stock, sales, customers and POs; create customers and set stock.
• Billomat MCP by usefulapi
  Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices.
• Oblio MCP by usefulapi
  Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/smartbill.svg)](https://aptlynx.net/servers/io.usefulapi/smartbill)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents