LuckPanda Document Tools
Create invoices, quotes, receipts and credit notes with GST or VAT, as prefilled links or PDFs.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~6,368Tokens (tool definitions)
~7.2 KBTypical response size
Significant attention impact (4.98% 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": {
"tools": {
"url": "https://luckpanda.app/mcp/public"
}
}
}Remote endpoints
https://luckpanda.app/mcp/publicstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_tools(query, document_type, country)
Lists the document pages on luckpanda.app (generators for invoices, quotes, proforma invoices, receipts and credit notes, plus country and trade templates) and its calculator pages, each with its URL. Optional filters: document_type, country, query. Read-only.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Words to look for in a page's name or summary, e.g. \"freelance\" or \"GST\"."
},
"document_type": {
"type": "string",
"enum": [
"invoice",
"quote",
"proforma",
"credit_note",
"receipt"
],
"description": "The kind of document."
},
"country": {
"type": "string",
"description": "ISO alpha-2: pages for this country plus the ones for any country."
}
}
}Output Schema
{
"type": "object",
"properties": {
"documents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"document_type": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
],
"description": "ISO alpha-2, or null for a page that fits any country."
},
"summary": {
"type": "string"
},
"page_url": {
"type": "string",
"description": "The page, which also opens prefilled with ?doc=."
}
},
"required": [
"name",
"slug",
"document_type",
"country",
"summary",
"page_url"
]
}
},
"calculators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"page_url": {
"type": "string"
},
"api_url": {
"type": "string"
},
"mcp_tool": {
"type": "string"
}
},
"required": [
"name",
"slug",
"page_url"
]
}
},
"docs_url": {
"type": "string",
"description": "Public page describing this server and its tools."
}
},
"required": [
"documents",
"calculators"
]
}🟢get_document_rules(document_type, country)
Returns what to collect before creating a document of a given type and country: required, recommended and optional fields, the tax ID and tax names, the country's invoicing rules (for example India GST rule 46, UK VAT invoice contents), the CGST/SGST versus IGST split and state codes for India, and credit-note reasons. Read-only.
Input Schema
{
"type": "object",
"properties": {
"document_type": {
"type": "string",
"enum": [
"invoice",
"quote",
"proforma",
"credit_note",
"receipt"
],
"description": "The kind of document."
},
"country": {
"type": "string",
"description": "ISO alpha-2 of the seller, e.g. IN, US, GB, DE."
}
},
"required": [
"document_type",
"country"
]
}Output Schema
{
"type": "object",
"properties": {
"document_type": {
"type": "string"
},
"country": {
"type": "string"
},
"country_name": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"formats": {
"type": "object",
"properties": {
"money": {
"type": "string"
},
"date": {
"type": "string"
}
},
"required": [
"money",
"date"
]
},
"tax": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"seller_tax_id": {
"type": "string"
},
"seller_tax_id_example": {
"type": "string"
},
"vat_country": {
"type": "boolean"
}
},
"required": [
"name",
"seller_tax_id"
]
},
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"need": {
"type": "string",
"enum": [
"required",
"recommended",
"optional"
]
},
"note": {
"type": "string"
}
},
"required": [
"field",
"need"
]
}
},
"what_to_include": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"what": {
"type": "string"
}
},
"required": [
"field",
"what"
]
}
},
"rules": {
"type": "array",
"items": {
"type": "string"
}
},
"gst": {
"type": "object",
"properties": {},
"required": [],
"description": "India only: the CGST/SGST versus IGST split, place of supply and state codes."
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"code",
"label"
]
},
"description": "Credit notes only."
},
"disclaimer": {
"type": "string"
}
},
"required": [
"document_type",
"country",
"currency",
"tax",
"fields",
"rules",
"disclaimer"
]
}🟡create_document_link(page, doc)
Validates a document (invoice, quote, proforma invoice, receipt or credit note) and returns editor_url, a short link that opens it prefilled in the LuckPanda editor, where the person can review, edit and download the PDF. Also returns the totals with tax worked out, the required fields still missing and any parts left out as invalid. Side effect: the document is stored on LuckPanda's servers for 7 days under a random link id (not listed or indexed), and every call creates a new link. Nothing is issued, numbered or sent. Use details the person gave; do not invent them.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "string",
"description": "The page to open: a slug (\"credit-note\", \"gst-invoice-format\") or its URL. Default: the generator for the document type and country."
},
"doc": {
"type": "object",
"description": "A document to prefill. Parts that fail validation are left out and listed in `ignored`; nothing is ever rendered as HTML.",
"properties": {
"kind": {
"type": "string",
"enum": [
"invoice",
"quote",
"proforma",
"credit_note",
"receipt"
],
"description": "Document type."
},
"country_code": {
"type": "string",
"enum": [
"US",
"GB",
"DE",
"FR",
"NL",
"IE",
"AE",
"SG",
"AU",
"CA",
"IN",
"ES",
"IT",
"BE",
"AT",
"PT",
"FI",
"MX",
"BR"
],
"description": "The seller's country: decides currency, formats and tax rules. If missing: the currency's country (INR -> IN, GBP -> GB …; EUR -> DE unless the caller is in a euro country), else the caller's country."
},
"currency": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"INR",
"AED",
"SGD",
"AUD",
"CAD",
"MXN",
"BRL"
],
"description": "ISO 4217 code. If missing: the seller country's currency."
},
"seller": {
"type": "object",
"description": "Your business (who issues the document; for a receipt, who received the money).",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"address": {
"type": "string",
"maxLength": 600,
"description": "New lines as \\n."
},
"email": {
"type": "string",
"maxLength": 200
},
"tax_id": {
"type": "string",
"maxLength": 60,
"description": "GSTIN (India), VAT number (UK/EU), EIN (US), ABN, TRN..."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Buyer only; the seller's country is the document's country_code."
},
"state_code": {
"type": "string",
"description": "India: two-digit GST state code or the state name."
}
}
},
"buyer": {
"type": "object",
"description": "The client (for a receipt, who paid).",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"address": {
"type": "string",
"maxLength": 600,
"description": "New lines as \\n."
},
"email": {
"type": "string",
"maxLength": 200
},
"tax_id": {
"type": "string",
"maxLength": 60,
"description": "GSTIN (India), VAT number (UK/EU), EIN (US), ABN, TRN..."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Buyer only; the seller's country is the document's country_code."
},
"state_code": {
"type": "string",
"description": "India: two-digit GST state code or the state name."
}
}
},
"issue_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD. Default: today."
},
"due_date": {
"type": [
"string",
"null"
],
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Due date; for a quote, valid until."
},
"lines": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"maxLength": 500
},
"quantity": {
"type": [
"string",
"number"
],
"description": "Decimal, up to 6 decimals (\"1\", \"2.5\")."
},
"unit_price_minor": {
"type": "integer",
"minimum": 0,
"description": "Price per unit in minor units (cents, paise)."
},
"unit_price": {
"type": [
"string",
"number"
],
"description": "Alternative: price per unit in major units (\"1250.50\")."
},
"tax_rate_bp": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Tax rate in basis points: 18% = 1800."
},
"tax_percent": {
"type": [
"string",
"number"
],
"description": "Alternative: tax rate in percent (18)."
},
"unit_code": {
"type": "string",
"description": "unit | hour | day | month | item"
},
"discount_minor": {
"type": "integer",
"minimum": 0
},
"hsn_sac": {
"type": "string",
"description": "India: HSN (goods, 4/6/8 digits) or SAC (services, 6 digits starting 99)."
}
}
},
"description": "The items or services, 1 to 100 lines."
},
"notes": {
"type": "string",
"maxLength": 2000,
"description": "Shown on the document, for example a thank-you or a delivery note."
},
"terms": {
"type": "string",
"maxLength": 2000,
"description": "Payment terms and bank details; for a quote, validity and delivery terms."
},
"place_of_supply": {
"type": "string",
"description": "India: GST state code, or 96 for another country."
},
"export_type": {
"type": "string",
"enum": [
"none",
"lut",
"with_payment"
],
"description": "India, buyer abroad."
},
"original_invoice_number": {
"type": "string",
"maxLength": 40,
"description": "Credit notes: the invoice it corrects."
},
"original_invoice_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reason": {
"type": "string",
"description": "Credit notes: refund, product_return, discount, price_correction, defect, cancellation, tax_correction, other, or the reason in your own words."
},
"reason_note": {
"type": "string",
"maxLength": 500
}
}
}
},
"required": [
"doc"
]
}Output Schema
{
"type": "object",
"properties": {
"editor_url": {
"type": "string",
"description": "Short link that opens the document prefilled in the LuckPanda editor. Valid until expires_at (7 days)."
},
"expires_at": {
"type": "string",
"description": "ISO 8601 time the link stops opening."
},
"page_url": {
"type": "string",
"description": "The editor page the link opens, without the document."
},
"prefill_url": {
"type": "string",
"description": "A self-contained link with the document in the URL; present only when it is short enough."
},
"document_type": {
"type": "string"
},
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"totals": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "ISO 4217 code."
},
"subtotal_minor": {
"type": "integer",
"description": "Before tax and discount, in minor units (cents, paise)."
},
"discount_minor": {
"type": "integer"
},
"tax_minor": {
"type": "integer"
},
"total_minor": {
"type": "integer",
"description": "Amount payable, in minor units."
},
"formatted": {
"type": "object",
"properties": {
"subtotal": {
"type": "string"
},
"tax": {
"type": "string"
},
"total": {
"type": "string"
}
},
"required": [
"subtotal",
"tax",
"total"
],
"description": "The amounts formatted for the document's country."
},
"tax_lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"rate_percent": {
"type": "number"
},
"amount": {
"type": "string"
}
},
"required": [
"name",
"rate_percent",
"amount"
]
}
},
"supply": {
"type": "string",
"description": "India: the kind of supply, when it is known."
}
},
"required": [
"currency",
"total_minor",
"formatted",
"tax_lines"
],
"description": "Totals with tax worked out."
},
"missing": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required fields still empty, as dotted paths (e.g. buyer.name, lines.0.description)."
},
"ignored": {
"type": "array",
"items": {
"type": "string"
},
"description": "Parts of the input that were left out because they were invalid, as dotted paths."
},
"docs_url": {
"type": "string",
"description": "Public page describing this server and its tools."
}
},
"required": [
"editor_url",
"expires_at",
"page_url",
"document_type",
"country",
"currency",
"totals",
"missing",
"ignored"
]
}🟡create_document_pdf(page, doc)
Generates a PDF of a document (invoice, quote, proforma invoice, receipt or credit note) and returns it base64-encoded in structuredContent.pdf_base64, with its verification URL and an editor_url that opens the same document in the editor. PDFs from this tool include a LuckPanda footer and a verification QR code. Side effects: stores a verification record for the PDF (issuer name, document type, date, currency and total; no client details) and a 7-day copy of the document behind editor_url. Limit: about 40 PDFs an hour per network.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "string",
"description": "The page to open: a slug (\"credit-note\", \"gst-invoice-format\") or its URL. Default: the generator for the document type and country."
},
"doc": {
"type": "object",
"description": "A document to prefill. Parts that fail validation are left out and listed in `ignored`; nothing is ever rendered as HTML.",
"properties": {
"kind": {
"type": "string",
"enum": [
"invoice",
"quote",
"proforma",
"credit_note",
"receipt"
],
"description": "Document type."
},
"country_code": {
"type": "string",
"enum": [
"US",
"GB",
"DE",
"FR",
"NL",
"IE",
"AE",
"SG",
"AU",
"CA",
"IN",
"ES",
"IT",
"BE",
"AT",
"PT",
"FI",
"MX",
"BR"
],
"description": "The seller's country: decides currency, formats and tax rules. If missing: the currency's country (INR -> IN, GBP -> GB …; EUR -> DE unless the caller is in a euro country), else the caller's country."
},
"currency": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"INR",
"AED",
"SGD",
"AUD",
"CAD",
"MXN",
"BRL"
],
"description": "ISO 4217 code. If missing: the seller country's currency."
},
"seller": {
"type": "object",
"description": "Your business (who issues the document; for a receipt, who received the money).",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"address": {
"type": "string",
"maxLength": 600,
"description": "New lines as \\n."
},
"email": {
"type": "string",
"maxLength": 200
},
"tax_id": {
"type": "string",
"maxLength": 60,
"description": "GSTIN (India), VAT number (UK/EU), EIN (US), ABN, TRN..."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Buyer only; the seller's country is the document's country_code."
},
"state_code": {
"type": "string",
"description": "India: two-digit GST state code or the state name."
}
}
},
"buyer": {
"type": "object",
"description": "The client (for a receipt, who paid).",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"address": {
"type": "string",
"maxLength": 600,
"description": "New lines as \\n."
},
"email": {
"type": "string",
"maxLength": 200
},
"tax_id": {
"type": "string",
"maxLength": 60,
"description": "GSTIN (India), VAT number (UK/EU), EIN (US), ABN, TRN..."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Buyer only; the seller's country is the document's country_code."
},
"state_code": {
"type": "string",
"description": "India: two-digit GST state code or the state name."
}
}
},
"issue_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD. Default: today."
},
"due_date": {
"type": [
"string",
"null"
],
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Due date; for a quote, valid until."
},
"lines": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"maxLength": 500
},
"quantity": {
"type": [
"string",
"number"
],
"description": "Decimal, up to 6 decimals (\"1\", \"2.5\")."
},
"unit_price_minor": {
"type": "integer",
"minimum": 0,
"description": "Price per unit in minor units (cents, paise)."
},
"unit_price": {
"type": [
"string",
"number"
],
"description": "Alternative: price per unit in major units (\"1250.50\")."
},
"tax_rate_bp": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Tax rate in basis points: 18% = 1800."
},
"tax_percent": {
"type": [
"string",
"number"
],
"description": "Alternative: tax rate in percent (18)."
},
"unit_code": {
"type": "string",
"description": "unit | hour | day | month | item"
},
"discount_minor": {
"type": "integer",
"minimum": 0
},
"hsn_sac": {
"type": "string",
"description": "India: HSN (goods, 4/6/8 digits) or SAC (services, 6 digits starting 99)."
}
}
},
"description": "The items or services, 1 to 100 lines."
},
"notes": {
"type": "string",
"maxLength": 2000,
"description": "Shown on the document, for example a thank-you or a delivery note."
},
"terms": {
"type": "string",
"maxLength": 2000,
"description": "Payment terms and bank details; for a quote, validity and delivery terms."
},
"place_of_supply": {
"type": "string",
"description": "India: GST state code, or 96 for another country."
},
"export_type": {
"type": "string",
"enum": [
"none",
"lut",
"with_payment"
],
"description": "India, buyer abroad."
},
"original_invoice_number": {
"type": "string",
"maxLength": 40,
"description": "Credit notes: the invoice it corrects."
},
"original_invoice_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reason": {
"type": "string",
"description": "Credit notes: refund, product_return, discount, price_correction, defect, cancellation, tax_correction, other, or the reason in your own words."
},
"reason_note": {
"type": "string",
"maxLength": 500
}
}
}
},
"required": [
"doc"
]
}Output Schema
{
"type": "object",
"properties": {
"file_name": {
"type": "string"
},
"content_type": {
"type": "string"
},
"size_bytes": {
"type": "integer"
},
"pages": {
"type": "integer"
},
"variant": {
"type": "string",
"description": "\"branded\": the PDF carries the LuckPanda footer and verification QR code."
},
"verify_code": {
"type": "string"
},
"verify_url": {
"type": "string",
"description": "Page that confirms the PDF was made by LuckPanda and shows what was printed on it."
},
"fingerprint": {
"type": "string"
},
"editor_url": {
"type": "string",
"description": "Short link that opens the same document in the LuckPanda editor (7 days). Omitted when the link limit is reached."
},
"totals": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "ISO 4217 code."
},
"subtotal_minor": {
"type": "integer",
"description": "Before tax and discount, in minor units (cents, paise)."
},
"discount_minor": {
"type": "integer"
},
"tax_minor": {
"type": "integer"
},
"total_minor": {
"type": "integer",
"description": "Amount payable, in minor units."
},
"formatted": {
"type": "object",
"properties": {
"subtotal": {
"type": "string"
},
"tax": {
"type": "string"
},
"total": {
"type": "string"
}
},
"required": [
"subtotal",
"tax",
"total"
],
"description": "The amounts formatted for the document's country."
},
"tax_lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"rate_percent": {
"type": "number"
},
"amount": {
"type": "string"
}
},
"required": [
"name",
"rate_percent",
"amount"
]
}
},
"supply": {
"type": "string",
"description": "India: the kind of supply, when it is known."
}
},
"required": [
"currency",
"total_minor",
"formatted",
"tax_lines"
],
"description": "Totals with tax worked out."
},
"missing": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required fields still empty, as dotted paths (e.g. buyer.name, lines.0.description)."
},
"ignored": {
"type": "array",
"items": {
"type": "string"
},
"description": "Parts of the input that were left out because they were invalid, as dotted paths."
},
"pdf_base64": {
"type": "string",
"description": "The PDF file, base64-encoded."
},
"docs_url": {
"type": "string",
"description": "Public page describing this server and its tools."
}
},
"required": [
"file_name",
"content_type",
"size_bytes",
"pages",
"verify_code",
"verify_url",
"totals",
"missing",
"ignored",
"pdf_base64"
]
}🟢calculate_gst(amount, rate, mode, supply)
GST on an amount in rupees: add GST to an amount before tax, or take it out of an amount that includes it; CGST + SGST for a supply within one state, IGST across states. Read-only arithmetic.
Input Schema
{
"type": "object",
"properties": {
"amount": {
"type": [
"number",
"string"
],
"description": "Amount in rupees, e.g. 10000."
},
"rate": {
"type": [
"number",
"string"
],
"description": "GST rate in percent; default 18."
},
"mode": {
"type": "string",
"enum": [
"add",
"remove"
],
"description": "add: the amount is before GST (default). remove: the amount includes GST."
},
"supply": {
"type": "string",
"enum": [
"intra",
"inter"
],
"description": "intra: within one state, CGST + SGST (default). inter: another state or an export, IGST."
}
},
"required": [
"amount"
]
}Output Schema
{
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"mode": {
"type": "string"
},
"supply": {
"type": "string"
},
"rate_percent": {
"type": "number"
},
"amount_before_gst": {
"type": "number"
},
"gst": {
"type": "number"
},
"amount_including_gst": {
"type": "number"
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"rate_percent": {
"type": "number"
},
"amount": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"name",
"rate_percent",
"amount"
]
}
},
"formatted": {
"type": "object",
"properties": {
"amount_before_gst": {
"type": "string"
},
"gst": {
"type": "string"
},
"amount_including_gst": {
"type": "string"
}
},
"required": [
"amount_before_gst",
"gst",
"amount_including_gst"
],
"description": "The amounts formatted for the currency's country."
},
"note": {
"type": "string"
}
},
"required": [
"currency",
"mode",
"supply",
"rate_percent",
"amount_before_gst",
"gst",
"amount_including_gst",
"components",
"formatted"
]
}🟢calculate_vat(amount, rate, mode, country)
VAT on an amount: add it to a net amount or take it out of a gross one. UK by default; EU countries and the UAE by country (standard rate if no rate is given). Read-only arithmetic.
Input Schema
{
"type": "object",
"properties": {
"amount": {
"type": [
"number",
"string"
],
"description": "Amount in the country's currency, e.g. 1000."
},
"rate": {
"type": [
"number",
"string"
],
"description": "VAT rate in percent; default the country's standard rate."
},
"mode": {
"type": "string",
"enum": [
"add",
"remove"
],
"description": "add: the amount is net (default). remove: the amount includes VAT."
},
"country": {
"type": "string",
"description": "GB (default), DE, FR, NL, IE, ES, IT, BE, AT, PT, FI or AE."
}
},
"required": [
"amount"
]
}Output Schema
{
"type": "object",
"properties": {
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"mode": {
"type": "string"
},
"rate_percent": {
"type": "number"
},
"standard_rate_percent": {
"type": "number"
},
"net": {
"type": "number"
},
"vat": {
"type": "number"
},
"gross": {
"type": "number"
},
"formatted": {
"type": "object",
"properties": {
"net": {
"type": "string"
},
"vat": {
"type": "string"
},
"gross": {
"type": "string"
}
},
"required": [
"net",
"vat",
"gross"
],
"description": "The amounts formatted for the currency's country."
}
},
"required": [
"country",
"currency",
"mode",
"rate_percent",
"net",
"vat",
"gross",
"formatted"
]
}🟢calculate_emi(principal, annual_rate, months, years, currency)
Monthly EMI on a reducing-balance loan, total interest, total payment and the year-by-year schedule. Read-only arithmetic.
Input Schema
{
"type": "object",
"properties": {
"principal": {
"type": [
"number",
"string"
],
"description": "Loan amount."
},
"annual_rate": {
"type": [
"number",
"string"
],
"description": "Yearly interest in percent, e.g. 9.5."
},
"months": {
"type": [
"number",
"string"
],
"description": "Loan term in months (1 to 600). Give months or years."
},
"years": {
"type": [
"number",
"string"
],
"description": "Loan term in years (up to 50). Used when months is not given."
},
"currency": {
"type": "string",
"description": "ISO 4217 code; default INR."
}
},
"required": [
"principal",
"annual_rate"
]
}Output Schema
{
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"locale": {
"type": "string"
},
"principal": {
"type": "number"
},
"annual_rate_percent": {
"type": "number"
},
"months": {
"type": "integer"
},
"emi": {
"type": "number"
},
"total_interest": {
"type": "number"
},
"total_payment": {
"type": "number"
},
"formatted": {
"type": "object",
"properties": {
"emi": {
"type": "string"
},
"total_interest": {
"type": "string"
},
"total_payment": {
"type": "string"
}
},
"required": [
"emi",
"total_interest",
"total_payment"
],
"description": "The amounts formatted for the currency's country."
},
"schedule_by_year": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"principal": {
"type": "number"
},
"interest": {
"type": "number"
},
"balance": {
"type": "number"
}
},
"required": [
"year",
"principal",
"interest",
"balance"
]
}
}
},
"required": [
"currency",
"principal",
"annual_rate_percent",
"months",
"emi",
"total_interest",
"total_payment",
"formatted",
"schedule_by_year"
]
}🟢check_gstin(gstin)
Checks that an Indian GSTIN is well formed (15 characters, state code, PAN, check character) and decodes the state and PAN. It makes no lookup and does not confirm that the registration exists or is active. Read-only.
Input Schema
{
"type": "object",
"properties": {
"gstin": {
"type": "string",
"description": "The 15-character GSTIN, e.g. 27AAPFU0939F1ZV."
}
},
"required": [
"gstin"
]
}Output Schema
{
"type": "object",
"properties": {
"gstin": {
"type": "string"
},
"valid_format": {
"type": "boolean"
},
"problem": {
"type": [
"string",
"null"
]
},
"state_code": {
"type": [
"string",
"null"
]
},
"state_name": {
"type": [
"string",
"null"
]
},
"pan": {
"type": [
"string",
"null"
]
},
"pan_holder_type": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"gstin",
"valid_format"
]
}🟢find_hsn_code(query, type, limit)
Searches HSN codes (goods) and SAC codes (services) by product or service words or by code digits, with the official description, the chapter and heading it sits under, and the GST rate where it has been checked against the rate notification (otherwise rate_percent is null: check the notification). Returns the dataset scope with every answer. India only.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Words (e.g. \"laptop\", \"legal services\") or 2 to 8 digits of a code."
},
"type": {
"type": "string",
"enum": [
"all",
"hsn",
"sac"
],
"description": "Goods (hsn), services (sac) or both (default)."
},
"limit": {
"type": [
"number",
"string"
],
"description": "At most 25; default 10."
}
},
"required": [
"query"
]
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"type": {
"type": "string"
},
"total": {
"type": "integer",
"description": "Matches found; results holds the best ones up to the limit."
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"HSN",
"SAC"
]
},
"level": {
"type": "string"
},
"description": {
"type": "string"
},
"rate_percent": {
"type": [
"number",
"null"
],
"description": "GST rate in percent where it was checked against the rate notification, otherwise null."
},
"rate_note": {
"type": [
"string",
"null"
]
},
"path": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"code",
"description"
]
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"href": {
"type": "string"
}
},
"required": [
"label",
"href"
]
}
}
},
"required": [
"code",
"kind",
"description",
"rate_percent"
]
}
},
"scope": {
"type": "string",
"description": "What the dataset covers and does not."
},
"as_of": {
"type": "string"
}
},
"required": [
"query",
"total",
"results",
"scope"
]
}Community
Evidence
Recent observations
verifiedversion not recorded9 tools