_ registry / mcp streamable-http · checked 25m ago

facturo

https://mcp.facturo.at

Registry code: b8be1128ac91d36b

api record

facturo schreibt Rechnungen für österreichische Kleinunternehmen. Sobald ein Kundenname und eine Position bekannt sind, ruf preview_invoice auf; frag fehlende Angaben danach ab. Der Nutzer sieht die Vorschau als Karte, ruf das Tool nie nochmal auf, nur um sie zu zeigen. Angaben, die du nicht kennst, erfindest du nie (auch nicht die Rechnungsnummer): fehlende Pflichtfelder stehen in 'missing'. finalize_invoice nur nach ausdrücklichem Ja zur Vorschau. Verbundenes Konto: erst search_clients, dann preview_invoice mit client_id. Will der Nutzer sein facturo-Konto verbinden, ruf get_profile auf.…

endpoint
https://mcp.facturo.at/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is facturo live?
Yes — it answered the hub's last check (checked 25m ago). It answered 100% of checks over the last 30 days.
Is facturo free to use?
Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
What tools does facturo have?
19 tools: list_products, update_product, discard_draft, validate_uid, get_profile, get_recent_invoices, get_recent_offers, preview_invoice, ….
Is facturo safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
360ms

last good check

priced tools
0

of 19 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 19 tools
19 auth-required 19 of 19 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • list_products auth-required never probed

    List the saved products and services of the connected facturo account with their unit prices. Use the names and prices for items when the user refers to something they usually bill.

    mcp-tool

    {
      "type": "object",
      "properties": {}
    }
    arguments 4 lines
  • update_product auth-required never probed

    Change a saved product of the connected facturo account by its product_id from list_products, e.g. 'der Stundensatz ist jetzt 95 Euro'. Pass ONLY the fields the user asked to change; omitted fields stay, an empty string clears description or vat_rate. Read the change back to the user (old and new value) and wait for their OK first. Documents already created keep their prices; items you add from now on take the new values.

    mcp-tool

    {
      "type": "object",
      "required": [
        "product_id"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 255,
          "description": "Name as it goes onto the invoice line, one line, e.g. 'Regiestunde' or 'Fliesen verlegen'"
        },
        "unit": {
          "type": "string",
          "maxLength": 50,
          "description": "Unit the price is for, e.g. 'Std', 'Stk', 'm²', 'pauschal'"
        },
        "price": {
          "type": "string",
          "description": "Unit price in EUR as it goes onto the invoice line, e.g. '95', '95.50' or '95,50'"
        },
        "vat_rate": {
          "type": "string",
          "description": "Optional own VAT rate in percent ('10', '13', '4,9'), only on accounts with per-line VAT rates. Empty string: the product follows the document's rate."
        },
        "product_id": {
          "type": "integer"
        },
        "description": {
          "type": "string",
          "maxLength": 2000,
          "description": "Optional standard specs (dimensions, scope, options). They prefill the item details whenever the product goes onto a line."
        }
      }
    }
    arguments 34 lines
  • discard_draft auth-required never probed

    Drop a previewed draft (invoice or offer) the user no longer wants, including the Entwurf at facturo.at. Only after the user said so. A draft already turned into a document cannot be discarded; deleting invoices and offers happens in the facturo web app.

    mcp-tool

    {
      "type": "object",
      "required": [
        "draft_id"
      ],
      "properties": {
        "draft_id": {
          "type": "string"
        }
      }
    }
    arguments 11 lines
  • validate_uid auth-required never probed

    Check an EU VAT number (UID) against VIES, the EU register. Returns the status and, where the member state publishes it, the registered name and address. Use it when the user gives a UID or asks whether one is valid. Read-only; update_client and update_profile run the same check before saving.

    mcp-tool

    {
      "type": "object",
      "required": [
        "uid"
      ],
      "properties": {
        "uid": {
          "type": "string",
          "description": "e.g. ATU12345678 or DE123456789"
        }
      }
    }
    arguments 12 lines
  • get_profile auth-required 25m ago

    Return the company profile of the connected facturo account: name, address, UID, bank details and plan. Needs a connected account. Use it to check what the real invoice will carry as sender before creating one. Also the way to connect: when the user wants to link their facturo account or save invoices in facturo, call it.

    mcp-tool

    {
      "type": "object",
      "properties": {}
    }
    arguments 4 lines
  • get_recent_invoices auth-required 25m ago

    List the newest invoices of the connected facturo account with status (open, overdue, paid, cancelled with the Storno in cancelled_by, issued for a Storno or Gutschrift), totals, items, VAT mode, PDF links and when they were last emailed. Filter by client, text or status. Use it to answer 'what did I bill Huber' or 'what is still open', and to copy an earlier invoice ('the same as last time'): take items, vat_exemption_type, vat_rate, prices_include_vat and the discount fields from the row. The PDF links are for the user to open.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "maximum": 20,
          "minimum": 1,
          "description": "Default 10"
        },
        "search": {
          "type": "string",
          "description": "Matches invoice number, client name, reference lines or an item description"
        },
        "status": {
          "enum": [
            "open",
            "overdue",
            "paid"
          ],
          "type": "string",
          "description": "'open' means not yet due"
        },
        "client_id": {
          "type": "integer"
        }
      }
    }
    arguments 27 lines
  • get_recent_offers auth-required 25m ago

    List the newest Angebote, Kostenvoranschläge and Auftragsbestätigungen of the connected facturo account with validity, totals, items, PDF links and when they were last emailed. Filter by client, document type or text. Use it to find the Angebot an Auftragsbestätigung confirms (source_offer_number) or to copy an earlier offer. Each row's status is open, accepted, declined, expired (past its validity) or issued (an Auftragsbestätigung). The PDF links are for the user to open.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "maximum": 20,
          "minimum": 1,
          "description": "Default 10"
        },
        "search": {
          "type": "string",
          "description": "Matches offer number, client name, reference lines or an item description"
        },
        "client_id": {
          "type": "integer"
        },
        "document_type": {
          "enum": [
            "angebot",
            "kostenvoranschlag",
            "auftragsbestaetigung"
          ],
          "type": "string"
        }
      }
    }
    arguments 26 lines
  • preview_invoice auth-required never probed

    Render an Austrian invoice as a watermarked preview. Works without a facturo account; with a connected account the preview is an Entwurf the user also sees at facturo.at, nothing is numbered or sent. The user sees the preview as a card in the chat after each call. A new draft needs client.name (or client_id with a connected account) and at least one item; later calls pass draft_id plus only the fields that change. Returns the draft_id, the totals, the review_hash that finalize_invoice needs, and 'missing': what the real invoice still needs. It works with only a client name and one position.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "description",
              "quantity",
              "unit_price"
            ],
            "properties": {
              "unit": {
                "type": "string",
                "maxLength": 50,
                "description": "e.g. 'Std', 'Stk', 'm2'; may be empty"
              },
              "quantity": {
                "type": "string",
                "description": "Decimal as string, e.g. '2' or '1.5'"
              },
              "vat_rate": {
                "type": "number",
                "description": "VAT rate in percent for THIS line, only on accounts with per-line rates (the tool says so if the account has none). Omit it for the document's vat_rate. A saved product with its own vat_rate gives its line that rate."
              },
              "product_id": {
                "type": "integer",
                "description": "Optional saved product id"
              },
              "unit_price": {
                "type": "string",
                "description": "Net unit price as decimal string"
              },
              "description": {
                "type": "string",
                "maxLength": 500,
                "description": "Short single-line name of the item, e.g. 'Innenputz' or 'Regiestunden'. Renders as one line on the PDF - newlines are rejected; details go into ephemeral_description."
              },
              "ephemeral_description": {
                "type": "string",
                "maxLength": 2000,
                "description": "Optional per-item details, printed small below the item name. Multi-line allowed. For hour/date breakdowns, material lists, work-scope detail, vehicle/object identifiers - anything specific to this line on this invoice. Detail for this one line only - never pack a whole position list into a single item's details. For a flat total with positions listed just for reference, create one item per position with unit_price '0' plus one priced Pauschale line."
              }
            }
          },
          "maxItems": 100,
          "minItems": 1
        },
        "client": {
          "type": "object",
          "properties": {
            "uid": {
              "type": "string",
              "maxLength": 50,
              "description": "Client's VAT id (UID), e.g. ATU12345678"
            },
            "zip": {
              "type": "string",
              "maxLength": 20
            },
            "city": {
              "type": "string",
              "maxLength": 100
            },
            "name": {
              "type": "string",
              "maxLength": 255,
              "description": "Company or person the invoice is addressed to"
            },
            "email": {
              "type": "string",
              "maxLength": 255
            },
            "street": {
              "type": "string",
              "maxLength": 255
            },
            "country": {
              "type": "string",
              "maxLength": 50,
              "description": "ISO 3166-1 alpha-2, default AT"
            },
            "name_line2": {
              "type": "string",
              "maxLength": 255,
              "description": "Second address line, e.g. contact person or department"
            }
          },
          "description": "The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address."
        },
        "issuer": {
          "type": "object",
          "properties": {
            "bic": {
              "type": "string",
              "maxLength": 20
            },
            "uid": {
              "type": "string",
              "maxLength": 50,
              "description": "Own VAT id (UID)"
            },
            "zip": {
              "type": "string",
              "maxLength": 20
            },
            "city": {
              "type": "string",
              "maxLength": 100
            },
            "iban": {
              "type": "string",
              "maxLength": 50
            },
            "email": {
              "type": "string",
              "maxLength": 254
            },
            "phone": {
              "type": "string",
              "maxLength": 50
            },
            "street": {
              "type": "string",
              "maxLength": 255
            },
            "company_name": {
              "type": "string",
              "maxLength": 255
            },
            "bank_account_holder": {
              "type": "string",
              "maxLength": 70
            }
          },
          "description": "The sender (the user's own business). Everything is optional for a preview; missing mandatory fields render as placeholders and are listed under 'missing'. With a connected account the profile there wins; only an account without a company profile yet takes these fields."
        },
        "draft_id": {
          "type": "string",
          "description": "Id of a draft from an earlier preview_invoice result. Pass it to change that draft instead of starting a new one: client and issuer merge field by field, every other field given replaces the old value, items replace the whole list."
        },
        "due_date": {
          "type": "string",
          "description": "YYYY-MM-DD; default invoice_date + payment_days"
        },
        "fusstext": {
          "type": "string",
          "maxLength": 5000,
          "description": "Text below the totals; default: the account's standard text. A 'bereits bezahlt' remark goes here as 'Der Rechnungsbetrag wurde bereits bezahlt.'"
        },
        "kopftext": {
          "type": "string",
          "maxLength": 5000,
          "description": "Text above the items; default: the account's standard text"
        },
        "vat_rate": {
          "type": "number",
          "description": "VAT rate in percent (10 and 13 are the reduced Austrian rates). Omit to inherit: the client's last invoice's rate, else 20."
        },
        "client_id": {
          "type": "integer",
          "description": "Id of an existing client of the connected facturo account (from search_clients). Use it instead of 'client' whenever the client exists; needs a connected account."
        },
        "invoice_date": {
          "type": "string",
          "description": "YYYY-MM-DD, default today"
        },
        "invoice_type": {
          "enum": [
            "normal",
            "honorarnote"
          ],
          "type": "string",
          "description": "'honorarnote' for freelancers/Freiberufler who bill a Honorar; default 'normal'"
        },
        "payment_days": {
          "type": "integer",
          "description": "Zahlungsziel in days, default 14; ignored when due_date is given"
        },
        "discount_type": {
          "enum": [
            "none",
            "percentage",
            "fixed"
          ],
          "type": "string",
          "description": "Gesamtrabatt on the whole document, deducted as its own line below the items (VAT is computed on the reduced amount). 'percentage' = discount_value is a percent of the net item total, 'fixed' = discount_value is an EUR amount (in the draft's price mode). Requires discount_value. Set it when the user grants a discount/Nachlass/Aktionscode on the whole invoice or offer; never bill a discount as a negative item. 'none' clears a discount set earlier. Not available on an Anzahlungsrechnung (the deposit share replaces it); a Storno inherits the cancelled invoice's discount automatically."
        },
        "discount_value": {
          "type": "string",
          "description": "Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100."
        },
        "invoice_number": {
          "type": "string",
          "maxLength": 50,
          "description": "Only without a connected account: the user's own invoice number, the next one in their sequence (e.g. '2026-014'). Ask the user for it, never invent one. A connected account numbers automatically."
        },
        "reference_lines": {
          "type": "string",
          "maxLength": 500,
          "description": "Extra reference lines in the header, e.g. 'Projekt: Dach Huber'"
        },
        "prices_include_vat": {
          "type": "boolean",
          "description": "Unit prices are gross (Brutto) amounts. Omit to inherit from the client's last invoice, else false."
        },
        "service_period_end": {
          "type": "string",
          "description": "YYYY-MM-DD, Leistungszeitraum end"
        },
        "vat_exemption_type": {
          "enum": [
            "",
            "small_business",
            "construction",
            "eu_service",
            "eu_goods",
            "healthcare"
          ],
          "type": "string",
          "description": "Omit unless the user named one: a connected preview then picks the account's treatment (Kleinunternehmer setting, the client's last invoice, the account's usual mode, else 20%) and reports it. '' forces regular VAT. 'small_business' = Kleinunternehmer (no VAT, §6 Abs 1 Z 27 UStG), 'construction' = Reverse Charge Bauleistungen (§19 Abs 1a), 'eu_service' / 'eu_goods' = innergemeinschaftlich, 'healthcare' = §6 Abs 1 Z 19."
        },
        "discount_description": {
          "type": "string",
          "maxLength": 255,
          "description": "Label printed on the discount line, e.g. 'Rabatt' (default), 'Rabatt Aktionscode START25', 'Treuebonus'. The percentage or amount is printed next to it automatically, so leave it out of the label."
        },
        "service_period_start": {
          "type": "string",
          "description": "YYYY-MM-DD, Leistungszeitraum start; default invoice_date"
        }
      }
    }
    arguments 234 lines
  • finalize_invoice auth-required never probed

    Turn a previewed draft into the real invoice. Only call it after the user has seen the preview and explicitly said yes. Without a facturo account it returns a link to the final PDF (no watermark, the user's own invoice_number from the draft); nothing is stored for the user, they download and keep the PDF. With a connected account it allocates the number to the Entwurf the preview made. review_hash comes from the last preview_invoice result; a stale hash is refused. Fails with the missing fields when something mandatory is missing. Calling it again for the same draft returns the invoice already created. While the account has no invoice yet but this chat holds anonymous ones not imported, it answers import_first instead: call import_invoices, or repeat with skip_import=true if the user declined.

    mcp-tool

    {
      "type": "object",
      "required": [
        "draft_id",
        "review_hash"
      ],
      "properties": {
        "draft_id": {
          "type": "string"
        },
        "review_hash": {
          "type": "string",
          "description": "review_hash of the preview the user confirmed"
        },
        "skip_import": {
          "type": "boolean",
          "description": "Create the invoice although anonymous invoices from this chat are not imported yet. Only after the user declined the import."
        }
      }
    }
    arguments 20 lines
  • import_invoices auth-required never probed

    Store the invoices this chat created without an account (the PDFs from finalize_invoice) in the connected facturo account. They keep the user's own invoice numbers and facturo's numbering continues after the highest one. Only call it after the user said yes to the offer, ideally before the first invoice is created in the account so the sequence stays in order. An invoice already in the account is never stored twice.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "invoice_numbers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Only these numbers (from importable_invoices); default: all of them"
        }
      }
    }
    arguments 12 lines
  • preview_offer auth-required never probed

    Preview an Angebot, Kostenvoranschlag or Auftragsbestätigung for the connected facturo account; the user sees it as a card. The first call creates an Entwurf the user also sees at facturo.at, later calls with draft_id change it: pass only what changes, the rest stays. Call it again after every change the user asks for; finalize_offer needs the review_hash of the card the user confirmed. For an Auftragsbestätigung pass source_offer_number; items, client, VAT and texts come from the source and can be overridden. The result lists what is still missing.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "description",
              "quantity",
              "unit_price"
            ],
            "properties": {
              "unit": {
                "type": "string",
                "maxLength": 50,
                "description": "e.g. 'Std', 'Stk', 'm2'; may be empty"
              },
              "quantity": {
                "type": "string",
                "description": "Decimal as string, e.g. '2' or '1.5'"
              },
              "vat_rate": {
                "type": "number",
                "description": "VAT rate in percent for THIS line, only on accounts with per-line rates (the tool says so if the account has none). Omit it for the document's vat_rate. A saved product with its own vat_rate gives its line that rate."
              },
              "product_id": {
                "type": "integer",
                "description": "Optional saved product id"
              },
              "unit_price": {
                "type": "string",
                "description": "Net unit price as decimal string"
              },
              "description": {
                "type": "string",
                "maxLength": 500,
                "description": "Short single-line name of the item, e.g. 'Innenputz' or 'Regiestunden'. Renders as one line on the PDF - newlines are rejected; details go into ephemeral_description."
              },
              "ephemeral_description": {
                "type": "string",
                "maxLength": 2000,
                "description": "Optional per-item details, printed small below the item name. Multi-line allowed. For hour/date breakdowns, material lists, work-scope detail, vehicle/object identifiers - anything specific to this line on this invoice. Detail for this one line only - never pack a whole position list into a single item's details. For a flat total with positions listed just for reference, create one item per position with unit_price '0' plus one priced Pauschale line."
              }
            }
          },
          "maxItems": 100,
          "minItems": 1
        },
        "client": {
          "type": "object",
          "properties": {
            "uid": {
              "type": "string",
              "maxLength": 50,
              "description": "Client's VAT id (UID), e.g. ATU12345678"
            },
            "zip": {
              "type": "string",
              "maxLength": 20
            },
            "city": {
              "type": "string",
              "maxLength": 100
            },
            "name": {
              "type": "string",
              "maxLength": 255,
              "description": "Company or person the invoice is addressed to"
            },
            "email": {
              "type": "string",
              "maxLength": 255
            },
            "street": {
              "type": "string",
              "maxLength": 255
            },
            "country": {
              "type": "string",
              "maxLength": 50,
              "description": "ISO 3166-1 alpha-2, default AT"
            },
            "name_line2": {
              "type": "string",
              "maxLength": 255,
              "description": "Second address line, e.g. contact person or department"
            }
          },
          "description": "The invoice recipient. The name is required for the first preview of a draft; the real invoice needs the address."
        },
        "draft_id": {
          "type": "string",
          "description": "Handle from an earlier preview_offer result; pass it to change that draft instead of starting a new one."
        },
        "fusstext": {
          "type": "string",
          "maxLength": 5000,
          "description": "Text below the totals; defaults to the account's standard text"
        },
        "kopftext": {
          "type": "string",
          "maxLength": 5000,
          "description": "Text above the items; defaults to the account's standard text"
        },
        "vat_rate": {
          "type": "number",
          "description": "Percent for tax_exempt 'show', default 20"
        },
        "client_id": {
          "type": "integer",
          "description": "A client of the connected account (from search_clients) instead of client."
        },
        "offer_date": {
          "type": "string",
          "description": "YYYY-MM-DD, default today"
        },
        "tax_exempt": {
          "enum": [
            "show",
            "exempt"
          ],
          "type": "string",
          "description": "'show' prints USt at vat_rate, 'exempt' prints no USt (Kleinunternehmer, reverse charge). Leave it out to take the account's usual setting for this client; the result names what was applied."
        },
        "discount_type": {
          "enum": [
            "none",
            "percentage",
            "fixed"
          ],
          "type": "string",
          "description": "Gesamtrabatt on the whole document, deducted as its own line below the items (VAT is computed on the reduced amount). 'percentage' = discount_value is a percent of the net item total, 'fixed' = discount_value is an EUR amount (in the draft's price mode). Requires discount_value. Set it when the user grants a discount/Nachlass/Aktionscode on the whole invoice or offer; never bill a discount as a negative item. 'none' clears a discount set earlier. Not available on an Anzahlungsrechnung (the deposit share replaces it); a Storno inherits the cancelled invoice's discount automatically."
        },
        "document_type": {
          "enum": [
            "angebot",
            "kostenvoranschlag",
            "auftragsbestaetigung"
          ],
          "type": "string",
          "description": "'angebot' (default), 'kostenvoranschlag' or 'auftragsbestaetigung'. An Auftragsbestätigung confirms an accepted Angebot/KV: pass source_offer_number and the draft is prefilled from it."
        },
        "validity_date": {
          "type": "string",
          "description": "YYYY-MM-DD, default offer_date + 30 days"
        },
        "discount_value": {
          "type": "string",
          "description": "Decimal as string: the percent ('25') or EUR amount ('100') per discount_type. Must be above 0, a percentage at most 100."
        },
        "reference_lines": {
          "type": "string",
          "maxLength": 500,
          "description": "Reference lines under the address, one per line"
        },
        "signature_block": {
          "type": "boolean",
          "description": "Auftragsbestätigung only: 'Ort, Datum' and 'Unterschrift Auftraggeber' lines under the closing text so the customer can countersign. Default true; set false only when the user wants no signature lines. Ignored on an Angebot or Kostenvoranschlag."
        },
        "prices_include_vat": {
          "type": "boolean",
          "description": "Unit prices are gross (default false, net)"
        },
        "source_offer_number": {
          "type": "string",
          "description": "Number of the finalized Angebot/KV an Auftragsbestätigung confirms (from get_recent_offers)."
        },
        "discount_description": {
          "type": "string",
          "maxLength": 255,
          "description": "Label printed on the discount line, e.g. 'Rabatt' (default), 'Rabatt Aktionscode START25', 'Treuebonus'. The percentage or amount is printed next to it automatically, so leave it out of the label."
        }
      }
    }
    arguments 175 lines
  • finalize_offer auth-required never probed

    Turn a previewed offer draft into the numbered Angebot, Kostenvoranschlag or Auftragsbestätigung. Only call it after the user has seen the preview and explicitly said yes. review_hash comes from the last preview_offer result; a stale hash is refused. Fails with the missing fields when something mandatory is missing. Calling it again for the same draft returns the document already created.

    mcp-tool

    {
      "type": "object",
      "required": [
        "draft_id",
        "review_hash"
      ],
      "properties": {
        "draft_id": {
          "type": "string"
        },
        "review_hash": {
          "type": "string",
          "description": "review_hash of the preview the user confirmed"
        }
      }
    }
    arguments 16 lines
  • search_clients auth-required never probed

    Find clients of the connected facturo account by name (typos and partial names are fine) or city; an empty query lists everyone. Call it before previewing for a client that may already exist and pass the client_id to preview_invoice. 'match' is 'exact', 'candidates' (one candidate: use it and name it; several: ask the user which one), 'none' (a new client) or 'all'.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Name, part of a name, or city"
        }
      }
    }
    arguments 9 lines
  • get_client auth-required never probed

    Full details of one client (address, UID, email, phone, payment terms) by client_id. Use it to read the current values before update_client or when the user asks about a client's data.

    mcp-tool

    {
      "type": "object",
      "required": [
        "client_id"
      ],
      "properties": {
        "client_id": {
          "type": "integer"
        }
      }
    }
    arguments 11 lines
  • create_client auth-required never probed

    Save a new client of the connected facturo account. Only after search_clients found no match. Fill every field you know; ask the user for the address if it is missing (documents need it). A client with the same name (and street) already exists is returned instead of duplicated. For a client that only appears on one invoice, preview_invoice with a client object does this on its own.

    mcp-tool

    {
      "type": "object",
      "required": [
        "client_name"
      ],
      "properties": {
        "uid": {
          "type": "string",
          "maxLength": 50,
          "description": "EU VAT number, e.g. ATU12345678"
        },
        "zip": {
          "type": "string",
          "maxLength": 20,
          "description": "Postal code"
        },
        "city": {
          "type": "string",
          "maxLength": 100,
          "description": "City"
        },
        "email": {
          "type": "string",
          "maxLength": 255,
          "description": "Email the documents go to"
        },
        "phone": {
          "type": "string",
          "maxLength": 50,
          "description": "Phone number"
        },
        "street": {
          "type": "string",
          "maxLength": 255,
          "description": "Street and house number"
        },
        "country": {
          "type": "string",
          "description": "Two-letter country code (AT, DE, CH, IT ...), default AT"
        },
        "name_line2": {
          "type": "string",
          "maxLength": 255,
          "description": "Second address line (contact person, department, c/o)"
        },
        "client_name": {
          "type": "string",
          "maxLength": 255,
          "description": "Company or person name as printed on documents"
        },
        "mobile_phone": {
          "type": "string",
          "maxLength": 50,
          "description": "Mobile number"
        },
        "payment_terms": {
          "type": "string",
          "maxLength": 255,
          "description": "Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen'"
        }
      }
    }
    arguments 62 lines
  • update_client auth-required never probed

    Change fields of a client of the connected facturo account. Pass ONLY the fields the user asked to change; omitted fields stay untouched, an empty string clears a field (not client_name or country). Read the change back to the user (old and new value) and wait for their OK first. A new UID is checked against VIES before it is saved. Documents already created keep the client data they were created with.

    mcp-tool

    {
      "type": "object",
      "required": [
        "client_id"
      ],
      "properties": {
        "uid": {
          "type": "string",
          "maxLength": 50,
          "description": "EU VAT number, e.g. ATU12345678"
        },
        "zip": {
          "type": "string",
          "maxLength": 20,
          "description": "Postal code"
        },
        "city": {
          "type": "string",
          "maxLength": 100,
          "description": "City"
        },
        "email": {
          "type": "string",
          "maxLength": 255,
          "description": "Email the documents go to"
        },
        "phone": {
          "type": "string",
          "maxLength": 50,
          "description": "Phone number"
        },
        "street": {
          "type": "string",
          "maxLength": 255,
          "description": "Street and house number"
        },
        "country": {
          "type": "string",
          "description": "Two-letter country code (AT, DE, CH, IT ...), default AT"
        },
        "client_id": {
          "type": "integer"
        },
        "name_line2": {
          "type": "string",
          "maxLength": 255,
          "description": "Second address line (contact person, department, c/o)"
        },
        "client_name": {
          "type": "string",
          "maxLength": 255,
          "description": "Company or person name as printed on documents"
        },
        "mobile_phone": {
          "type": "string",
          "maxLength": 50,
          "description": "Mobile number"
        },
        "payment_terms": {
          "type": "string",
          "maxLength": 255,
          "description": "Payment terms printed for this client, e.g. 'Zahlbar innerhalb von 14 Tagen'"
        }
      }
    }
    arguments 65 lines
  • create_product auth-required never probed

    Save a new product or service of the connected facturo account, e.g. 'leg das als Produkt an'. name, price and unit are required; ask for what is missing. A product with the same name is returned instead of duplicated; change that one with update_product. The product then shows in list_products and at facturo.at.

    mcp-tool

    {
      "type": "object",
      "required": [
        "name",
        "price",
        "unit"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 255,
          "description": "Name as it goes onto the invoice line, one line, e.g. 'Regiestunde' or 'Fliesen verlegen'"
        },
        "unit": {
          "type": "string",
          "maxLength": 50,
          "description": "Unit the price is for, e.g. 'Std', 'Stk', 'm²', 'pauschal'"
        },
        "price": {
          "type": "string",
          "description": "Unit price in EUR as it goes onto the invoice line, e.g. '95', '95.50' or '95,50'"
        },
        "vat_rate": {
          "type": "string",
          "description": "Optional own VAT rate in percent ('10', '13', '4,9'), only on accounts with per-line VAT rates. Empty string: the product follows the document's rate."
        },
        "description": {
          "type": "string",
          "maxLength": 2000,
          "description": "Optional standard specs (dimensions, scope, options). They prefill the item details whenever the product goes onto a line."
        }
      }
    }
    arguments 33 lines
  • set_offer_status auth-required never probed

    Record the customer's answer on an Angebot or Kostenvoranschlag of the connected facturo account: accepted, declined, or open again when it was set by mistake. Same switch as at facturo.at; nothing is sent to the client and the document stays unchanged. It takes the offer_number from get_recent_offers, and the change can be undone the same way. Creating an invoice or an Auftragsbestätigung from an offer marks it accepted by itself; an Auftragsbestätigung has no status.

    mcp-tool

    {
      "type": "object",
      "required": [
        "offer_number",
        "status"
      ],
      "properties": {
        "status": {
          "enum": [
            "accepted",
            "declined",
            "open"
          ],
          "type": "string"
        },
        "offer_number": {
          "type": "string",
          "description": "From get_recent_offers or a finalize result, e.g. AN-2026-0012"
        }
      }
    }
    arguments 21 lines
  • update_profile auth-required never probed

    Change the company profile of the connected facturo account PERMANENTLY: sender address, UID, Firmenbuch data, default Zahlungsziel, document defaults (Kleinunternehmer, Honorarnote, EPC QR code), standard texts and the numbering start. Only for 'from now on' wishes; a one-off text or VAT mode for a single document goes into preview_invoice/preview_offer instead. Pass ONLY the fields the user asked to change; omitted fields stay, an empty string clears a text. Read the change back and wait for the user's OK first. Bank data and the logo are changed at facturo.at.

    mcp-tool

    {
      "type": "object",
      "properties": {
        "uid": {
          "type": "string",
          "description": "Own UID (ATU...), needed for reverse charge and EU documents; checked against VIES"
        },
        "zip": {
          "type": "string",
          "description": "Postal code"
        },
        "city": {
          "type": "string",
          "description": "City"
        },
        "dgnr": {
          "type": "string",
          "description": "Dienstgebernummer"
        },
        "email": {
          "type": "string",
          "description": "Contact email printed on documents"
        },
        "phone": {
          "type": "string",
          "description": "Contact phone printed on documents"
        },
        "street": {
          "type": "string",
          "description": "Street and house number"
        },
        "fusstext": {
          "type": "string",
          "description": "Standard text below the totals on invoices"
        },
        "kopftext": {
          "type": "string",
          "description": "Standard text above the items on invoices"
        },
        "kv_fusstext": {
          "type": "string",
          "description": "Standard text below the totals on Kostenvoranschläge"
        },
        "kv_kopftext": {
          "type": "string",
          "description": "Standard text above the items on Kostenvoranschläge"
        },
        "company_name": {
          "type": "string",
          "description": "Company name as printed on documents"
        },
        "offer_fusstext": {
          "type": "string",
          "description": "Standard text below the totals on Angebote"
        },
        "offer_kopftext": {
          "type": "string",
          "description": "Standard text above the items on Angebote"
        },
        "firmenbuchnummer": {
          "type": "string",
          "description": "Firmenbuch number (FN ...)"
        },
        "show_epc_qr_code": {
          "type": "boolean",
          "description": "Print the EPC payment QR code on invoices. Part of the paid plans, switching it on fails on a free plan."
        },
        "firmenbuchgericht": {
          "type": "string",
          "description": "Firmenbuch court"
        },
        "next_offer_number": {
          "type": "integer",
          "description": "The number the next Angebot/KV/AB gets this year. Can only move up past the numbers already issued this year."
        },
        "next_invoice_number": {
          "type": "integer",
          "description": "The number the next invoice gets this year. Can only move up past the numbers already issued this year."
        },
        "prefers_honorarnote": {
          "type": "boolean",
          "description": "New invoices are Honorarnoten by default (freelancers, doctors)"
        },
        "default_payment_days": {
          "type": "integer",
          "description": "Default Zahlungsziel in days for new invoices"
        },
        "email_default_text_offer": {
          "type": "string",
          "description": "Default email body when sending Angebote"
        },
        "email_default_text_invoice": {
          "type": "string",
          "description": "Default email body when sending invoices"
        },
        "kleinunternehmer_default_enabled": {
          "type": "boolean",
          "description": "Kleinunternehmer: new documents show no USt by default (§ 6 Abs 1 Z 27 UStG)"
        }
      }
    }
    arguments 101 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id b8be1128ac91d36b.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/b8be1128ac91d36b/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/b8be1128ac91d36b/badge.svg)](https://brick.blue/agent/b8be1128ac91d36b?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.