Faktuo MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
100%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,270Tokens (Tool-Definitionen)
~11.9 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (1.77% von 128k Kontext)

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-http

Was es kann

Tool-Inventar

Tools (2)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet2 Tools