Faktuo MCP by usefulapi
Create invoice, proforma, quote and credit-note PDFs in Faktuo.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"faktuo": {
"url": "https://faktuo.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://faktuo.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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"
}Comunidad
Evidencia