About Oblio MCP by usefulapi
Oblio MCP by usefulapi is a hosted MCP server that lets clients such as Claude and Cursor read business data and documents in Oblio and perform invoice operations. Fiscal writes, including issuing, collecting, cancelling, and sending e-invoices, require explicit confirmation.
Key features
- 01Read company, client, and product data
- 02View invoices, stock, and e-Factura status
- 03Create proformas and issue invoices
- 04Collect, cancel, or restore documents
- 05Send e-invoices to SPV
Use cases
- 01Look up clients, products, and stock
- 02Check invoice and e-Factura status
- 03Perform invoice and payment operations with confirmation
MCP support
The remote MCP server exposes Oblio read and write tools to clients. OAuth login uses the user's own Oblio credentials; each fiscal write requires explicit confirmation.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://oblio.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-oblio https://oblio.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-oblio":{"type":"http","url":"https://oblio.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-oblio":{"type":"http","url":"https://oblio.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-oblio":{"type":"http","url":"https://oblio.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-oblio":{"serverUrl":"https://oblio.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
18This tool takes no parameters.
Details
From the project READMEOblio 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/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"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
| Tool | Type | What it does |
|---|---|---|
oblio_list_companies | read | List companies |
oblio_list_vat_rates | read | List VAT rates |
oblio_list_series | read | List document series |
oblio_list_languages | read | List document languages |
oblio_list_management | read | List stock managements |
oblio_list_clients | read | List or search clients |
oblio_list_products | read | List or search products |
oblio_get_document | read | Get a document |
oblio_list_invoices | read | List invoices |
oblio_list_webhooks | read | List webhooks |
oblio_create_proforma | write | Create a proforma |
oblio_issue_invoice | write | Issue an invoice (fiscal, irreversible) |
oblio_collect_invoice | write | Record an invoice payment (collect) |
oblio_cancel_document | write | Cancel a document (fiscal) |
oblio_restore_document | write | Restore a cancelled document (fiscal) |
oblio_send_einvoice_to_spv | write | Send an invoice to e-Factura (SPV) |
oblio_create_webhook | write | Create a webhook |
oblio_delete_webhook | write | Delete a webhook |
oblio_usage_status | meta | Usage status (free-tier meter) |
oblio_request_feature | meta | Request a missing feature |
oblio_upgrade | meta | Upgrade to Pro (unlimited) |
oblio_cancel_subscription | meta | Cancel 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
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per user) | $9/mo or $90/yr (2 months free) | Unlimited |
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.