Faktuo MCP by usefulapi
Create invoice, proforma, quote and credit-note PDFs in Faktuo.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"faktuo": {
"url": "https://faktuo.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://faktuo.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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).
입력 스키마
{
"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).
입력 스키마
{
"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"
}커뮤니티
증거