Connector guide9-minute read22 MCP tools7 languages

Connect SmartBill to ChatGPT via MCP: Invoices and VAT

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.

HCBy HelpCode teamUpdated 9 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

SmartBill

SmartBill

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.

tools

22

Region

RO

Category

Accounting

Authentication

Basic Auth

Required env vars

SMARTBILL_EMAILSMARTBILL_API_TOKENSMARTBILL_CIF
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

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 ChatGPT in 2 minutes

Start a free trial on AnythingMCP Cloud, connect SmartBill in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

AnythingMCP's plugin in ChatGPT's directory answers questions from your company databases on AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, read-only): open the listing (opens in a new tab) and click Install plugin. Every other connector is added to ChatGPT as a custom MCP server with your AnythingMCP MCP URL.

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.

SmartBill · live via MCP
Share
Opus 4.7

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 + ChatGPT

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.

  1. Sign in to SmartBill Cloud and open Contul meu, Integrari, section API (https://cloud.smartbill.ro/core/integrari/).
  2. Copy the Email into SMARTBILL_EMAIL, the Token into SMARTBILL_API_TOKEN and the CIF of the company into SMARTBILL_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 ChatGPT

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 shows YOUR_SERVER_ID.

ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.

  1. Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
  2. Enter a name, e.g. Name: SmartBill.
  3. Under Connection, enter the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID and keep Authentication on OAuth.
  4. Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
  5. Install the new plugin from your personal plugins, then type @ in a chat and pick it.

Available tools

ToolWhat it does
smartbill_list_seriesList the document series configured in SmartBill: list with each series name, its nextNumber and type (f invoices, p estimates and…
smartbill_list_taxesList 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_stocksRead stock levels on a date: list with one entry per warehouse (warehouseName, warehouseType en gros or en detail) and its products…
smartbill_create_invoiceCreate 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_estimateCreate 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_statusCheck whether an invoice is paid: invoiceTotalAmount (total with VAT), paidAmount, unpaidAmount and paid (true when fully paid).…
smartbill_get_invoice_pdfDownload 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_emailSend 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_invoiceIssue a reversal (storno) invoice for an existing invoice: a new fiscal document with negative amounts on the same series. It counts toward…
smartbill_cancel_invoiceCancel (anulare) an issued invoice. The invoice keeps its number and is marked cancelled; it can be restored with…
smartbill_restore_invoiceRestore an invoice that was cancelled, making it valid again. Installed switched off; confirm with the user before calling it
smartbill_delete_invoiceDelete an invoice permanently. Only the last invoice of a series can be deleted, and this cannot be undone. Installed switched off; confirm…
smartbill_create_estimateCreate 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_invoicesCheck whether an estimate (proforma) was invoiced: areInvoicesCreated and invoices with the series and number of each invoice made…
smartbill_get_estimate_pdfDownload 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_estimateCancel an estimate (proforma). It keeps its number and can be restored with smartbill_restore_estimate. Installed switched off; confirm…
smartbill_restore_estimateRestore an estimate (proforma) that was cancelled. Installed switched off; confirm with the user before calling it
smartbill_delete_estimateDelete an estimate (proforma) permanently. This cannot be undone. Installed switched off; confirm with the user before calling it
smartbill_register_paymentRecord a payment received from a client in SmartBill, optionally against invoices. The type decides what is created: Chitanta issues a…
smartbill_get_fiscal_receipt_textRead 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_receiptDelete a receipt (chitanta) permanently. Only the last receipt of a series can be deleted. Installed switched off; confirm with the user…
smartbill_delete_paymentDelete 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 the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.

Next steps

Was this guide helpful?

Connect SmartBill to ChatGPT in 2 minutes

Start a free trial on AnythingMCP Cloud, connect SmartBill in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.

Related guides

Connectors

Connect SmartBill to Claude via MCP: Invoices and Stock

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.

Connectors

Connect SmartBill to Microsoft Copilot via MCP

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.

Connectors

Connect SmartBill to Cursor via MCP: Invoices and Stock

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.

Connectors

Connect SmartBill to Gemini CLI via MCP: Proformas

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.

Connectors

Connect SmartBill to Meta Muse via MCP: Invoices

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.

Connectors

SmartBill MCP Server: Invoices, Estimates and Stock

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.