InvoiceGen
Freelancer invoices with totals, tax, due dates. Free.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~2,289Tokens (tool definitions)
~5.4 KBTypical response size
Moderate attention impact (1.79% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"invoice-gen": {
"url": "https://invoice-gen.magicteams.ai/mcp"
}
}
}Remote endpoints
https://invoice-gen.magicteams.ai/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢create_invoice(business_name, client_name, items, currency, tax_rate_pct, ...)
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).
Input Schema
{
"type": "object",
"properties": {
"business_name": {
"type": "string",
"minLength": 1,
"description": "Name of the business or freelancer issuing the invoice, e.g. \"Acme Design Studio\""
},
"client_name": {
"type": "string",
"minLength": 1,
"description": "Name of the client being billed, e.g. \"Globex Corp\""
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"description": "What was sold or done, e.g. \"Logo design\" or \"Consulting hours\""
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity or hours, must be > 0, e.g. 10"
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the invoice currency, >= 0, e.g. 50"
}
},
"required": [
"description",
"quantity",
"unit_price"
]
},
"description": "Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price."
},
"currency": {
"type": "string",
"description": "Three-letter currency code, case-insensitive: one of USD, EUR, INR, GBP, AED, SGD, AUD, CAD. Default USD."
},
"tax_rate_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0."
},
"discount_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0."
},
"invoice_number": {
"type": "string",
"description": "Invoice number to use, e.g. \"INV-2026-042\". If omitted, one is generated as INV-YYYYMMDD-NNNN."
},
"notes": {
"type": "string",
"description": "Free-text notes printed on the invoice, e.g. payment instructions. Default empty."
},
"due_in_days": {
"type": "number",
"description": "Payment term in days from today; sets due_date and 'Net N' terms. Default 14."
}
},
"required": [
"business_name",
"client_name",
"items"
]
}Output Schema
{
"type": "object",
"properties": {
"invoice_number": {
"type": "string",
"description": "Invoice number (given or generated INV-YYYYMMDD-NNNN)."
},
"date": {
"type": "string",
"description": "Issue date, today in UTC, YYYY-MM-DD."
},
"due_date": {
"type": "string",
"description": "Due date, YYYY-MM-DD (issue date + due_in_days)."
},
"business_name": {
"type": "string",
"description": "Issuing business name as given."
},
"client_name": {
"type": "string",
"description": "Billed client name as given."
},
"currency": {
"type": "string",
"description": "Upper-case currency code, e.g. USD."
},
"symbol": {
"type": "string",
"description": "Currency symbol used when rendering, e.g. $."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"description": "What was sold or done, e.g. \"Logo design\" or \"Consulting hours\""
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity or hours, must be > 0, e.g. 10"
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the invoice currency, >= 0, e.g. 50"
}
},
"required": [
"description",
"quantity",
"unit_price"
]
},
"description": "Line items echoed back as provided."
},
"tax_rate_pct": {
"type": "number",
"description": "Tax rate percent that was applied."
},
"discount_pct": {
"type": "number",
"description": "Discount percent that was applied."
},
"subtotal": {
"type": "number",
"description": "Sum of quantity x unit_price, rounded to 2 dp."
},
"discount": {
"type": "number",
"description": "Discount amount = subtotal x discount_pct / 100."
},
"tax": {
"type": "number",
"description": "Tax amount = (subtotal - discount) x tax_rate_pct / 100."
},
"total": {
"type": "number",
"description": "Amount due = subtotal - discount + tax."
},
"notes": {
"type": "string",
"description": "Notes text (empty string if none)."
},
"payment_terms": {
"type": "string",
"description": "Payment terms label, e.g. 'Net 14'."
}
},
"required": [
"invoice_number",
"date",
"due_date",
"business_name",
"client_name",
"currency",
"symbol",
"items",
"tax_rate_pct",
"discount_pct",
"subtotal",
"discount",
"tax",
"total",
"notes",
"payment_terms"
]
}🟢calculate_totals(items, tax_rate_pct, discount_pct)
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.
Input Schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"description": "What was sold or done, e.g. \"Logo design\" or \"Consulting hours\""
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity or hours, must be > 0, e.g. 10"
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the invoice currency, >= 0, e.g. 50"
}
},
"required": [
"description",
"quantity",
"unit_price"
]
},
"description": "Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price."
},
"tax_rate_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0."
},
"discount_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0."
}
},
"required": [
"items"
]
}Output Schema
{
"type": "object",
"properties": {
"subtotal": {
"type": "number",
"description": "Sum of quantity x unit_price, rounded to 2 dp."
},
"discount": {
"type": "number",
"description": "Discount amount = subtotal x discount_pct / 100."
},
"tax": {
"type": "number",
"description": "Tax amount = (subtotal - discount) x tax_rate_pct / 100."
},
"total": {
"type": "number",
"description": "Final amount = subtotal - discount + tax."
}
},
"required": [
"subtotal",
"discount",
"tax",
"total"
]
}🟢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.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"currencies": {
"type": "array",
"items": {
"type": "string"
},
"description": "Supported upper-case currency codes."
}
},
"required": [
"currencies"
]
}🟢render_invoice_text(business_name, client_name, items, currency, tax_rate_pct, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"business_name": {
"type": "string",
"minLength": 1,
"description": "Name of the business or freelancer issuing the invoice, e.g. \"Acme Design Studio\""
},
"client_name": {
"type": "string",
"minLength": 1,
"description": "Name of the client being billed, e.g. \"Globex Corp\""
},
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"description": "What was sold or done, e.g. \"Logo design\" or \"Consulting hours\""
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity or hours, must be > 0, e.g. 10"
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the invoice currency, >= 0, e.g. 50"
}
},
"required": [
"description",
"quantity",
"unit_price"
]
},
"description": "Line items (at least one), each {description, quantity, unit_price}; line amount = quantity x unit_price."
},
"currency": {
"type": "string",
"description": "Three-letter currency code, case-insensitive: one of USD, EUR, INR, GBP, AED, SGD, AUD, CAD. Default USD."
},
"tax_rate_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Tax rate in percent, 0-100, applied after the discount, e.g. 18 for 18% GST. Default 0."
},
"discount_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Discount in percent of the subtotal, 0-100, e.g. 10 for 10% off. Default 0."
},
"invoice_number": {
"type": "string",
"description": "Invoice number to use, e.g. \"INV-2026-042\". If omitted, one is generated as INV-YYYYMMDD-NNNN."
},
"notes": {
"type": "string",
"description": "Free-text notes printed on the invoice, e.g. payment instructions. Default empty."
},
"due_in_days": {
"type": "number",
"description": "Payment term in days from today; sets due_date and 'Net N' terms. Default 14."
}
},
"required": [
"business_name",
"client_name",
"items"
]
}Output Schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The invoice rendered as multi-line plain text."
}
},
"required": [
"text"
]
}Community
Evidence
Recent observations
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools