gst-india-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GST_GSTIN | No | Your GSTIN (for taxpayer tools) | |
| GST_API_KEY | Yes | Sandbox API key (key_test_… / key_live_…) | |
| GST_BASE_URL | No | API base (default https://api.sandbox.co.in) | https://api.sandbox.co.in |
| GST_USERNAME | No | GST portal username (for taxpayer tools) | |
| GST_API_SECRET | Yes | Sandbox API secret | |
| GST_API_VERSION | No | API version (default 1.0) | 1.0 |
| GST_TAXPAYER_TOKEN | No | Optional pre-obtained 6h taxpayer token (skips OTP) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| verify_gstinA | Verify a GST-registered business by its 15-character GSTIN. Returns legal/trade name, status, taxpayer type, constitution, e-invoice enablement, and registered address. No taxpayer session required. |
| search_gstin_by_panA | Find all GSTINs registered against a PAN across states. Useful to discover a business's registrations. No taxpayer session required. |
| track_gst_returnsA | Check the GST return filing status/history for a GSTIN (GSTR-1, GSTR-3B, etc.). Optionally filter by financial year (e.g. 2025-26). No taxpayer session required. |
| taxpayer_generate_otpA | Step 1 of a taxpayer session. Sends an OTP to the taxpayer's GST-registered mobile/email. Uses GST_USERNAME/GST_GSTIN from config unless overridden. Requires API access enabled on gst.gov.in. |
| taxpayer_verify_otpA | Step 2 of a taxpayer session. Verifies the OTP and starts a ~6-hour taxpayer session held in memory for subsequent taxpayer_* / get_gstr* / ledger tools. |
| taxpayer_session_statusA | Reports whether an active taxpayer session exists in this server process. |
| get_gstr3bA | Fetch GSTR-3B (monthly summary return) details for a return period. Requires an active taxpayer session. |
| get_gstr2bA | Fetch GSTR-2B (auto-drafted ITC statement of purchases) for a return period. Requires an active taxpayer session. |
| track_returns_currentA | List the authenticated taxpayer's filed/pending returns for a return period. Requires an active taxpayer session. |
| get_annual_turnoverA | Fetch the authenticated taxpayer's Annual Aggregate Turnover values. Requires an active taxpayer session. |
| get_ledger_balanceB | Fetch the taxpayer's Cash and ITC ledger balances as on a return period (year/month). Requires an active taxpayer session. |
| get_cash_ledgerA | Fetch the electronic cash ledger transactions for a date range. Requires an active taxpayer session. |
| get_itc_ledgerA | Fetch the electronic Input Tax Credit (ITC) ledger transactions for a date range. Requires an active taxpayer session. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Most tools have distinct purposes: public GSTIN/PAN lookup, taxpayer session OTP flow, return-specific fetches, and ledger queries are clearly separated. Minor overlap exists between track_gst_returns and track_returns_current, and between get_ledger_balance versus get_cash_ledger/get_itc_ledger, but the descriptions sufficiently clarify the difference.
The naming is mostly predictable with verb-first patterns like verify_, search_, track_, and get_. The taxpayer_ prefixed OTP methods are consistent, though taxpayer_session_status breaks the verb pattern and there is minor inconsistency between track_/get_ prefixes for return-related tools.
Thirteen tools is a reasonable, well-scoped set for the GST India domain. Each tool covers a distinct public lookup, taxpayer session step, return retrieval, or ledger access function, and none feel redundant or excessive.
The surface covers the core GST workflows: GSTIN verification, PAN-based registration discovery, return status tracking, taxpayer session management, GSTR-2B/3B fetching, turnover, and ledger access. Minor gaps exist such as no GSTR-1 fetch, no explicit session logout, and limited return-period detail for some tools, but these do not cripple the main use cases.