calculate_gst
Compute GST breakdown with CGST/SGST or IGST split and optional cess for invoices, quotations, and compliance; supports back-calculating base from inclusive amounts.
Instructions
Calculate GST breakdown with CGST/SGST/IGST split and optional cess.
Use when computing tax for invoices, quotations, or GST compliance.
Args: amount: Base amount or GST-inclusive amount in rupees. gst_rate: Valid GST rate percentage. transaction_type: 'intra_state' or 'inter_state'. amount_includes_gst: Set True to back-calculate base. cess_category: For 28% items, specify applicable cess.
Returns: Standard envelope with base amount, CGST/SGST/IGST breakdown, cess amount, total GST, and total payable amount.
Notes: Rates are for general reference. Actual classification may vary.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"amount": "<amount>",
"gst_rate": "<gst_rate>",
"transaction_type": "<transaction_type>"
},
"name": "calculate_gst"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Base amount in rupees (or inclusive amount if flagged) | |
| gst_rate | Yes | GST rate as percentage: 0, 0.1, 0.25, 1.5, 3, 5, 12, 18, 28 | |
| cess_category | No | Cess category for 28% items. Default: 'default' (no cess) | default |
| financial_year | No | Financial year (e.g. '2025-26', '2026-27') | 2025-26 |
| transaction_type | Yes | 'intra_state' (CGST+SGST) or 'inter_state' (IGST) | |
| amount_includes_gst | No | If True, back-calculate base from GST-inclusive amount |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||