Oblio MCP by usefulapi

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

Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Oblio invoicing: read companies, clients, products and invoices, and create proformas or issue, collect and cancel invoices.

What you can do
  • List companies, VAT rates, document series, languages and stock managements to prepare documents
  • Search clients and products, and read invoices or single documents with PDF links and e-Factura status
  • Create proformas and issue fiscal invoices with client, lines, VAT and series
  • Record invoice payments, cancel or restore documents, and send invoices to ANAF e-Factura (SPV)
  • List, create and delete webhook subscriptions for account events
  • Check usage, upgrade or cancel the plan, and request missing features
When to use it
Useful when you work with Oblio for Romanian invoicing and want an assistant to look up clients, products and invoice status, or to draft proformas and issue invoices from a conversation without opening the Oblio interface.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the URL only and sign in through OAuth with your own Oblio account credentials. A free plan allows 50 tool calls per month; paid plans raise the limit.
Before you install
Write tools change real accounting data: issuing an invoice takes the next series number immediately, cannot be edited and can only be cancelled; collecting a payment is not reversible from the API; sending to SPV is irreversible once ANAF accepts it. Webhooks make Oblio POST account data to an endpoint you control. Paid plans are billed through a payment link, with no refund for the current period.

Installation

In SourceWeft

  1. Open Oblio 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%2Foblio/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": {
    "oblio-by-usefulapi": {
      "type": "http",
      "url": "https://oblio.usefulapi.io/mcp"
    }
  }
}

README

Oblio MCP by usefulapi

Use Oblio from Claude, Cursor, or any MCP client — companies, VAT rates, series, clients, products, stock, invoices with e-Factura (SPV) status and webhooks, plus creating proformas, issuing, collecting, cancelling and restoring invoices and sending them to SPV (each fiscal write needs an explicit confirmation). Hosted, no local install: connect with your own Oblio credentials.

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://oblio.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http oblio https://oblio.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": {    "oblio": {      "url": "https://oblio.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 Oblio credentials.

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

Tools

ToolTypeWhat it does
oblio_list_companiesreadList companies
oblio_list_vat_ratesreadList VAT rates
oblio_list_seriesreadList document series
oblio_list_languagesreadList document languages
oblio_list_managementreadList stock managements
oblio_list_clientsreadList or search clients
oblio_list_productsreadList or search products
oblio_get_documentreadGet a document
oblio_list_invoicesreadList invoices
oblio_list_webhooksreadList webhooks
oblio_create_proformawriteCreate a proforma
oblio_issue_invoicewriteIssue an invoice (fiscal, irreversible)
oblio_collect_invoicewriteRecord an invoice payment (collect)
oblio_cancel_documentwriteCancel a document (fiscal)
oblio_restore_documentwriteRestore a cancelled document (fiscal)
oblio_send_einvoice_to_spvwriteSend an invoice to e-Factura (SPV)
oblio_create_webhookwriteCreate a webhook
oblio_delete_webhookwriteDelete a webhook
oblio_usage_statusmetaUsage status (free-tier meter)
oblio_request_featuremetaRequest a missing feature
oblio_upgrademetaUpgrade to Pro or Pro+
oblio_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 user)$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 oblio_upgrade (it returns a Stripe Checkout link). Cancel any time with oblio_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running oblio_upgrade before then undoes the cancel. Or write to [email protected].

License

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

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

Tools

18

oblio_list_companies

List companies

The companies (CIF, name, your access level) linked to the connected Oblio account. Good first call: every other tool needs a CIF from here. GET /api/nomenclature/companies.

Takes no parameters.

oblio_list_vat_rates

List VAT rates

VAT rates (name, percent, default) of a company; use the name and percent on document lines. GET /api/nomenclature/vat_rates.

Parameterscifrequired

oblio_list_series

List document series

Document series of a company (type Factura/Proforma/Aviz, name, start, next number, default). Use the name as series_name. GET /api/nomenclature/series.

Parameterscifrequired

oblio_list_languages

List document languages

Foreign languages a company can issue documents in (code, name). GET /api/nomenclature/languages.

Parameterscifrequired

oblio_list_management

List stock managements

Stock managements (gestiuni) of a company with their work point and type; works only when stock is enabled. GET /api/nomenclature/management.

Parameterscifrequired

oblio_list_clients

List or search clients

Clients of a company, optionally filtered by name or client CIF. Up to 250 per page: pass next_offset as offset for the next page. GET /api/nomenclature/clients.

Parameterscifrequirednameoffsetclient_cif

oblio_list_products

List or search products

Products and services of a company with unit, price, VAT and (with stock) quantities. Up to 250 per page: pass next_offset as offset. GET /api/nomenclature/products.

Parameterscifrequiredcodenameoffsetmanagementwork_stationinclude_unsalable

oblio_get_document

Get a document

One invoice, proforma or notice by series and number: type, series, number, link to the PDF and (invoices) the collections. GET /api/docs/<type>.

