Faktuo MCP by usefulapi
Create invoice, proforma, quote and credit-note PDFs in Faktuo.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"faktuo": {
"url": "https://faktuo.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://faktuo.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (2)
🟢faktuo_create_invoice_pdf(doc_type, doc_number, due_date, payment_method, variable_symbol, ...)
Generate an invoice, proforma, tax document for an advance, or quote as a PDF from the fields you send. Send the supplier and items; add a customer and doc_number as needed. Faktuo keeps no record: nothing appears in the Faktuo account and no number is assigned. Returns { filename, byteLength, pdfBase64, qr_status }. Faktuo API: POST /api/v1/pdf (Pro plan).
Eingabe-Schema
{
"type": "object",
"properties": {
"doc_type": {
"type": "string",
"enum": [
"invoice",
"proforma",
"proforma_tax",
"quote"
],
"description": "invoice = tax invoice; proforma = advance-payment request; proforma_tax = tax document for a received advance; quote = price offer (no payment QR)."
},
"doc_number": {
"description": "Document number, e.g. FA-26-04-001. Required for invoice and proforma_tax.",
"type": "string"
},
"due_date": {
"description": "Due date (default issue date + 14 days).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"payment_method": {
"description": "prevodem = bank transfer (default), hotove = cash, kartou = card.",
"type": "string",
"enum": [
"prevodem",
"hotove",
"kartou"
]
},
"variable_symbol": {
"description": "Variable symbol for the payment (default: the digits of doc_number). Not printed on credit notes.",
"type": "string"
},
"proforma_pct": {
"description": "Advance in percent. Only for proforma and proforma_tax.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"qr": {
"description": "Print a SPAYD QR payment code. Needs supplier.bank. CZK only.",
"type": "boolean"
},
"template": {
"description": "Layout. Default: the template set in Faktuo's settings.",
"type": "string",
"enum": [
"classic",
"minimal",
"monochrome",
"modern",
"elegant"
]
},
"language": {
"description": "Language of labels and headings (default cs). Your data keeps its own language.",
"type": "string",
"enum": [
"cs",
"en",
"sk",
"de"
]
},
"accent": {
"description": "Accent colour, e.g. #76c4a5.",
"type": "string",
"pattern": "^#[0-9A-Fa-f]{6}$"
},
"currency": {
"description": "Default CZK. A QR payment code is printed for CZK only.",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"issue_date": {
"description": "Issue date (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"duzp": {
"description": "Taxable supply date (default issue date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"vat_enabled": {
"description": "true when the supplier charges VAT.",
"type": "boolean"
},
"vat_rate": {
"description": "Default VAT rate in % when an item has none (default 21).",
"type": "number"
},
"reverse_charge": {
"description": "Reverse charge (§ 92a ZDPH).",
"type": "boolean"
},
"notes": {
"description": "Free text in the document footer.",
"type": "string",
"maxLength": 4000
},
"supplier": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Company or sole trader name."
},
"street": {
"type": "string"
},
"city": {
"type": "string"
},
"zip": {
"type": "string"
},
"ico": {
"description": "Company registration number (IČO).",
"type": "string"
},
"dic": {
"description": "VAT number (DIČ).",
"type": "string"
},
"bank": {
"description": "Bank account: 123-4567/0100, 19-123456789/0710 or an IBAN. Needed for a QR payment code.",
"type": "string"
},
"bic": {
"description": "BIC/SWIFT (optional).",
"type": "string"
},
"phone": {
"type": "string"
},
"email": {
"type": "string"
},
"is_vat_payer": {
"description": "true when the supplier is registered for VAT.",
"type": "boolean"
},
"entity_type": {
"description": "firma = company, osvc = sole trader. Changes the footer text.",
"type": "string",
"enum": [
"firma",
"osvc"
]
},
"court": {
"description": "Register entry (company) or registering authority (sole trader).",
"type": "string"
}
},
"required": [
"name"
],
"description": "The supplier (issuer) of the document."
},
"customer": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"street": {
"type": "string"
},
"city": {
"type": "string"
},
"zip": {
"type": "string"
},
"ico": {
"type": "string"
},
"dic": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"description": "The customer (recipient) of the document."
},
"items": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Item description."
},
"quantity": {
"type": "number"
},
"unit": {
"description": "Unit, e.g. ks, h, kg.",
"type": "string"
},
"price": {
"description": "Unit price without VAT.",
"type": "number"
},
"total": {
"description": "Line total without VAT. If omitted, quantity × price.",
"type": "number"
},
"vat_rate": {
"description": "VAT rate in % for this item only.",
"type": "number"
}
},
"required": [
"name"
]
},
"description": "Line items, 1 to 200."
}
},
"required": [
"doc_type",
"supplier",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢faktuo_create_credit_note_pdf(doc_number, corrects, template, language, accent, ...)
Generate a credit note (opravný doklad / storno) as a PDF that cancels one invoice. Send the original invoice's number in corrects and positive amounts; the PDF labels the total as 'to be refunded'. Faktuo keeps no record and links it to no invoice in the account. Returns { filename, byteLength, pdfBase64, qr_status }. Faktuo API: POST /api/v1/pdf (Pro plan).
Eingabe-Schema
{
"type": "object",
"properties": {
"doc_number": {
"type": "string",
"minLength": 1,
"description": "Number of this credit note. Required; the server does not number it."
},
"corrects": {
"type": "object",
"properties": {
"doc_number": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Number of the original invoice, exactly as printed on it."
},
"issue_date": {
"description": "Issue date of the original invoice.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reason": {
"description": "Reason for the correction, e.g. 'Withdrawal from the contract within 14 days'.",
"type": "string",
"maxLength": 500
}
},
"required": [
"doc_number"
],
"description": "The original invoice that this credit note corrects."
},
"template": {
"description": "Layout. Default: the template set in Faktuo's settings.",
"type": "string",
"enum": [
"classic",
"minimal",
"monochrome",
"modern",
"elegant"
]
},
"language": {
"description": "Language of labels and headings (default cs). Your data keeps its own language.",
"type": "string",
"enum": [
"cs",
"en",
"sk",
"de"
]
},
"accent": {
"description": "Accent colour, e.g. #76c4a5.",
"type": "string",
"pattern": "^#[0-9A-Fa-f]{6}$"
},
"currency": {
"description": "Default CZK. A QR payment code is printed for CZK only.",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"issue_date": {
"description": "Issue date (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"duzp": {
"description": "Taxable supply date (default issue date).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"vat_enabled": {
"description": "true when the supplier charges VAT.",
"type": "boolean"
},
"vat_rate": {
"description": "Default VAT rate in % when an item has none (default 21).",
"type": "number"
},
"reverse_charge": {
"description": "Reverse charge (§ 92a ZDPH).",
"type": "boolean"
},
"notes": {
"description": "Free text in the document footer.",
"type": "string",
"maxLength": 4000
},
"supplier": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Company or sole trader name."
},
"street": {
"type": "string"
},
"city": {
"type": "string"
},
"zip": {
"type": "string"
},
"ico": {
"description": "Company registration number (IČO).",
"type": "string"
},
"dic": {
"description": "VAT number (DIČ).",
"type": "string"
},
"bank": {
"description": "Bank account: 123-4567/0100, 19-123456789/0710 or an IBAN. Needed for a QR payment code.",
"type": "string"
},
"bic": {
"description": "BIC/SWIFT (optional).",
"type": "string"
},
"phone": {
"type": "string"
},
"email": {
"type": "string"
},
"is_vat_payer": {
"description": "true when the supplier is registered for VAT.",
"type": "boolean"
},
"entity_type": {
"description": "firma = company, osvc = sole trader. Changes the footer text.",
"type": "string",
"enum": [
"firma",
"osvc"
]
},
"court": {
"description": "Register entry (company) or registering authority (sole trader).",
"type": "string"
}
},
"required": [
"name"
],
"description": "The supplier (issuer) of the document."
},
"customer": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"street": {
"type": "string"
},
"city": {
"type": "string"
},
"zip": {
"type": "string"
},
"ico": {
"type": "string"
},
"dic": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"description": "The customer (recipient) of the document."
},
"items": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Item description."
},
"quantity": {
"type": "number"
},
"unit": {
"description": "Unit, e.g. ks, h, kg.",
"type": "string"
},
"price": {
"description": "Unit price without VAT, positive. Negative amounts are refused.",
"type": "number",
"minimum": 0
},
"total": {
"description": "Line total without VAT, positive. Negative amounts are refused.",
"type": "number",
"minimum": 0
},
"vat_rate": {
"description": "VAT rate in % for this item only.",
"type": "number"
}
},
"required": [
"name"
]
},
"description": "Line items, 1 to 200, with positive amounts."
}
},
"required": [
"doc_number",
"corrects",
"supplier",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis