InvoiceGen

Working · 375 ms

io.github.everyai-com/invoice-genv1.0.0

Freelancer invoices with totals, tax, due dates. Free.

Finance & Payments

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://invoice-gen.magicteams.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_totals Read-only

Compute subtotal, discount, tax and total for a list of line items (discount applied before tax, amounts rounded to 2 dp). Use for quick totals math without building an invoice. Do NOT use to produce an invoice document; use create_invoice.

itemsarray, required

Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price.

discount_pctnumber

Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0.

tax_rate_pctnumber

Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0.

Tools (4)

calculate_totals

read-only

Argument	Type	Description
items*	array	Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price.
discount_pct	number	Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0.
tax_rate_pct	number	Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "quantity",
          "unit_price"
        ],
        "properties": {
          "quantity": {
            "type": "number",
            "description": "Quantity or hours, must be > 0, e.g. 10",
            "exclusiveMinimum": 0
          },
          "unit_price": {
            "type": "number",
            "minimum": 0,
            "description": "Price per unit in the invoice currency, >= 0, e.g. 50"
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "description": "What was sold or done, e.g. \"Logo design\" or \"Consulting hours\""
          }
        }
      },
      "minItems": 1,
      "description": "Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price."
    },
    "discount_pct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0."
    },
    "tax_rate_pct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0."
    }
  }
}

create_invoice

Build a complete invoice as structured data: invoice number, issue and due dates, line items, discount, tax, total and payment terms. Nothing is stored. Use when the user wants an invoice for a client. Do NOT use for totals only (use calculate_totals) or for a printable text version (use render_invoice_text).

read-only

Argument	Type	Description
items*	array	Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price.
notes	string	Free-text notes printed on the invoice, e.g. payment instructions. Default empty.
currency	string	Three-letter currency code, case-insensitive: one of USD, EUR, INR, GBP, AED, SGD, AUD, CAD. Default USD.
client_name*	string	Name of the client being billed, e.g. "Globex Corp"
due_in_days	number	Payment term in days from today; sets due_date and 'Net N' terms. Default 14.
discount_pct	number	Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0.
tax_rate_pct	number	Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0.

render_invoice_text

Build an invoice from the same inputs as create_invoice and return it as a plain-text document (header, line items, subtotal, discount, tax, TOTAL DUE, notes) ready to paste into an email or message. Use when the user wants readable invoice text. Do NOT use when structured fields are needed; use create_invoice.

read-only

Argument	Type	Description
items*	array	Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price.
notes	string	Free-text notes printed on the invoice, e.g. payment instructions. Default empty.
currency	string	Three-letter currency code, case-insensitive: one of USD, EUR, INR, GBP, AED, SGD, AUD, CAD. Default USD.
client_name*	string	Name of the client being billed, e.g. "Globex Corp"
due_in_days	number	Payment term in days from today; sets due_date and 'Net N' terms. Default 14.
discount_pct	number	Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0.
tax_rate_pct	number	Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0.

supported_currencies

List the currency codes InvoiceGen accepts for invoices (USD, EUR, INR, GBP, AED, SGD, AUD, CAD). Use before create_invoice when unsure whether a currency is supported. No exchange rates or currency conversion are provided.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

{ "type": "object", "required": [ "business_name", "client_name", "items" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "description", "quantity", "unit_price" ], "properties": { "quantity": { "type": "number", "description": "Quantity or hours, must be > 0, e.g. 10", "exclusiveMinimum": 0 }, "unit_price": { "type": "number", "minimum": 0, "description": "Price per unit in the invoice currency, >= 0, e.g. 50" }, "description": { "type": "string", "minLength": 1, "description": "What was sold or done, e.g. \"Logo design\" or \"Consulting hours\"" } } }, "minItems": 1, "description": "Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price." }, "notes": { "type": "string", "description": "Free-text notes printed on the invoice, e.g. payment instructions. Default empty." }, "currency": { "type": "string", "description": "Three-letter currency code, case-insensitive: one of USD, EUR, INR, GBP, AED, SGD, AUD, CAD. Default USD." }, "client_name": { "type": "string", "minLength": 1, "description": "Name of the client being billed, e.g. \"Globex Corp\"" }, "due_in_days": { "type": "number", "description": "Payment term in days from today; sets due_date and 'Net N' terms. Default 14." }, "discount_pct": { "type": "number", "maximum": 100, "minimum": 0, "description": "Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0." }, "tax_rate_pct": { "type": "number", "maximum": 100, "minimum": 0, "description": "Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0." }, "business_name": { "type": "string", "minLength": 1, "description": "Name of the business or freelancer issuing the invoice, e.g. \"Acme Design Studio\"" }, "invoice_number": { "type": "string", "description": "Invoice number to use, e.g. \"INV-2026-042\". If omitted, one is generated as INV-YYYYMMDD-NNNN." } } }