Summary
SmartBill Cloud API for Romanian invoicing: issue invoices and estimates (proforme) as drafts or final documents, create an invoice from an estimate, check payment status, download PDFs, email documents to clients, and read document series, VAT rates and stock by warehouse. Reversal, cancel, delete and payment registration are switched off. Email and API token.
Guided setup
Connect SmartBill to Cursor in 2 minutes
Start a free trial on AnythingMCP Cloud, connect SmartBill in the guided setup, then add your MCP URL to Cursor. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for SmartBill
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → SmartBill, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
SmartBill + Cursor
SmartBill Cloud API for Romanian invoicing: issue invoices and estimates (proforme) as drafts or final documents, create an invoice from an estimate, check payment status, download PDFs, email documents to clients, and read document series, VAT rates and stock by warehouse. Reversal, cancel, delete and payment registration are switched off. Email and API token.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
Step 1 — Get credentials
Setting up takes about 2 minutes.
- Sign in to SmartBill Cloud and open Contul meu, Integrari, section API (https://cloud.smartbill.ro/core/integrari/).
- Copy the Email into
SMARTBILL_EMAIL, the Token intoSMARTBILL_API_TOKENand the CIF of the company intoSMARTBILL_CIF.
Calls use HTTP Basic authentication with the email as user and the token as password. The connector adds the company CIF to every call, so one connector works on one company; install it again for a second company.
Where to start: smartbill_list_series (the series names every document needs) and smartbill_list_taxes (the VAT rate names). Then smartbill_create_invoice or smartbill_create_estimate.
What the API cannot do: V1 has no list or search of invoices, clients or products and no JSON view of a document. A document is addressed by its series and number, which the user gives or which the create call returned. Keep the series, number and documentViewUrl of what you create.
Invoices: smartbill_create_invoice saves a draft unless is_draft is false. A final invoice gets the next number of the series and is a fiscal document: SmartBill sends it to ANAF e-Factura according to the account settings, which this API does not control. smartbill_create_invoice_from_estimate turns a proforma into an invoice. smartbill_get_invoice_payment_status tells what is paid and what is due, smartbill_get_invoice_pdf downloads the file, smartbill_send_document_email emails an invoice or estimate to the client. smartbill_reverse_invoice (storno), smartbill_cancel_invoice, smartbill_restore_invoice and smartbill_delete_invoice are installed switched off.
Estimates (proforme): smartbill_create_estimate, smartbill_get_estimate_invoices (was it invoiced), smartbill_get_estimate_pdf; smartbill_cancel_estimate, smartbill_restore_estimate and smartbill_delete_estimate are switched off.
Payments: smartbill_get_fiscal_receipt_text reads a fiscal receipt. smartbill_register_payment (records a collection or issues a receipt), smartbill_delete_receipt and smartbill_delete_payment are switched off. Nothing here charges a card or moves money: payments are bookkeeping records.
Stock: smartbill_list_stocks returns quantities per warehouse (gestiune) on a date; warehouse names are case-sensitive.
Writing a document: seriesName, taxName and measuringUnitName must match the account exactly; never invent them. Prices are without VAT unless isTaxIncluded is true. taxPercentage is required on every line (21 is the standard rate since August 2025). If the account uses product codes, every line needs code. A discount line needs numberOfItems and a negative discountValue, otherwise it is silently ignored or added. For a client in Bucuresti the city must be Sector 1 to Sector 6, or e-Factura rejects the invoice. Every document, drafts included, counts toward the documents of the SmartBill plan.
Errors: the errorText of the answer is the cause, in Romanian (for example Seria nu a fost gasita! for an unknown series); it can contain HTML, so quote only its first sentence. A request with an unknown field or a wrong type is answered 400 with errors[].message and errors[].param naming the field. 401 means wrong email or token, 403 that the user has no right on the company or series.
Limits: 30 calls per 10 seconds per token; going over blocks the token for 10 minutes. The headers X-RateLimit-Remaining and X-RateLimit-Reset show what is left.
Not covered: the newer API V3 (lists of clients, products, warehouses, suppliers and goods receipt notes) uses a separate Bearer token and is not part of this connector. Fiscal receipts (bon fiscal) need a cash register and are not issued here.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Cursor
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart Cursor.
- Open Cursor → Settings → MCP and check that
anythingmcpis listed and connected. - Start chatting — the agent can now call the
SmartBilltools.
Available tools
| Tool | What it does |
|---|---|
smartbill_list_series | List the document series configured in SmartBill: list with each series name, its nextNumber and type (f invoices, p estimates and… |
smartbill_list_taxes | List the VAT rates configured in SmartBill: taxes with each rate name (e.g. Normala) and percentage. Use the name as taxName and the… |
smartbill_list_stocks | Read stock levels on a date: list with one entry per warehouse (warehouseName, warehouseType en gros or en detail) and its products… |
smartbill_create_invoice | Create an invoice in SmartBill. By default it is saved as a draft (no number), which the user checks and finalizes in SmartBill; with… |
smartbill_create_invoice_from_estimate | Create an invoice from an existing estimate (proforma): client and lines are copied from the estimate. By default the invoice is saved as a… |
smartbill_get_invoice_payment_status | Check whether an invoice is paid: invoiceTotalAmount (total with VAT), paidAmount, unpaidAmount and paid (true when fully paid).… |
smartbill_get_invoice_pdf | Download an issued invoice as a PDF file. The answer is the file itself, handed over as an attachment; the API has no JSON view of an… |
smartbill_send_document_email | Send an issued invoice or estimate to the client by email as an attachment, with the subject and text of the email template configured in… |
smartbill_reverse_invoice | Issue a reversal (storno) invoice for an existing invoice: a new fiscal document with negative amounts on the same series. It counts toward… |
smartbill_cancel_invoice | Cancel (anulare) an issued invoice. The invoice keeps its number and is marked cancelled; it can be restored with… |
smartbill_restore_invoice | Restore an invoice that was cancelled, making it valid again. Installed switched off; confirm with the user before calling it |
smartbill_delete_invoice | Delete an invoice permanently. Only the last invoice of a series can be deleted, and this cannot be undone. Installed switched off; confirm… |
smartbill_create_estimate | Create an estimate (proforma) in SmartBill. By default it is saved as a draft (no number); with is_draft false it is issued at once with… |
smartbill_get_estimate_invoices | Check whether an estimate (proforma) was invoiced: areInvoicesCreated and invoices with the series and number of each invoice made… |
smartbill_get_estimate_pdf | Download an estimate (proforma) as a PDF file. The answer is the file itself, handed over as an attachment. A wrong series or number is… |
smartbill_cancel_estimate | Cancel an estimate (proforma). It keeps its number and can be restored with smartbill_restore_estimate. Installed switched off; confirm… |
smartbill_restore_estimate | Restore an estimate (proforma) that was cancelled. Installed switched off; confirm with the user before calling it |
smartbill_delete_estimate | Delete an estimate (proforma) permanently. This cannot be undone. Installed switched off; confirm with the user before calling it |
smartbill_register_payment | Record a payment received from a client in SmartBill, optionally against invoices. The type decides what is created: Chitanta issues a… |
smartbill_get_fiscal_receipt_text | Read the content of a fiscal receipt (bon fiscal) by its id: message holds the receipt text for the fiscal printer, Base64-encoded, in… |
smartbill_delete_receipt | Delete a receipt (chitanta) permanently. Only the last receipt of a series can be deleted. Installed switched off; confirm with the user… |
smartbill_delete_payment | Delete a recorded payment that is not a receipt (Card, Ordin plata, CEC and so on). Identify it by the invoice it settles (invoice_series… |
Example prompts
- "Which document series and VAT rates are set up in SmartBill?"
- "Create a draft invoice in series FCT for SC Exemplu SRL: 10 hours consultanta at 200 lei plus VAT."
- "Is invoice FCT 0142 paid, and how much is still due?"
- "Turn proforma PRF 0031 into an invoice and email it to the client."
- "What is the stock in warehouse Depozit Central today?"
FAQ
Where do the credentials come from? SmartBill Cloud, Contul meu, Integrari, section API: copy the Email, the Token and the CIF of the company. One connector works on one company; install it again for a second company. This is the V1 token, not the Bearer token of API V3.
What does it cover? Invoices and estimates (proforme) as drafts or final documents, invoices from estimates, payment status, PDFs, emailing documents to clients, fiscal receipt text, document series, VAT rates and stock per warehouse. API V1 has no list or search of invoices, clients or products: a document is addressed by its series and number. A final invoice is a fiscal document that SmartBill sends to ANAF e-Factura according to the account settings.
Which tools install switched off? smartbill_reverse_invoice, smartbill_cancel_invoice, smartbill_restore_invoice, smartbill_delete_invoice, smartbill_cancel_estimate, smartbill_restore_estimate, smartbill_delete_estimate, smartbill_register_payment, smartbill_delete_receipt and smartbill_delete_payment. Switch them on on the connector page only if the AI should use them. No tool charges a card or moves money.
Does Cursor support custom MCP servers on the free tier? Yes — MCP is available on Hobby, Pro and Business plans.
Next steps
Was this guide helpful?