MCP server
Számlázz.hu MCP by usefulapi
Read Számlázz.hu invoices, PDFs, receipts, taxpayers; issue, reverse and pay invoices…
- Runs
- Remotely
- Version
- 1.27.0
- Listing updated
- 4 days ago
About Számlázz.hu MCP by usefulapi
Számlázz.hu MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Számlázz.hu invoices, PDFs, receipts, taxpayers; issue, reverse and pay invoices and receipts.
Install
Run in a terminal
claude mcp add --transport http szamlazz-hu https://szamlazz-hu.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://szamlazz-hu.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"szamlazz-hu": {
"url": "https://szamlazz-hu.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"szamlazz-hu": {
"type": "http",
"url": "https://szamlazz-hu.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"szamlazz-hu": {
"serverUrl": "https://szamlazz-hu.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"szamlazz-hu": {
"type": "http",
"url": "https://szamlazz-hu.usefulapi.io/mcp"
}
}
}Tools this server provides (11)
Read directly from the server.
- szamlazz_get_invoice
- 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.
- szamlazz_get_invoice_pdf
- 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.
- szamlazz_check_taxpayer
- 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).
- szamlazz_get_receipt
- 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.
- szamlazz_create_invoice
- 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 tru
- szamlazz_reverse_invoice
- 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.
- szamlazz_delete_proforma
- 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.
- szamlazz_register_payment
- 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.
- szamlazz_create_receipt
- 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 invoic
- szamlazz_reverse_receipt
- 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.
- szamlazz_send_receipt
- 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.
Számlázz.hu MCP by usefulapi FAQ
How do I add Számlázz.hu MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http szamlazz-hu https://szamlazz-hu.usefulapi.io/mcp