Számlázz.hu MCP by usefulapi

Read the data of one issued invoice (seller, buyer, lines, totals, VAT breakdown, payments) by invoice number, order number or your external id (give exactly one; for an order number with several invoices the last one is returned). Only invoices issued in this Számlázz.hu account. Also use it to check whether an invoice exists before issuing again. Számla Agent action-szamla_agent_xml.

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "description": "Invoice number, e.g. E-TST-2026-1.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "order_number": {
      "description": "The order number given when the invoice was created.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "external_id": {
      "description": "The external id (szamlaKulsoAzon) given when the invoice was created.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Download the PDF of one issued document (invoice, pro forma, ...) by invoice number, order number or your external id (give exactly one). Returns the totals and the PDF as an embedded resource. Számla Agent action-szamla_agent_pdf.

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "description": "Invoice number, e.g. E-TST-2026-1.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "order_number": {
      "description": "The order number given when the document was created.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "external_id": {
      "description": "The external id given when the document was created.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look up a Hungarian taxpayer in the NAV register by the first 8 digits of the tax number (the törzsszám): whether the number is valid, the taxpayer's name, VAT status and addresses. Számla Agent action-szamla_agent_taxpayer (data from the NAV Online Invoice platform).

{
  "type": "object",
  "properties": {
    "tax_number": {
      "type": "string",
      "pattern": "^\\d{8}$",
      "description": "The first 8 digits of the Hungarian tax number, e.g. 13421739."
    }
  },
  "required": [
    "tax_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Read one issued receipt (nyugta) by receipt number: lines, payments, totals, whether it was reversed. Optionally the PDF. Számla Agent action-szamla_agent_nyugta_get.

{
  "type": "object",
  "properties": {
    "receipt_number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Receipt number, e.g. NYGTA-2026-1."
    },
    "pdf": {
      "description": "Also return the receipt PDF (default false).",
      "type": "boolean"
    }
  },
  "required": [
    "receipt_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

ISSUES a real invoice in Számlázz.hu. A final invoice is reported to NAV (Online Számla) and can only be cancelled by a reversal (szamlazz_reverse_invoice), never deleted. kind: invoice (default), proforma (díjbekérő; not fiscal, can be deleted with szamlazz_delete_proforma), prepayment (előlegszámla). The tool computes net, VAT and gross of every line from net_unit_price and vat_rate. preview true builds the PDF only and creates NO document (check the reply: a returned invoice_number means a document WAS created). This call is NEVER retried: if the result is unclear, look the invoice up (szamlazz_get_invoice by order_number or external_id) before issuing again; always send external_id or order_number so that you can. Setting send_email_to_buyer e-mails the PDF to the buyer. Számla Agent action-xmlagentxmlfile.

{
  "type": "object",
  "properties": {
    "kind": {
      "description": "invoice (default), proforma (non-fiscal payment request) or prepayment (down-payment invoice).",
      "type": "string",
      "enum": [
        "invoice",
        "proforma",
        "prepayment"
      ]
    },
    "preview": {
      "description": "true = only return a preview PDF, create no document.",
      "type": "boolean"
    },
    "fulfillment_date": {
      "type": "string",
      "description": "Date of delivery / service (teljesítés), yyyy-mm-dd."
    },
    "due_date": {
      "type": "string",
      "description": "Payment due date, yyyy-mm-dd."
    },
    "issue_date": {
      "description": "Issue date, yyyy-mm-dd (default: today).",
      "type": "string"
    },
    "payment_method": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Payment method text, e.g. Átutalás (bank transfer), Készpénz (cash), Bankkártya (card)."
    },
    "currency": {
      "description": "Currency code (default HUF). Not HUF: exchange_rate_bank and exchange_rate are required.",
      "type": "string",
      "pattern": "^[A-Za-z]{2,3}$"
    },
    "exchange_rate_bank": {
      "description": "Bank of the exchange rate, e.g. MNB (foreign currency only).",
      "type": "string",
      "minLength": 1,
      "maxLength": 30
    },
    "exchange_rate": {
      "description": "Exchange rate, HUF per 1 unit of the currency (foreign currency only).",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000
    },
    "language": {
      "description": "Language of the invoice (default hu).",
      "type": "string",
      "enum": [
        "hu",
        "en",
        "de",
        "it",
        "ro",
        "sk",
        "hr",
        "fr",
        "es",
        "cz",
        "pl",
        "bg",
        "nl",
        "ru",
        "si"
      ]
    },
    "comment": {
      "description": "Comment printed on the invoice.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "order_number": {
      "description": "Order number; also usable to find the invoice later. The account may forbid repeating an order number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "external_id": {
      "description": "Your own id for the invoice (szamlaKulsoAzon); lets you query it later.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "prefix": {
      "description": "Invoice number prefix; must be registered in the account (Beállítások → Előtagok).",
      "type": "string",
      "minLength": 1,
      "maxLength": 30
    },
    "paid": {
      "description": "Mark the invoice as already paid.",
      "type": "boolean"
    },
    "e_invoice": {
      "description": "Issue an e-invoice (electronically signed). Default false; needs the e-invoice feature, else error 54.",
      "type": "boolean"
    },
    "buyer_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Buyer name."
    },
    "buyer_country": {
      "description": "Buyer country name (default Magyarország).",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "buyer_postal_code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "description": "Buyer postal code."
    },
    "buyer_city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Buyer city."
    },
    "buyer_address": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Buyer street address."
    },
    "buyer_email": {
      "description": "Buyer e-mail address.",
      "type": "string",
      "maxLength": 254,
      "pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
    },
    "buyer_tax_number": {
      "description": "Hungarian tax number of a business buyer, e.g. 12345678-1-42. Not allowed on new-KATA accounts with protection on (error 491).",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "buyer_eu_tax_number": {
      "description": "EU VAT number of the buyer.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "buyer_phone": {
      "description": "Buyer phone.",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "buyer_comment": {
      "description": "Note about the buyer.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "send_email_to_buyer": {
      "description": "E-mail the invoice to buyer_email (default false).",
      "type": "boolean"
    },
    "email_reply_to": {
      "description": "Reply-to address of that e-mail.",
      "type": "string",
      "maxLength": 254,
      "pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
    },
    "email_subject": {
      "description": "Subject of that e-mail.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "email_body": {
      "description": "Text of that e-mail.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "lines": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "Line item name."
          },
          "quantity": {
            "type": "number",
            "minimum": 0.0001,
            "maximum": 1000000000,
            "description": "Quantity (up to 4 decimals are meaningful)."
          },
          "unit": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "Unit of the quantity, e.g. db (pieces), óra (hours), kg."
          },
          "net_unit_price": {
            "type": "number",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "NET price of one unit in the document's currency (may have decimals; in HUF the line totals are rounded to whole forints)."
          },
          "vat_rate": {
            "description": "VAT rate in percent as a number or text (27, 18, 5, 0), or a VAT code: AAM (VAT-exempt person), TAM (exempt supply), TAHK, EUT, EUKT, F.AFA (reverse charge), K.AFA, ... A code means no VAT amount.",
            "type": [
              "string",
              "number"
            ]
          },
          "comment": {
            "description": "Optional note printed on the line.",
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          }
        },
        "required": [
          "name",
          "quantity",
          "unit",
          "net_unit_price",
          "vat_rate"
        ]
      },
      "description": "Invoice lines."
    }
  },
  "required": [
    "fulfillment_date",
    "due_date",
    "payment_method",
    "buyer_name",
    "buyer_postal_code",
    "buyer_city",
    "buyer_address",
    "lines"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

ISSUES a reversal (storno) invoice that cancels one issued invoice. Fiscal: it is reported to NAV and cannot be undone; the original stays in the books. A reversal needs the invoice number of a real invoice. NEVER retried: if the result is unclear, check with szamlazz_get_invoice before trying again. Számla Agent action-szamla_agent_st.

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Number of the invoice to reverse."
    },
    "issue_date": {
      "description": "Issue date of the reversal, yyyy-mm-dd (default: today).",
      "type": "string"
    },
    "reason": {
      "description": "Reason, printed on the reversal.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "e_invoice": {
      "description": "Issue the reversal as an e-invoice (default false).",
      "type": "boolean"
    }
  },
  "required": [
    "invoice_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

DELETES one pro forma invoice (díjbekérő) by its number or by its order number (give exactly one). Only pro forma invoices can be deleted; a real invoice is never touched (use szamlazz_reverse_invoice). Cannot be undone. Számla Agent action-szamla_agent_dijbekero_torlese.

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "description": "Number of the pro forma invoice, e.g. D-2026-12.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "order_number": {
      "description": "Order number of the pro forma invoice.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Records 1-5 payments (kifizetés) on one of your own issued invoices or pro forma invoices, which updates its paid amount and outstanding balance. By default the payments are ADDED to the existing ones; replace_existing true REPLACES all earlier payment entries of the invoice. Not fiscal. Számla Agent action-szamla_agent_kifiz.

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Number of your own issued invoice or pro forma invoice."
    },
    "payments": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "Payment date, yyyy-mm-dd."
          },
          "method": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Payment type text, e.g. átutalás (transfer), készpénz (cash)."
          },
          "amount": {
            "type": "number",
            "minimum": -1000000000000,
            "maximum": 1000000000000,
            "description": "Amount paid in the invoice's currency (rounded half up: whole forints in HUF, 2 decimals otherwise)."
          },
          "description": {
            "description": "Optional description.",
            "type": "string",
            "minLength": 1,
            "maxLength": 256
          }
        },
        "required": [
          "date",
          "method",
          "amount"
        ]
      },
      "description": "The payments (1 to 5)."
    },
    "replace_existing": {
      "description": "true = replace all earlier payment entries instead of adding (default false).",
      "type": "boolean"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{2,3}$",
      "description": "REQUIRED: the invoice's currency (HUF, EUR, ...). Amounts are rounded to whole forints in HUF and to 2 decimals otherwise, so a wrong currency books a wrong amount."
    }
  },
  "required": [
    "invoice_number",
    "payments",
    "currency"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

ISSUES a real HUF receipt (nyugta). Receipts are fiscal (NAV reporting) and can only be cancelled by szamlazz_reverse_receipt, never deleted. Give each line's whole-forint gross_total and vat_rate: the tool derives net, VAT and unit price (net + VAT equals gross exactly, as the vendor demands). The receipt prefix must be a receipt-only prefix (capital letters and digits, e.g. NYGTA), not an invoice prefix. call_id is required: the vendor refuses a second receipt with the same call_id (error 338), which protects against a duplicate. NEVER retried automatically: if the result is unclear, ask the user, then repeat the call with the SAME call_id (error 338 means the receipt already exists; find it in Számlázz.hu). Számla Agent action-szamla_agent_nyugta_create.

{
  "type": "object",
  "properties": {
    "prefix": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}$",
      "description": "Receipt number prefix, capital letters and digits only, e.g. NYGTA. Must be a receipt-only prefix."
    },
    "payment_method": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Payment method text, e.g. készpénz (cash), bankkártya (card)."
    },
    "lines": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "Line item name."
          },
          "quantity": {
            "type": "number",
            "minimum": 0.0001,
            "maximum": 1000000,
            "description": "Quantity."
          },
          "unit": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "Unit of the quantity, e.g. db (pieces)."
          },
          "gross_total": {
            "type": "integer",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "GROSS value of the whole line in whole forints (HUF receipts need whole forints)."
          },
          "vat_rate": {
            "description": "VAT rate in percent as a number or text (27, 18, 5, 0), or a VAT code: AAM (VAT-exempt person), TAM (exempt supply), TAHK, EUT, EUKT, F.AFA (reverse charge), K.AFA, EU, EUK, MAA, ÁKK, ... A code means no VAT amount.",
            "type": [
              "string",
              "number"
            ]
          },
          "comment": {
            "description": "Optional note printed on the line.",
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          }
        },
        "required": [
          "name",
          "quantity",
          "unit",
          "gross_total",
          "vat_rate"
        ]
      },
      "description": "Receipt lines."
    },
    "call_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "A unique id of this call (hivasAzonosito), new for every receipt: the vendor rejects a repeat, so the receipt cannot be issued twice."
    },
    "order_number": {
      "description": "Order number printed on the receipt.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "comment": {
      "description": "Comment printed on the receipt.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    }
  },
  "required": [
    "prefix",
    "payment_method",
    "lines",
    "call_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

ISSUES a reversal (storno) receipt that cancels one issued receipt. Fiscal and irreversible; a receipt can be reversed once, and a reversal receipt cannot be reversed. NEVER retried: if the result is unclear, check with szamlazz_get_receipt before trying again. Számla Agent action-szamla_agent_nyugta_storno.

{
  "type": "object",
  "properties": {
    "receipt_number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Number of the receipt to reverse."
    },
    "call_id": {
      "description": "A unique id of this call (hivasAzonosito).",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "required": [
    "receipt_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

E-MAILS an already issued receipt (PDF) to a customer. Without the e-mail fields, the vendor re-sends the receipt with the settings of the earlier e-mail. The e-mail cannot be recalled. Számla Agent action-szamla_agent_nyugta_send.

{
  "type": "object",
  "properties": {
    "receipt_number": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Number of the issued receipt."
    },
    "email": {
      "description": "Recipient e-mail address.",
      "type": "string",
      "maxLength": 254,
      "pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
    },
    "reply_to": {
      "description": "Reply-to address.",
      "type": "string",
      "maxLength": 254,
      "pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
    },
    "subject": {
      "description": "E-mail subject.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "body": {
      "description": "E-mail text.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    }
  },
  "required": [
    "receipt_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}