Faktuo MCP by usefulapi

Create invoice, proforma, quote and credit-note PDFs in Faktuo.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
100%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,270토큰 (도구 정의)
~11.9 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.77%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 2개