SmartBill MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

SmartBill MCP by usefulapi's hosted MCP server (smartbill.usefulapi.io), published by usefulapi.io; no sign-in required; Streamable HTTP; 23 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
usefulapi.io
Endpoint
smartbill.usefulapi.io
Last checked

Installation

In SourceWeft

  1. Open SmartBill MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fsmartbill/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

SmartBill MCP by usefulapi

Use SmartBill from Claude, Cursor, or any MCP client — document series, VAT rates, stock, payment status, clients, suppliers, products and warehouses, plus invoices and estimates (drafts by default), storno, cancel/restore, payments and sending documents by e-mail. Hosted, no local install: connect with your own SmartBill credentials.

Live endpoint: https://smartbill.usefulapi.io/mcp · Homepage: https://usefulapi.io/smartbill

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://smartbill.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http smartbill https://smartbill.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "smartbill": {      "url": "https://smartbill.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your SmartBill credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/smartbill/

Tools

ToolTypeWhat it does
smartbill_list_seriesreadList document series
smartbill_list_taxesreadList VAT rates (V1)
smartbill_get_stockreadGet stock levels
smartbill_get_invoice_payment_statusreadGet invoice payment status
smartbill_get_estimate_invoicesreadGet invoices of a proforma
smartbill_list_clientsreadList or search clients
smartbill_get_clientreadGet a client
smartbill_list_suppliersreadList or search suppliers
smartbill_get_supplierreadGet a supplier
smartbill_list_productsreadList or search products and services
smartbill_get_productreadGet a product or service
smartbill_list_warehousesreadList warehouses
smartbill_list_vat_ratesreadList VAT rates (V3)
smartbill_create_invoicewriteCreate an invoice
smartbill_create_invoice_from_estimatewriteCreate an invoice from a proforma
smartbill_create_estimatewriteCreate a proforma
smartbill_reverse_invoicewriteReverse an invoice (storno)
smartbill_cancel_invoicewriteCancel an invoice
smartbill_restore_invoicewriteRestore a cancelled invoice
smartbill_cancel_estimatewriteCancel a proforma
smartbill_restore_estimatewriteRestore a cancelled proforma
smartbill_record_invoice_paymentwriteRecord a payment against invoices
smartbill_send_documentwriteEmail an invoice or proforma
smartbill_usage_statusmetaUsage status (free-tier meter)
smartbill_request_featuremetaRequest a missing feature
smartbill_upgrademetaUpgrade to Pro or Pro+
smartbill_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per company)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with smartbill_upgrade (it returns a Stripe Checkout link). Cancel any time with smartbill_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running smartbill_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by SmartBill.

Source: servers/smartbill/README.md at commit 4046075

Tools

23

smartbill_list_series

List document series

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.

Parameterstype

smartbill_list_taxes

List VAT rates (V1)

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.

Takes no parameters.

smartbill_get_stock

Get stock levels

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.

Parametersdaterequiredproduct_codeproduct_namewarehouse_name

smartbill_get_invoice_payment_status

Get invoice payment status

Whether an invoice is paid and how much remains: invoiceTotalAmount, paidAmount, unpaidAmount and the paid flag. GET /invoice/paymentstatus.

Parametersnumberrequiredseries_namerequired

smartbill_get_estimate_invoices

Get invoices of a proforma

Whether a proforma was invoiced and the invoices (series, number) made from it. A draft invoice shows with an empty number. GET /estimate/invoices.

Parametersnumberrequiredseries_namerequired

smartbill_list_clients

List or search clients

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.

Parameterscodenameafterlimitbeforevat_code

smartbill_get_client

Get a client

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

Parametersidrequired

smartbill_list_suppliers

List or search suppliers

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.

Parameterscodenameafterlimitbeforevat_code

smartbill_get_supplier

Get a supplier

One supplier by V3 id (sup_...). Needs the API V3 token. GET /v3/companies/{cif}/suppliers/{id}.

Parametersidrequired

smartbill_list_products

List or search products and services

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.

Parameterscodenameafterlimitbefore

smartbill_get_product

Get a product or service

One product or service by V3 id (prod_...). Needs the API V3 token. GET /v3/companies/{cif}/products/{id}.

Parametersidrequired

smartbill_list_warehouses

List warehouses

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.

Parametersnameafterlimitbefore

smartbill_list_vat_rates

List VAT rates (V3)

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.

Parametersnameafterlimitbeforepercentage

smartbill_create_invoice

Create an invoice

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 (storno), and, depending on the account's e-Factura setup, may be transmitted to ANAF. Confirm every field with the user before draft=false. Returns series, number, documentId, documentUrl (needs login) and documentViewUrl (public PDF link). POST /invoice/v2.

Parametersdraftclientrequiredcurrencydue_datelanguagementionsproductsrequiredissue_dateseries_namerequiredobservationsexchange_rate

smartbill_create_invoice_from_estimate

Create an invoice from a proforma

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

Parametersdraftissue_dateseries_namerequiredestimate_numberrequiredestimate_seriesrequired

smartbill_create_estimate

Create a proforma

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.

Parametersdraftclientrequiredcurrencydue_datelanguagementionsproductsrequiredissue_dateseries_namerequiredobservationsexchange_rate

smartbill_reverse_invoice

Reverse an invoice (storno)

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.

Parametersnumberrequiredissue_dateseries_namerequired

smartbill_cancel_invoice

Cancel an invoice

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.

Parametersnumberrequiredseries_namerequired

smartbill_restore_invoice

Restore a cancelled invoice

Restore an invoice that was cancelled, making it active again. PUT /invoice/restore.

Parametersnumberrequiredseries_namerequired

smartbill_cancel_estimate

Cancel a proforma

Cancel an existing proforma (smartbill_restore_estimate undoes it). PUT /estimate/cancel.

Parametersnumberrequiredseries_namerequired

smartbill_restore_estimate

Restore a cancelled proforma

Restore a proforma that was cancelled. PUT /estimate/restore.

Parametersnumberrequiredseries_namerequired

smartbill_record_invoice_payment

Record a payment against invoices

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, Ordin plata, ...) record the payment without a document. It changes the invoice's paid status in the books: confirm with the user. Fiscal receipts (Bon) are not supported. POST /payment.

Parameterstexttyperequiredvalueis_cashinvoicesrequiredissue_datereceipt_series

smartbill_send_document

Email an invoice or proforma

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.

Parameterscctobcctyperequirednumberrequiredsubjectbody_textseries_namerequired

Version history

20
  1. v1.23.5LatestNov 8, 2026
  2. v1.23.4Nov 7, 2026
  3. v1.22.3Nov 5, 2026
  4. v1.22.2Nov 5, 2026
  5. v1.22.1Nov 4, 2026
  6. v1.22.0Nov 3, 2026
  7. v1.21.1Nov 3, 2026
  8. v1.20.0Nov 1, 2026
  9. v1.18.0Oct 31, 2026
  10. v1.17.0Oct 31, 2026
  11. v1.16.2Oct 30, 2026
  12. v1.16.0Oct 30, 2026
  13. v1.11.0Oct 26, 2026
  14. v1.8.3Oct 25, 2026
  15. v1.8.0Oct 25, 2026
  16. v1.7.0Oct 24, 2026
  17. v1.4.0Oct 23, 2026
  18. v1.3.4Oct 22, 2026
  19. v1.3.3Oct 21, 2026
  20. v1.0.0Oct 12, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations