{
  "markdown": "# gstinapi-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server for [gstinapi.in](https://www.gstinapi.in) — GSTIN verification, GST return/compliance history, HSN/SAC code lookup, and India's MCA company registry, callable directly from Claude and other MCP clients.\n\nThis is a thin wrapper around the REST API at [gstinapi.in/docs](https://www.gstinapi.in/docs). It holds no logic of its own — every tool call is one authenticated HTTP request, and the response is returned as-is.\n\n## Setup\n\n1. Get a free API key — 100 lookups on signup, no card required: https://www.gstinapi.in/register\n2. Add this server to your MCP client config, e.g. for Claude Desktop / Claude Code (`claude_desktop_config.json` or `.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"gstinapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gstinapi-mcp\"],\n      \"env\": {\n        \"GSTINAPI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nNo install step — `npx` fetches it on first use.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `verify_gstin` | Live registration lookup: legal name, status, taxpayer type, address |\n| `get_gstin_returns` | GSTR-1/3B filing history for a financial year |\n| `get_gstin_compliance` | Filing history summarised — counts, lag, last period |\n| `get_gstin_filing_preference` | Monthly vs quarterly (QRMP), quarter by quarter |\n| `resolve_gstin_to_company` | Probable MCA company match for a GSTIN (not authoritative — see caveat below) |\n| `lookup_hsn_code` | Official description for an HSN/SAC code |\n| `search_hsn_codes` | Find HSN/SAC codes from a description |\n| `lookup_mca_company` | Company master data by CIN |\n| `search_mca_companies` | Fuzzy company name search |\n| `get_usage_stats` | Today's call count for the key (free) |\n\nFull field-level reference: https://www.gstinapi.in/docs\n\n## Accuracy notes\n\n- Every GSTIN lookup queries the GST network live — nothing is cached.\n- `resolve_gstin_to_company` is a **probabilistic** match, not an official mapping — no government dataset links a GSTIN to a CIN. Treat it as a scored guess (`high`/`medium`/`low` confidence), never as a confirmed fact.\n- No GST rate is returned from the HSN endpoints — a rate depends on more than the code alone, and the government's own master publishes no rate column.\n\n## Billing\n\nPay-per-use credits on your gstinapi.in account, no separate charge for this MCP server. Pricing: https://www.gstinapi.in/pricing\n\n## License\n\nMIT\n",
  "bytes": 2436,
  "sha": "882de373bccc6f51d5bfe50a25f730e43e4ff6d98fd9ffb92c8eb405d81d4bb2",
  "repo_slug": "csofttarun/gstinapi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_csofttarun_gstinapi_mcp_229d2d3c/readme"
}