F
licenseNot graded
qualityB
maintenanceEnables read-only interaction with the FakturaXL API for querying invoices, clients, products, and stock levels with pagination, date chunking, and rate limiting.
-
Vyfakturuj MCP by usefulapi
by io.usefulapi
Server Details
Read and create Vyfakturuj invoices and contacts: search, number series, payment methods, tags.
If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
10 toolsvyfakturuj_create_contactCreate a contactDestructiveInspect
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/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| IC | No | ICO (company id). | |
| DIC | No | DIC (VAT id). | |
| tel | No | Phone. | |
| web | No | Web. | |
| zip | No | Postal code (PSC). | |
| city | No | City. | |
| name | No | Address-book name (how it is listed). | |
| note | No | Your note about the contact. | |
| street | No | Street. | |
| company | No | Company name. | |
| mail_to | No | E-mail where invoices and reminders go. | |
| days_due | No | Default days until due for this contact. | |
| lastname | No | Last name. | |
| firstname | No | First name. | |
| country_code | No | ISO 3166 country code, e.g. CZ, SK, DE. |
vyfakturuj_create_invoiceCreate an invoice (issues a real numbered document)DestructiveInspect
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_customer (an address-book contact, from vyfakturuj_list_contacts) or with the customer_* fields. Items need text and unit_price. Optional id_number_series / id_payment_method come from vyfakturuj_list_number_series / vyfakturuj_list_payment_methods; the account defaults apply otherwise. Prices are net unless calculate_vat is 2 (gross). POST /invoice/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| VS | No | Variable symbol (default: derived from the number). | |
| type | No | Document type: 1 faktura (default), 2 zalohova faktura, 4 proforma faktura, 8 vyzva k platbe, 512 objednavka. | |
| items | Yes | Document items (1-200). | |
| currency | No | Currency, ISO 4217 (default: the account's). | |
| days_due | No | Days until due (splatnost). | |
| language | No | Language of the document. | |
| customer_IC | No | Customer ICO (company id). | |
| id_customer | No | Address-book contact id (from vyfakturuj_list_contacts); fills the customer block. | |
| customer_DIC | No | Customer DIC (VAT id). | |
| customer_zip | No | Customer postal code (PSC). | |
| date_created | No | Issue date yyyy-mm-dd (default today). | |
| order_number | No | Order id / reference. | |
| calculate_vat | No | 1 items are net (VAT added), 2 items are gross, 3 special VAT regime, 4 domestic reverse charge, 5 not a VAT payer, 6 foreign reverse charge. | |
| customer_city | No | Customer city. | |
| customer_name | No | Customer company name (when no id_customer). | |
| note_internal | No | Internal note (not on the document). | |
| customer_street | No | Customer street. | |
| id_number_series | No | Number series id (from vyfakturuj_list_number_series); must match the document type. | |
| customer_lastname | No | Customer last name. | |
| id_payment_method | No | Payment method id (from vyfakturuj_list_payment_methods). | |
| text_before_items | No | Text before the items. | |
| customer_firstname | No | Customer first name. | |
| date_taxable_supply | No | Date of taxable supply (DUZP) yyyy-mm-dd. | |
| text_invoice_footer | No | Text in the footer. | |
| customer_country_code | No | ISO 3166 country code, e.g. CZ, SK, DE. |
vyfakturuj_get_contactGet a contactRead-onlyInspect
One address-book contact with every field (billing and delivery address, ICO/DIC, e-mails, default texts and days_due). GET /contact/{id}/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The contact id (from vyfakturuj_list_contacts). |
vyfakturuj_get_invoiceGet an invoiceRead-onlyInspect
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}/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The invoice id (from vyfakturuj_list_invoices). |
vyfakturuj_get_templateGet a recurring-invoice templateRead-onlyInspect
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}/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The template id. |
vyfakturuj_list_contactsList contactsRead-onlyInspect
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/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search. | |
| IC | No | Exact ICO (company id). | |
| DIC | No | Exact DIC (VAT id). | |
| tel | No | Phone number. | |
| name | No | Address-book name. | |
| sort | No | Sort: column~asc or column~desc, several joined by | (for example date_created~desc|number~asc). | |
| mail_to | No | E-mail address of the contact. | |
| rows_limit | No | Rows to return, 1-100 (default 25). | |
| rows_offset | No | Rows to skip (default 0). Use next_offset from the previous reply. |
vyfakturuj_list_invoicesList invoicesRead-onlyInspect
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, variable symbol (VS), currency or creation date range. Paged with rows_limit/rows_offset. GET /invoice/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search over the invoices. | |
| VS | No | Variable symbol (variabilni symbol). | |
| sort | No | Sort: column~asc or column~desc, several joined by | (for example date_created~desc|number~asc). | |
| type | No | Document type: 1 faktura, 2 zalohova faktura, 4 proforma, 8 vyzva k platbe, 16 danovy doklad, 32 opravny danovy doklad, 64 prijmovy doklad, 128 opravny doklad, 512 objednavka. | |
| number | No | Exact document number. | |
| currency | No | Currency, ISO 4217, e.g. CZK, EUR. | |
| rows_limit | No | Rows to return, 1-100 (default 25). | |
| id_customer | No | Only invoices of this address-book contact (from vyfakturuj_list_contacts). | |
| rows_offset | No | Rows to skip (default 0). Use next_offset from the previous reply. | |
| date_created_to | No | Created on or before this date (yyyy-mm-dd). | |
| date_created_from | No | Created on or after this date (yyyy-mm-dd). |
vyfakturuj_list_number_seriesList number seriesRead-onlyInspect
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/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
vyfakturuj_list_payment_methodsList payment methodsRead-onlyInspect
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/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
vyfakturuj_list_tagsList tagsRead-onlyInspect
The tags (stitky) of the account: id_tag, name and colour. Invoices carry an id_tag. GET /settings/tags/.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
10 tool updates
- First observed
vyfakturuj_create_contact - First observed
vyfakturuj_create_invoice - First observed
vyfakturuj_get_contact - First observed
vyfakturuj_get_invoice - First observed
vyfakturuj_get_template - First observed
vyfakturuj_list_contacts - First observed
vyfakturuj_list_invoices - First observed
vyfakturuj_list_number_series - First observed
vyfakturuj_list_payment_methods - First observed
vyfakturuj_list_tags
Related MCP Connectors
Read SuperFaktura invoices, clients, expenses, bank and stock; create clients, expenses and drafts.
1Read Lexware Office contacts, articles, invoices and vouchers; create contacts and draft invoices.
211Read Invoiced customers, invoices, payments, subscriptions; create customers, draft invoices, notes.
271Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices.
341
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables read-only querying of Invoice4U accounting data, including documents, customers, branches, tax rates, and Israeli invoice allocation statuses.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the SuperFaktura invoicing system for managing invoices, clients, and expenses via natural language.2Apache 2.0
- FlicenseCqualityDmaintenanceConnects to ABRA Flexi over its REST API to read companies, evidence, partners, products, balances, and overdue items, while supporting guarded write flows with validation and audit logging.29-
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd
Glama MCP Gateway
Add one secure layer between your agents and this server.