gstinapi-mcp

Name: gstinapi-mcp
Author: CsoftTarun

本地服务

github.com/CsoftTarun金融数据01 天前更新

代码仓库

关于 gstinapi-mcp

gstinapi-mcp 将 gstinapi.in 的 REST API 封装为 MCP 服务，供需要查询印度 GST 信息的用户使用。它可实时核验 GSTIN、查询申报合规历史及查找 HSN/SAC 编码，调用结果直接返回 API 响应。

主要功能

01实时查询 GSTIN 注册信息
02查询 GST 申报历史与合规情况
03查看月度或季度申报偏好
04按编码或描述查找 HSN/SAC
05查询 API 密钥当日调用量

适用场景

01核验企业 GSTIN 注册状态与地址
02查看指定财年的申报记录
03根据商品描述查找 HSN/SAC 编码

MCP 相关

该 MCP 服务向 MCP 客户端提供 GSTIN 核验、申报与合规历史、HSN/SAC 查询及用量统计工具。每次调用均通过认证 HTTP 请求访问 gstinapi.in REST API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "csofttarun-gstinapi": {
      "command": "npx",
      "args": [
        "-y",
        "gstinapi-mcp"
      ],
      "env": {
        "GSTINAPI_API_KEY": "<GSTINAPI_API_KEY>"
      }
    }
  }
}

启动命令npx -y gstinapi-mcp

需要配置的环境变量

GSTINAPI_API_KEY密钥Your gstinapi.in API key. Free at https://www.gstinapi.in/register — up to 100 free lookups, no card required.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmgstinapi-mcp1.0.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
gstin	string	是	15 位字符的 GSTIN，例如 27AAPFU0939F1ZV
include_profile	boolean	否

详细介绍

gstinapi-mcp

一个适用于 gstinapi.in 的 MCP 服务，可查询 GSTIN、GST 申报／合规历史记录以及 HSN/SAC 编码，并可直接从 Claude 和其他 MCP 客户端调用。

这是对 gstinapi.in/docs 中 REST API 的轻量封装，不包含自身逻辑——每次工具调用都会发送一个经过身份验证的 HTTP 请求，并原样返回响应。

设置

获取免费 API 密钥——最多可免费查询 100 次（注册时 25 次，完成三个设置步骤时各获 25 次），无需银行卡：https://www.gstinapi.in/register
将此服务添加到 MCP 客户端配置中，例如 Claude Desktop / Claude Code 的配置（claude_desktop_config.json 或 .mcp.json）：

{
  "mcpServers": {
    "gstinapi": {
      "command": "npx",
      "args": ["-y", "gstinapi-mcp"],
      "env": {
        "GSTINAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

无需安装步骤——首次使用时，npx 会获取它。

工具

工具	功能
`verify_gstin`	实时查询注册信息：法定名称、状态、纳税人类型、地址
`get_gstin_returns`	查询某一财年的 GSTR-1/3B 申报历史记录
`get_gstin_compliance`	汇总申报历史记录：次数、延迟情况、最近申报期
`get_gstin_filing_preference`	按季度查询按月或按季度（QRMP）申报偏好
`lookup_hsn_code`	查询 HSN/SAC 编码的官方说明
`search_hsn_codes`	根据说明查找 HSN/SAC 编码
`get_usage_stats`	查询该密钥今日的调用次数（免费）