Parameterscifrequiredtyperequirednumberrequiredseries_namerequired

oblio_list_invoices

List invoices

Invoices of a company with filters (series, number, dates, client, draft/canceled/collected), newest first by default. Optional products, collections and e-Factura (SPV) status per invoice. Pass next_offset as offset for the next page. GET /api/docs/invoice/list.

Parameterscifrequireddraftnumberoffsetcanceledorder_bycollectedorder_dirclient_cifclient_codeseries_nameclient_email+6 more

oblio_list_webhooks

List webhooks

The webhook subscriptions of the account (id, CIF, topic, endpoint). GET /api/webhooks.

Takes no parameters.

oblio_create_proforma

Create a proforma

Create a PROFORMA (not a fiscal invoice; the preferred first step). It takes the next number of the series immediately, there is no draft state, and Oblio sends no e-mail. Check client, lines, VAT (oblio_list_vat_rates) and series (oblio_list_series) first. Returns the series, number and a PDF link. Not retried: if the reply is an error, look in Oblio before repeating. POST /api/docs/proforma.

Parameterscifrequiredclientrequiredcurrencydue_datelanguagementionsproductsrequiredprecisionissue_dateissuer_nameseries_namerequiredorder_number+4 more

oblio_issue_invoice

Issue an invoice (fiscal, irreversible)

ISSUE a real INVOICE. This is a legal fiscal document: it takes the next number in the series at once, there is no draft state, it cannot be edited, and it can only be cancelled afterwards (it may also be sent to ANAF e-Factura / SPV, automatically if the account is set up so). Needs confirm: true, an idempotency_key, and the user's explicit approval of the exact client, lines, totals and series. Optionally base it on a proforma or notice (reference_document), record the payment at once (collect) or set the delivery date. Not retried: if the reply is an error, look in Oblio before repeating. Oblio never e-mails the client from this tool. POST /api/docs/invoice.

Parameterscifrequiredclientcollectconfirmcurrencydue_datelanguagementionsproductsprecisionuse_stockissue_date+10 more

oblio_collect_invoice

Record an invoice payment (collect)

Record that an issued invoice was paid (receipt, bank order, card...). Changes the invoice's paid status and is not reversible from the API. Needs confirm: true and the user's approval of the amount. Not retried. PUT /api/docs/invoice/collect.

Parameterscifrequirednumberrequiredcollectrequiredconfirmseries_namerequired

oblio_cancel_document

Cancel a document (fiscal)

CANCEL an invoice, proforma or notice. A cancelled invoice stays in the series but is void; if it was already sent to e-Factura / SPV, check the SPV side as well. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/cancel.

Parameterscifrequiredtyperequirednumberrequiredconfirmseries_namerequired

oblio_restore_document

Restore a cancelled document (fiscal)

Restore a previously CANCELLED invoice, proforma or notice. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/restore.

Parameterscifrequiredtyperequirednumberrequiredconfirmseries_namerequired

oblio_send_einvoice_to_spv

Send an invoice to e-Factura (SPV)

SEND an issued invoice to ANAF e-Factura (SPV). Irreversible: a document accepted by ANAF cannot be withdrawn from this API. Needs confirm: true and the user's approval. Not retried: check the status with oblio_list_invoices (with_einvoice_status) before repeating. Returns text, sent and a code (-1 not sent, 2 errors, 0 processing, 1 sent). POST /api/docs/einvoice.

Parameterscifrequirednumberrequiredconfirmseries_namerequired

oblio_create_webhook

Create a webhook

Subscribe an HTTPS endpoint to an Oblio event (stock changes, drafts/updates/cancellations of documents, collections). Oblio will POST account data to that URL, so only use an endpoint the user named and controls; it must answer 200 with the base64 of the X-Oblio-Request-Id header. Needs confirm: true. POST /api/webhooks.

Parameterscifrequiredtopicrequiredconfirmendpointrequired

oblio_delete_webhook

Delete a webhook

Delete a webhook subscription by id (from oblio_list_webhooks). Needs confirm: true. DELETE /api/webhooks/{id}.

Parametersidrequiredconfirm

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

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 8, 2026

Tiltify MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant read Tiltify campaigns, donations and top donor and fundraiser leaderboards.

Streamable HTTPWeb executable
Finance5 toolsNov 8, 2026

Termii MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Termii server that lets an assistant send SMS, check wallet balance, DND status, sender IDs and message history.

Streamable HTTPWeb executable
Communication & Collaboration5 toolsNov 8, 2026

Temp Stick MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server that lets an assistant read Temp Stick temperature and humidity sensors, their readings and alert notifications.

Streamable HTTPWeb executable
Location & Lifestyle4 toolsNov 8, 2026

Stibee MCP by usefulapi

io.usefulapiOfficial publisher

Connects an assistant to a Stibee email marketing workspace to read address books, subscribers and email stats, and to add subscribers and group members.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 8, 2026