# Vyfakturuj MCP by usefulapi

> Vyfakturuj MCP by usefulapi is an MCP server. Read and create Vyfakturuj invoices and contacts: search, number series, payment methods, tags. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/vyfakturuj/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/vyfakturuj
- **MCP Registry name:** io.usefulapi/vyfakturuj
- **Listing updated:** 2026-11-13

## About

Read and create Vyfakturuj invoices and contacts: search, number series, payment methods, tags.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vyfakturuj https://vyfakturuj.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://vyfakturuj.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vyfakturuj": {
      "serverUrl": "https://vyfakturuj.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `vyfakturuj_list_invoices`: Search documents (faktury, zalohove faktury, proformy, objednavky ...); pass sort=date_created~desc for the newest first. Each row has id, number, type, dates, customer, VS, currency, total, flags and flags_decoded (paid, sent_to_customer, cancelled, ...) and the public/PDF URLs; use vyfakturuj_get_invoice for the whole document with items. Filter by free text q, customer id, document type, number
- `vyfakturuj_get_invoice`: One document with all fields: supplier and customer blocks, items (text, quantity, unit_price, vat_rate, totals), dates, VS, bank details, total, flags and flags_decoded, payment method, public page, PDF and online-payment URLs. GET /invoice/{id}/.
- `vyfakturuj_create_invoice`: WRITE. Creates a document in Vyfakturuj. Vyfakturuj has NO draft state: the document is issued at once and takes the next number of its number series (delete or cancel it in Vyfakturuj if wrong). Does NOT send an e-mail to the customer, does NOT mark it paid and moves no money; automatic reminders and paid notices are switched off for it (disable_automated_mails). Name the customer with id_custome
- `vyfakturuj_list_contacts`: Search the address book (adresar): id, name, company, ICO (IC), DIC, address, e-mail (mail_to), phone, default days_due. Filter by free text q, ICO, DIC, name, e-mail or phone. Paged with rows_limit/rows_offset. GET /contact/.
- `vyfakturuj_get_contact`: One address-book contact with every field (billing and delivery address, ICO/DIC, e-mails, default texts and days_due). GET /contact/{id}/.
- `vyfakturuj_create_contact`: WRITE. Adds a contact to the address book (it is not a customer message: nothing is sent). Give at least a name (the address-book label) or company or last name. Returns the new contact with its id. POST /contact/.
- `vyfakturuj_get_template`: One template / recurring invoice (sablona, pravidelna faktura) by id: its items, customer, schedule and settings. The API has no list endpoint for templates, so the id comes from the user (the number in the template's URL in Vyfakturuj). GET /template/{id}/.
- `vyfakturuj_list_payment_methods`: The payment methods of the account (id_payment_method, name, type: 1 bank transfer, 2 cash, 4 cash on delivery, 8 card, ...). Use the id in vyfakturuj_create_invoice. GET /settings/payment-method/.
- `vyfakturuj_list_number_series`: The numbering series (ciselne rady) of the account: id_number_series, the document type it is for, name and the number pattern. Use the id in vyfakturuj_create_invoice. GET /settings/number-series/.
- `vyfakturuj_list_tags`: The tags (stitky) of the account: id_tag, name and colour. Invoices carry an id_tag. GET /settings/tags/.

## FAQ

### How do I add Vyfakturuj MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http vyfakturuj https://vyfakturuj.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/vyfakturuj-mcp-by-usefulapi
