generate_taxpayer_session
Generate a 6-hour taxpayer access token to securely authenticate GSTR-1 filing. Pass this token to all subsequent GSTR-1 API calls.
Instructions
Generate a taxpayer session (access token) valid for 6 hours.
This is Step 1 of the GSTR-1 filing workflow. The returned access_token must be passed to all subsequent tool calls.
Args: gstin: 15-digit GST Identification Number (e.g. "29AAACQ3770E000") username: GST portal username of the taxpayer
Returns: Dict with access_token and session metadata, or an error dict.
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": {
"gstin": "<gstin>",
"username": "<username>"
},
"name": "generate_taxpayer_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gstin | Yes | ||
| username | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |