Fast GST Refund
Prepare Indian GST refund records, validate entries and generate Statement 3 and Annexure B JSON.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~4,941Tokens (tool definitions)
~4.1 KBTypical response size
Significant attention impact (3.86% 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": {
"fast-gst-refund": {
"url": "https://fastgstrefund.com/mcp"
}
}
}Remote endpoints
https://fastgstrefund.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_refund_checklist(stage, need)
Returns the records to gather, the checks to make, the next step and the relevant guides for one stage of a service-export GST refund claim and one preparation topic. Use it when someone asks what to prepare or check.
Input Schema
{
"type": "object",
"properties": {
"stage": {
"type": "string",
"enum": [
"preparing",
"upload",
"filed",
"notice"
]
},
"need": {
"type": "string",
"enum": [
"eligibility",
"statement3",
"annexureb",
"reconciliation",
"portal",
"fullpack"
]
}
},
"required": [
"stage",
"need"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"stage": {
"type": "string"
},
"stageLabel": {
"type": "string"
},
"need": {
"type": "string"
},
"needLabel": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"records": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"name",
"reason"
],
"additionalProperties": true
}
},
"checks": {
"type": "array",
"items": {
"type": "string"
}
},
"nextStep": {
"type": "string"
},
"guides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url"
],
"additionalProperties": true
}
},
"scope": {
"type": "string"
},
"createFiles": {
"type": "string"
}
},
"required": [
"stage",
"need",
"title",
"summary",
"records",
"checks",
"nextStep"
],
"additionalProperties": true
}🟢search_refund_guides(query, limit)
Finds Fast GST Refund's public guides by preparation topic and returns their slugs, titles and descriptions. Takes general keywords; it does not need taxpayer identifiers or document contents.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"pattern": "^[a-zA-Z0-9 \\-?]+$"
},
"limit": {
"default": 5,
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"guides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"url": {
"type": "string"
},
"sourcesChecked": {
"type": "string"
}
},
"required": [
"slug",
"title",
"url"
],
"additionalProperties": true
}
}
},
"required": [
"guides"
],
"additionalProperties": true
}🟢read_refund_guide(slug)
Returns one public guide as Markdown, with its source links and the date its sources were checked. Takes a slug from search_refund_guides.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-z0-9-]+$"
}
},
"required": [
"slug"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"topic": {
"type": "string"
},
"checked": {
"type": "string"
},
"url": {
"type": "string"
},
"markdown": {
"type": "string"
},
"createFiles": {
"type": "string"
}
},
"required": [
"slug",
"title",
"url",
"markdown"
],
"additionalProperties": true
}🟢explain_upload_error(document, issue)
Returns the documented checks and correction steps for one known problem with a Statement 3 or Annexure B file. Statement 3 issues: json_generation, receipt_allocation, corrected_retry, return_mismatch. Annexure B issues: duplicate_document, gstr2b_mismatch, reversals, json_generation.
Input Schema
{
"type": "object",
"properties": {
"document": {
"type": "string",
"enum": [
"statement3",
"annexureb"
]
},
"issue": {
"type": "string",
"enum": [
"json_generation",
"receipt_allocation",
"corrected_retry",
"return_mismatch",
"duplicate_document",
"gstr2b_mismatch",
"reversals"
]
}
},
"required": [
"document",
"issue"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"issue": {
"type": "string"
},
"title": {
"type": "string"
},
"checks": {
"type": "array",
"items": {
"type": "string"
}
},
"sourcesChecked": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
},
"nextStep": {
"type": "string"
}
},
"required": [
"document",
"issue",
"title",
"checks",
"nextStep"
],
"additionalProperties": true
}🟢check_receipt_allocation(invoices, receipts, allocations)
Checks how bank receipts are allocated to export invoices: arithmetic, duplicate allocations, missing row references, overallocated receipts and invoice balances. Takes anonymous row numbers and integer INR paise only; names, GSTINs and certificate numbers are not needed. Up to 200 invoices, 200 receipts and 1000 allocations.
Input Schema
{
"type": "object",
"properties": {
"invoices": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"amountPaise": {
"type": "integer",
"minimum": 1,
"maximum": 100000000000
}
},
"required": [
"row",
"amountPaise"
],
"additionalProperties": false
}
},
"receipts": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"amountPaise": {
"type": "integer",
"minimum": 1,
"maximum": 100000000000
}
},
"required": [
"row",
"amountPaise"
],
"additionalProperties": false
}
},
"allocations": {
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"invoiceRow": {
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"receiptRow": {
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"amountPaise": {
"type": "integer",
"minimum": 1,
"maximum": 100000000000
}
},
"required": [
"invoiceRow",
"receiptRow",
"amountPaise"
],
"additionalProperties": false
}
}
},
"required": [
"invoices",
"receipts",
"allocations"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"unit": {
"type": "string"
},
"arithmeticValid": {
"type": "boolean"
},
"invoiceBalances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "number"
},
"amountPaise": {
"type": "number"
},
"allocatedPaise": {
"type": "number"
},
"balancePaise": {
"type": "number"
}
},
"required": [
"row",
"amountPaise",
"allocatedPaise",
"balancePaise"
],
"additionalProperties": true
}
},
"receiptBalances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "number"
},
"amountPaise": {
"type": "number"
},
"allocatedPaise": {
"type": "number"
},
"balancePaise": {
"type": "number"
}
},
"required": [
"row",
"amountPaise",
"allocatedPaise",
"balancePaise"
],
"additionalProperties": true
}
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code"
],
"additionalProperties": true
}
},
"summary": {
"type": "object",
"properties": {
"invoicePaise": {
"type": "number"
},
"receiptPaise": {
"type": "number"
},
"allocatedPaise": {
"type": "number"
},
"invoicesWithBalance": {
"type": "number"
},
"receiptsWithBalance": {
"type": "number"
}
},
"additionalProperties": true
},
"nextStep": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"arithmeticValid",
"invoiceBalances",
"receiptBalances",
"issues"
],
"additionalProperties": true
}🟢get_statement3_requirements
Returns the fields of the Statement 3 JSON for a GST refund of accumulated ITC on exports without payment of tax (RFD-01), the file the GST portal otherwise requires from its Excel offline utility, and where each value comes from: export invoices and notes, bank BRC/FIRC rows, and shipping details for goods. Takes no input. Use it before validate_statement3 to learn which fields to collect.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"generatorVersion": {
"type": "string"
},
"utility": {
"type": "string"
},
"utilityVersion": {
"type": "string"
},
"jsonVersion": {
"type": "string"
},
"sha256": {
"type": "string"
},
"scope": {
"type": "string"
},
"workflow": {
"type": "array",
"items": {
"type": "string"
}
},
"accepted": {
"type": "object",
"properties": {
"amounts": {
"type": "string"
},
"dates": {
"type": "string"
},
"periods": {
"type": "string"
},
"existingFiles": {
"type": "string"
}
},
"additionalProperties": true
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"fields",
"source"
],
"additionalProperties": true
}
},
"fieldRulesBySupplyType": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": true
}
},
"checks": {
"type": "string"
},
"limits": {
"type": "object",
"properties": {
"rowsPerFile": {
"type": "number"
},
"requestBytes": {
"type": "number"
},
"splitUploads": {
"type": "string"
}
},
"additionalProperties": true
},
"notIncluded": {
"type": "string"
},
"inputSchema": {
"type": "object",
"additionalProperties": true
},
"references": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"document",
"workflow",
"sources",
"inputSchema"
],
"additionalProperties": true
}🟢validate_statement3(data)
Checks records for the Statement 3 JSON for a GST refund of accumulated ITC on exports without payment of tax (RFD-01), the file the GST portal otherwise requires from its Excel offline utility. Applies the offline utility's own checks and returns every error and warning at once, with its row and field. Free; needs no sign-in; stores nothing. A file made by the official utility can be passed as data unchanged.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"additionalProperties": true,
"description": "The document's fields, as its requirements tool lists them, or a JSON file from the official utility unchanged."
}
},
"required": [
"data"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"inputFormat": {
"type": "string"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"generatorVersion": {
"type": "string"
},
"utilityVersion": {
"type": "string"
},
"jsonVersion": {
"type": "string"
},
"summary": {
"type": "object",
"additionalProperties": true
},
"claim": {
"type": "object",
"properties": {
"gstin": {
"type": "string"
},
"fromFp": {
"type": "string"
},
"toFp": {
"type": "string"
},
"paid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"message": {
"type": "string"
},
"nextStep": {
"type": "string"
}
},
"required": [
"document",
"valid",
"errors",
"warnings"
],
"additionalProperties": true
}🔴generate_statement3(data, link, direct)
Creates the Statement 3 JSON for a GST refund of accumulated ITC on exports without payment of tax (RFD-01), the file the GST portal otherwise requires from its Excel offline utility, from records that pass validate_statement3. Returns openUrl, a link the user opens in a browser to sign in by email, pay once per GSTIN and refund period, and download; the checked records are stored behind the link for 24 hours. With a connected account that has paid, it returns the file. The tool takes no GST portal password or OTP.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"additionalProperties": true,
"description": "The document's fields, as its requirements tool lists them, or a JSON file from the official utility unchanged."
},
"link": {
"type": "string",
"maxLength": 300,
"description": "The openUrl from the other generate tool's result, so that one link holds both files."
},
"direct": {
"type": "boolean",
"description": "true to have the file returned to this client. It needs the user's Fast GST Refund account to be connected; if it is not, the client is asked to sign in. Leave out unless the user asked for the file here."
}
},
"required": [
"data"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"inputFormat": {
"type": "string"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"generatorVersion": {
"type": "string"
},
"utilityVersion": {
"type": "string"
},
"jsonVersion": {
"type": "string"
},
"summary": {
"type": "object",
"additionalProperties": true
},
"claim": {
"type": "object",
"properties": {
"gstin": {
"type": "string"
},
"fromFp": {
"type": "string"
},
"toFp": {
"type": "string"
},
"paid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"message": {
"type": "string"
},
"nextStep": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"open_link",
"payment_required",
"file_ready"
]
},
"openUrl": {
"type": "string"
},
"expiresAt": {
"type": "string"
},
"documents": {
"type": "array",
"items": {
"type": "string"
}
},
"linkStatus": {
"type": "string"
},
"linkNote": {
"type": "string"
},
"file": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"filename": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"bytes": {
"type": "number"
},
"sha256": {
"type": "string"
},
"downloadUrl": {
"type": "string"
},
"mcpUri": {
"type": "string"
},
"expiresAt": {
"type": "string"
},
"content": {
"type": "string"
}
},
"required": [
"id",
"filename",
"sha256",
"downloadUrl"
],
"additionalProperties": true
}
},
"required": [
"document",
"valid",
"status"
],
"additionalProperties": true
}🟢get_annexure_b_requirements
Returns the fields of the Annexure B JSON (statement of inward-supply invoices) for a GST refund of accumulated ITC (RFD-01), the file the GST portal otherwise requires from its Excel offline utility, and where each value comes from: purchase documents, tax amounts, the GSTR-2B period, reviewed ITC eligibility and the eight GSTR-3B reversal totals, with the fields each supply type leaves empty. Takes no input. Use it before validate_annexure_b to learn which fields to collect.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"generatorVersion": {
"type": "string"
},
"utility": {
"type": "string"
},
"utilityVersion": {
"type": "string"
},
"jsonVersion": {
"type": "string"
},
"sha256": {
"type": "string"
},
"scope": {
"type": "string"
},
"workflow": {
"type": "array",
"items": {
"type": "string"
}
},
"accepted": {
"type": "object",
"properties": {
"amounts": {
"type": "string"
},
"dates": {
"type": "string"
},
"periods": {
"type": "string"
},
"existingFiles": {
"type": "string"
}
},
"additionalProperties": true
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fields": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"fields",
"source"
],
"additionalProperties": true
}
},
"fieldRulesBySupplyType": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": true
}
},
"checks": {
"type": "string"
},
"limits": {
"type": "object",
"properties": {
"rowsPerFile": {
"type": "number"
},
"requestBytes": {
"type": "number"
},
"splitUploads": {
"type": "string"
}
},
"additionalProperties": true
},
"notIncluded": {
"type": "string"
},
"inputSchema": {
"type": "object",
"additionalProperties": true
},
"references": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"document",
"workflow",
"sources",
"inputSchema"
],
"additionalProperties": true
}🟢validate_annexure_b(data)
Checks records for the Annexure B JSON (statement of inward-supply invoices) for a GST refund of accumulated ITC (RFD-01), the file the GST portal otherwise requires from its Excel offline utility. Applies the offline utility's own checks and returns every error and warning at once, with its row and field. Free; needs no sign-in; stores nothing. A file made by the official utility can be passed as data unchanged. ITC eligibility, reversal amounts and GSTR-2B periods come from the taxpayer's reviewed records; the tool does not infer them.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"additionalProperties": true,
"description": "The document's fields, as its requirements tool lists them, or a JSON file from the official utility unchanged."
}
},
"required": [
"data"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"inputFormat": {
"type": "string"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"generatorVersion": {
"type": "string"
},
"utilityVersion": {
"type": "string"
},
"jsonVersion": {
"type": "string"
},
"summary": {
"type": "object",
"additionalProperties": true
},
"claim": {
"type": "object",
"properties": {
"gstin": {
"type": "string"
},
"fromFp": {
"type": "string"
},
"toFp": {
"type": "string"
},
"paid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"message": {
"type": "string"
},
"nextStep": {
"type": "string"
}
},
"required": [
"document",
"valid",
"errors",
"warnings"
],
"additionalProperties": true
}🔴generate_annexure_b(data, link, direct)
Creates the Annexure B JSON (statement of inward-supply invoices) for a GST refund of accumulated ITC (RFD-01), the file the GST portal otherwise requires from its Excel offline utility, from records that pass validate_annexure_b. Returns openUrl, a link the user opens in a browser to sign in by email, pay once per GSTIN and refund period, and download; the checked records are stored behind the link for 24 hours. With a connected account that has paid, it returns the file. The tool takes no GST portal password or OTP. ITC eligibility, reversal amounts and GSTR-2B periods come from the taxpayer's reviewed records; the tool does not infer them.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"additionalProperties": true,
"description": "The document's fields, as its requirements tool lists them, or a JSON file from the official utility unchanged."
},
"link": {
"type": "string",
"maxLength": 300,
"description": "The openUrl from the other generate tool's result, so that one link holds both files."
},
"direct": {
"type": "boolean",
"description": "true to have the file returned to this client. It needs the user's Fast GST Refund account to be connected; if it is not, the client is asked to sign in. Leave out unless the user asked for the file here."
}
},
"required": [
"data"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"document": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"inputFormat": {
"type": "string"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"path",
"code",
"message"
],
"additionalProperties": true
}
},
"generatorVersion": {
"type": "string"
},
"utilityVersion": {
"type": "string"
},
"jsonVersion": {
"type": "string"
},
"summary": {
"type": "object",
"additionalProperties": true
},
"claim": {
"type": "object",
"properties": {
"gstin": {
"type": "string"
},
"fromFp": {
"type": "string"
},
"toFp": {
"type": "string"
},
"paid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"message": {
"type": "string"
},
"nextStep": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"open_link",
"payment_required",
"file_ready"
]
},
"openUrl": {
"type": "string"
},
"expiresAt": {
"type": "string"
},
"documents": {
"type": "array",
"items": {
"type": "string"
}
},
"linkStatus": {
"type": "string"
},
"linkNote": {
"type": "string"
},
"file": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"filename": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"bytes": {
"type": "number"
},
"sha256": {
"type": "string"
},
"downloadUrl": {
"type": "string"
},
"mcpUri": {
"type": "string"
},
"expiresAt": {
"type": "string"
},
"content": {
"type": "string"
}
},
"required": [
"id",
"filename",
"sha256",
"downloadUrl"
],
"additionalProperties": true
}
},
"required": [
"document",
"valid",
"status"
],
"additionalProperties": true
}Community
Evidence
Recent observations
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools
verifiedversion not recorded5 tools