# SuperFaktura MCP by usefulapi (remote · superfaktura.usefulapi.io)

Read SuperFaktura invoices, clients, expenses, bank and stock; create clients, expenses and drafts.

- Trust score: 18/100 (low)
- Change this week: −51
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `superfaktura.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura.md), [page](https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura)

## Channel facts

- Endpoint: `https://superfaktura.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.22.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the SuperFaktura MCP by usefulapi server?

SuperFaktura MCP by usefulapi is a hosted endpoint at https://superfaktura.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-superfaktura 'https://superfaktura.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-superfaktura": {
      "url": "https://superfaktura.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-superfaktura": {
      "type": "http",
      "url": "https://superfaktura.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-superfaktura]
url = "https://superfaktura.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-superfaktura": {
      "type": "remote",
      "url": "https://superfaktura.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-superfaktura --url 'https://superfaktura.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-superfaktura:
    url: "https://superfaktura.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-superfaktura": {
      "Transport": "http",
      "Url": "https://superfaktura.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-superfaktura -t streamable-http -u 'https://superfaktura.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-superfaktura": {
      "type": "http",
      "url": "https://superfaktura.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-02 (score 18, −56)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.67 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-11-01 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 73, +3)

- [security improvement] Authorization: partial → pass
- [functional improvement] MCP protocol: fail → pass
- [functional] New prompt “add_a_client_with_a_contact_person”
- [functional] New prompt “check_bank_moves_and_cash_register_balances”
- [functional] New prompt “check_stock_items_and_their_movements”
- [functional] New prompt “find_invoices_that_are_still_unpaid”
- [functional] New prompt “record_an_expense_or_prepare_a_draft_invoice”
- [functional] New prompt “review_the_expenses_you_recorded”
- [functional] MCP protocol version: 2025-06-18 → 2025-11-25
- [functional] Server version: 1.18.0 → 1.20.0
- [functional] Server version: 1.17.0 → 1.18.0
- [functional] Server version: 1.16.2 → 1.17.0

### 2026-10-30 (score 70, +1)

- [functional] Server version: 1.16.1 → 1.16.2
- [functional] Server version: 1.16.0 → 1.16.1

### 2026-10-29 (score 69, 0)

- [functional] Server version: 1.15.0 → 1.16.0
- [functional] Server version: 1.14.0 → 1.15.0

### 2026-10-28 (score 69, +1)

- [functional] Server version: 1.12.0 → 1.14.0

### 2026-10-27 (score 68, 0)

- [functional] Server version: 1.11.0 → 1.12.0

### 2026-10-26 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (25)

### `superfaktura_get_company` (~140 tokens)

Get the company profile and API limits

The company the API key is working in (name, IČO, DIČ, IČ DPH, address, VAT-payer flag, bank accounts) and the remaining API quota (SuperFaktura's fair-use policy is 1000 requests per day and 31000 per month; every tool call here uses one request). Good first call. With all_companies=true also the other companies the user can access (their ids are the company_id of the login). GET /users/getUserCompaniesData.

Input parameters:

- `all_companies` (boolean): true = every company the user has access to, not only the current one.

### `superfaktura_list_invoices` (~392 tokens)

List or search invoices

List issued documents with client, items, totals and payment status. type selects the document kind (default regular = ordinary invoices; also proforma, estimate = quote, order, cancel = credit note, delivery, draft, reverse_order; several allowed). Without a date filter SuperFaktura returns only the CURRENT YEAR; use created_period='all' or a date range for older ones. status: issued, partially_paid, paid, overdue. search matches client name, number, VS ... Paged: pass next_page as page. GET /invoices/index.json.

Input parameters:

- `amount_from` (number): Minimum amount.
- `amount_to` (number): Maximum amount.
- `client_id` (integer): Only documents of this client (superfaktura_list_clients).
- `created_period` (string): Issue date as a period (default this_year when no date filter is given).
- `created_since` (string): Issued on or after (yyyy-mm-dd).
- `created_to` (string): Issued on or before (yyyy-mm-dd).
- `direction` (string): Sort direction (default DESC).
- `invoice_no` (string): Formatted document number, e.g. 2026001.
- `modified_period` (string): Last changed in this period.
- `order_no` (string): Order number the document was created from.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `per_page` (integer): Results per page, 1-100 (the account's profile default when omitted).
- `search` (string): Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records).
- `status` (string): Payment status.
- `type` (array): Document types (default: regular).
- `variable` (string): Variable symbol.

### `superfaktura_get_invoice` (~97 tokens)

Get an invoice

One document (invoice, proforma, quote ...) with its header (number, dates, status, amounts, currency, symbols, comments), client, items, VAT summary, payments and related documents. The public access token and payment links of the document are not returned. GET /invoices/view/{id}.json.

Input parameters:

- `invoice_id` (integer, required): Invoice id (the id of a superfaktura_list_invoices row).

### `superfaktura_list_clients` (~187 tokens)

List or search clients

List the address book (clients and suppliers) with contact data and totals. search matches name, IČO, DIČ, IČ DPH, bank account, e-mail, address, city, phone, note and tags. Paged: pass next_page as page. GET /clients/index.json.

Input parameters:

- `created_period` (string): Created in this period.
- `direction` (string): Sort direction (default DESC).
- `modified_period` (string): Changed in this period.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `per_page` (integer): Results per page, 1-100 (the account's profile default when omitted).
- `search` (string): Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records).

### `superfaktura_get_client` (~56 tokens)

Get a client

One client with address, tax ids, bank data, default currency/due days/discount and statistics. GET /clients/view/{id}.

Input parameters:

- `client_id` (integer, required): Client id (from superfaktura_list_clients).

### `superfaktura_list_contact_persons` (~50 tokens)

List a client's contact persons

The contact persons (name, e-mail, phone) stored for one client. GET /contact_people/getContactPeople/{client_id}.

Input parameters:

- `client_id` (integer, required): Client id.

### `superfaktura_list_expenses` (~299 tokens)

List or search expenses

List received documents (expenses: received invoices, bills, internal documents) with amounts, VAT, supplier and payment status. status: issued (new), partially_paid, paid, overdue. Without a date filter SuperFaktura applies its default period; pass created_period='all' for everything. Paged: pass next_page as page. GET /expenses/index.json.

Input parameters:

- `amount_from` (number)
- `amount_to` (number)
- `category_id` (integer): Expense category id (superfaktura_list_expense_categories).
- `client_id` (integer): Supplier (client) id.
- `created_period` (string): Issue date as a period.
- `created_since` (string): Issued on or after (yyyy-mm-dd).
- `created_to` (string): Issued on or before (yyyy-mm-dd).
- `direction` (string): Sort direction (default DESC).
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `per_page` (integer): Results per page, 1-100 (the account's profile default when omitted).
- `search` (string): Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records).
- `status` (string): Payment status.
- `type` (string): Expense type (note the vendor's spelling recieved_credit_note).

### `superfaktura_get_expense` (~58 tokens)

Get an expense

One expense with its items, VAT rates, payments and supplier. Attachments are not returned. GET /expenses/view/{id}.json.

Input parameters:

- `expense_id` (integer, required): Expense id (from superfaktura_list_expenses).

### `superfaktura_list_expense_categories` (~38 tokens)

List expense categories

The expense category tree (id, name, parent) for the category_id of expenses. GET /expenses/expense_categories.

### `superfaktura_list_bank_accounts` (~42 tokens)

List bank accounts

The company's bank accounts as stored in SuperFaktura (bank name, IBAN, SWIFT, default flag). GET /bank_accounts/index.

### `superfaktura_list_bank_moves` (~230 tokens)

List imported bank account moves

Bank transactions imported into SuperFaktura (date, amount, currency, variable symbol, counter account, matching state), newest first by default. Filter by date range, credit/debit or amount. Paged: pass next_page as page. GET /accounts/index.json.

Input parameters:

- `amount_from` (number)
- `amount_to` (number)
- `date_period` (string): Transaction date as a period.
- `date_since` (string): Transactions on or after (yyyy-mm-dd).
- `date_to` (string): Transactions on or before (yyyy-mm-dd).
- `direction` (string): Sort direction.
- `move_type` (string): credit = incoming, debit = outgoing.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `per_page` (integer): Results per page, 1-100 (the account's profile default when omitted).
- `search` (string): Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records).

### `superfaktura_list_cash_registers` (~38 tokens)

List cash registers

The company's cash registers with currency, number of entries and current balance (read only). GET /cash_registers/getDetails.

### `superfaktura_get_cash_register` (~58 tokens)

Get a cash register

One cash register with currency, number of entries and current balance (read only). GET /cash_registers/view/{id}.

Input parameters:

- `cash_register_id` (integer, required): Cash register id (from superfaktura_list_cash_registers).

### `superfaktura_list_stock_items` (~189 tokens)

List or search stock items

List warehouse items (name, SKU, unit, price, VAT, quantity in stock). search matches name, SKU and description; sku matches the SKU. Paged: pass next_page as page. GET /stock_items/index.json.

Input parameters:

- `direction` (string): Sort direction.
- `in_stock_only` (boolean): true = only items that are in stock.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `per_page` (integer): Results per page, 1-100 (the account's profile default when omitted).
- `price_from` (number)
- `price_to` (number)
- `search` (string): Text to search for (matched by SuperFaktura in names, numbers, e-mails ... of the records).
- `sku` (string): Search by SKU.

### `superfaktura_get_stock_item` (~57 tokens)

Get a stock item

One warehouse item with SKU, price, VAT, purchase price and quantity in stock. GET /stock_items/view/{id}.

Input parameters:

- `stock_item_id` (integer, required): Stock item id (from superfaktura_list_stock_items).

### `superfaktura_list_stock_movements` (~122 tokens)

List stock movements of an item

The stock log of one item (quantity changes, notes, related invoice or expense). Paged: pass next_page as page. GET /stock_items/movements/{id}.

Input parameters:

- `direction` (string): Sort direction (default ASC).
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `per_page` (integer): Results per page, 1-100 (the account's profile default when omitted).
- `stock_item_id` (integer, required): Stock item id.

### `superfaktura_list_tags` (~32 tokens)

List tags

The tags (id and name) usable on invoices, expenses and clients. GET /tags/index.json.

### `superfaktura_list_sequences` (~47 tokens)

List numbering sequences

The document numbering sequences per document type (id, name, mask, next formatted number, default flag); sequence ids are used when creating documents. GET /sequences/index.json.

### `superfaktura_list_countries` (~42 tokens)

List countries

SuperFaktura's country ids with ISO code and EU flag, for the country_id of clients. GET /countries/index/view_full:1.

### `superfaktura_get_response_by_checksum` (~80 tokens)

Recover the reply of a create by its checksum

If a superfaktura_create_invoice call timed out, fetch the reply of the ORIGINAL request by the checksum it was sent with (kept 3 months), so the document is not created twice. GET /api_logs/getResponseByChecksum/{checksum}.

Input parameters:

- `checksum` (string, required): The checksum given to superfaktura_create_invoice.

### `superfaktura_create_client` (~236 tokens)

Create a client

WRITE: adds a new client to the SuperFaktura address book (only the name is required). Nothing is sent to the client. Not idempotent: calling twice creates two clients, so check superfaktura_list_clients first. POST /clients/create.

Input parameters:

- `address` (string): Street and number.
- `city` (string)
- `comment` (string): Internal note on the client.
- `country_id` (integer): Country id (superfaktura_list_countries); Slovakia is 191. Defaults to the instance's country.
- `dic` (string): Tax id (DIČ, Slovak).
- `email` (string): Client e-mail (stored only; nothing is sent to it).
- `iban` (string)
- `ic_dph` (string): VAT id (IČ DPH in Slovakia, DIČ in the Czech Republic).
- `ico` (string): Company id (IČO).
- `name` (string, required): Client name (company or person).
- `phone` (string)
- `swift` (string)
- `zip` (string)

### `superfaktura_add_contact_person` (~95 tokens)

Add a contact person to a client

WRITE: adds a contact person (name and e-mail, optional phone) to an existing client. Nothing is sent to that person. Not idempotent. POST /contact_people/add/api:1.

Input parameters:

- `client_id` (integer, required): Existing client id.
- `email` (string, required): Contact person's e-mail (stored only).
- `name` (string, required): Contact person's name.
- `phone` (string)

### `superfaktura_create_tag` (~59 tokens)

Create a tag

WRITE: adds a new tag name (usable on invoices, expenses and clients in the SuperFaktura app). A duplicate name is refused by SuperFaktura. POST /tags/add.

Input parameters:

- `name` (string, required): Tag name.

### `superfaktura_create_expense` (~250 tokens)

Record a received expense

WRITE: records a received document (expense) with ONE total amount and VAT rate, e.g. a supplier invoice or a bill. It is created unpaid: no payment is recorded and nothing is sent. No attachments. Not idempotent: calling twice records two expenses. POST /expenses/add.

Input parameters:

- `amount` (number, required): Amount WITHOUT VAT.
- `category_id` (integer): Expense category id from superfaktura_list_expense_categories.
- `client_id` (integer): Supplier (client) id from superfaktura_list_clients.
- `comment` (string): Comment.
- `created` (string): Issue date (default today).
- `currency` (string): 3-letter currency code, e.g. EUR, CZK.
- `delivery` (string): Delivery date (default today).
- `document_number` (string): The supplier's document number.
- `due` (string): Due date (default today).
- `name` (string, required): Expense name / what it is for.
- `type` (string): Expense type (default invoice = received invoice).
- `variable` (string): Variable symbol.
- `vat` (number): VAT rate in percent (default 0).

### `superfaktura_create_invoice` (~603 tokens)

Create an unsent invoice document

WRITE: creates ONE document in SuperFaktura for the user to review: type draft (concept, default), estimate (quote), order or proforma. A final regular invoice cannot be created here. It is NOT sent (no e-mail, no post), NOT marked paid or sent, and has no payment link or discount. Give an existing client_id (its name is read first with one extra GET /clients/view/{id}, so the call uses 2 requests of the daily quota) OR a new client's name (+ optional ico/dic/ic_dph/address...). Items: name, unit price without VAT, VAT rate, quantity. Not idempotent: pass a checksum (max 32 chars) so a timed-out call can be recovered with superfaktura_get_response_by_checksum instead of retried. POST /invoices/create.

Input parameters:

- `checksum` (string): Your own unique token (max 32 chars) to recover the reply if the call times out.
- `client_address` (string): Client street and number, with client_name.
- `client_city` (string): Client city, with client_name.
- `client_country_id` (integer): Client country id (superfaktura_list_countries), with client_name.
- `client_dic` (string): Client tax id (DIČ), with client_name.
- `client_email` (string): Client e-mail, with client_name (stored only; nothing is sent).
- `client_ic_dph` (string): Client VAT id, with client_name.
- `client_ico` (string): Client company id (IČO), with client_name.
- `client_id` (integer): Existing client id (superfaktura_list_clients). Give this OR client_name.
- `client_name` (string): Name of a new/matching client (used when client_id is not given).
- `client_zip` (string): Client ZIP, with client_name.
- `comment` (string): Comment on the document.
- `constant` (string): Constant symbol.
- `created` (string): Issue date (default today).
- `delivery` (string): Delivery date.
- `due` (string): Due date.
- `header_comment` (string): Comment above the items (shown on the document).
- `internal_comment` (string): Internal comment (not shown on the document).
- `invoice_currency` (string): 3-letter currency code, e.g. EUR, CZK.
- `items` (array, required): 1-100 items.
- `name` (string): Document title (default generated from the number).
- `order_no` (string): Order number.
- `sequence_id` (integer): Numbering sequence id (superfaktura_list_sequences).
- `specific` (string): Specific symbol.
- `type` (string): Document type: draft (default), estimate, order or proforma.
- `variable` (string): Variable symbol (the document number when empty).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura#diagnostics

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 74
- 2026-10-31: 73
- 2026-10-30: 70
- 2026-10-29: 69
- 2026-10-28: 69
- 2026-10-27: 68
- 2026-10-26: 68
- 2026-10-25: 67
- 2026-10-24: 67
- 2026-10-23: 67
- 2026-10-22: 66
- 2026-10-21: 66
- 2026-10-20: 65
- 2026-10-19: 65
- 2026-10-18: 64
- 2026-10-17: 64
- 2026-10-16: 63
- 2026-10-15: 63
- 2026-10-14: 62
- 2026-10-13: 60
- 2026-10-12: 59

## Common questions

### What is the SuperFaktura MCP by usefulapi server?

SuperFaktura MCP by usefulapi is listed in the public MCP registry as io.usefulapi/superfaktura. Read SuperFaktura invoices, clients, expenses, bank and stock; create clients, expenses and drafts. This page covers its hosted endpoint (https://superfaktura.usefulapi.io/mcp).

### Is the SuperFaktura MCP by usefulapi server safe to use?

SuperFaktura MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the SuperFaktura MCP by usefulapi server expose?

SuperFaktura MCP by usefulapi exposes 25 tools: superfaktura_get_company, superfaktura_list_invoices, superfaktura_get_invoice, superfaktura_list_clients, superfaktura_get_client, and 20 more. Their descriptions and schemas cost roughly 3,497 tokens of context every time the server is loaded.

### Does the SuperFaktura MCP by usefulapi server require authentication?

Its publisher declares no required credentials for SuperFaktura MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.

### Is the SuperFaktura MCP by usefulapi server still maintained?

SuperFaktura MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the SuperFaktura MCP by usefulapi server?

VerifyMCP ran 4 checks on SuperFaktura MCP by usefulapi, covering TLS certificate, HSTS header, DNSSEC and Transport. 7 items could not be completed, a gap on our side rather than a finding about SuperFaktura MCP by usefulapi: Authorization, HTTPS, Schema quality, Stability and 3 more. 5 categories score 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://superfaktura.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/superfaktura/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-superfaktura/superfaktura