GST Insights API MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Host (Not applicable) | |
| PORT | No | Port (Not applicable) | |
| API_KEY | Yes | The API key required for authentication. |
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
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_gst_details_using_gst_numberA | Endpoint: /getGSTDetailsUsingGST/:gst Method: GET Description: Fetches GST details using the provided GST number. Parameters: gst (string, required): A valid GST number (15 characters). Responses: 200 OK: Returns GST details along with a timestamp. 400 Bad Request: Invalid GST number. 500 Internal Server Error: An error occurred on the server. Example Request: |
| get_gst_details_using_panA | Endpoint: /getGSTDetailsUsingPAN/:pan Method: GET Description: Fetches GST details using the provided PAN number. Parameters: pan (string, required): A valid PAN number (10 characters). Responses: 200 OK: Returns GST details along with a timestamp. 400 Bad Request: Invalid PAN number. 500 Internal Server Error: An error occurred on the server. Example Request: |
| get_gst_statusB | Endpoint: /getGSTStatus/:gst Method: GET Description: Retrieves the status of the provided GST number. Parameters: gst (string, required): A valid GST number (15 characters). Responses: 200 OK: Returns GST status along with a timestamp. 400 Bad Request: Invalid GST number. 500 Internal Server Error: An error occurred on the server. |
| get_gst_return_filing_status_for_a_specific_yearA | Endpoint: /getGSTReturnFilingStatusSpecificYear/:gst/:year Method: GET Description: Fetches the GST return filing status for a specific year using the provided GST number. Parameters: gst (string, required): A valid GST number (15 characters). year (string, required): The year for which the status is to be fetched. Responses: 200 OK: Returns GST return filing status for the specific year along with a timestamp. 400 Bad Request: Invalid GST number or year. 500 Internal Server Error: An er... |
| get_address_using_gstA | Endpoint: /getAddressUsingGST/:gst Method: GET Description: Retrieves the address associated with the provided GST number. Parameters: gst (string, required): A valid GST number (15 characters). Responses: 200 OK: Returns the address associated with the GST number along with a timestamp. 400 Bad Request: Invalid GST number. 500 Internal Server Error: An error occurred on the server. |
| get_gst_return_filing_statusA | Endpoint: /getGSTReturnFilingStatus/:gst Method: GET Description: Fetches the GST return filing status of the provided GST number. Parameters: gst (string, required): A valid GST number (15 characters). Responses: 200 OK: Returns GST return filing status along with a timestamp. 400 Bad Request: Invalid GST number. 500 Internal Server Error: An error occurred on the server. Example Request: |
| validate_gst_numberA | Endpoint: /validateGSTNumber/:gst Method: GET Description: Validates the provided GST number. Parameters: gst (string, required): A valid GST number (15 characters). Responses: 200 OK: Returns validation results along with a timestamp. 400 Bad Request: Invalid GST number. 500 Internal Server Error: An error occurred on the server. |
| get_gst_details_using_company_nameC | Endpoint: /getGSTDetailsUsingCompanyName/:companyName Method: GET Description: Fetches GST details using the provided company name. Parameters: companyName (string, required): The name of the company. Responses: 200 OK: Returns GST details along with a timestamp. 400 Bad Request: Invalid company name. 500 Internal Server Error: An error occurred on the server. Example Request: |
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 8 tools
Each tool has a distinct purpose (address, details, status, validation, return filing), but there is potential confusion between 'get_gst_details_using_gst_number' and 'get_gst_status' as both use a GST number but return different data. The descriptions help, but an agent might misselect if not careful.
All tools follow a consistent snake_case pattern with verbs 'get' or 'validate', and parameters are clearly described in the name (e.g., get_gst_details_using_company_name). The naming is predictable and easy to understand.
With 8 tools, the server covers the core GST lookup functionalities (by GST, PAN, company name, address, status, validation, return filing) without being excessive or sparse. The number is appropriate for a focused GST insights API.
The tool set covers common queries for GST insights, including multiple lookup methods and filing status. However, it lacks tools for e-invoice or e-way bill queries, which are related features. Minor gap, but overall the surface is well-rounded.