convez.ai
MCP ServerIntegração & APIsIntermediário
guptaprakhariitr

GST Validator MCP

guptaprakhariitr/gst-validator-mcp

Validação de GSTIN indiano em latência de microssegundos, sem APIs externas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que valida números GSTIN (Goods & Services Tax Identification Number) da Índia com verificação estrutural, extração de PAN embutido, lookup de código de estado e algoritmo oficial mod-36. Ideal para agentes de IA que processam faturas, onboarding de fornecedores ou KYC em contextos B2B indianos.

Instalação

$npx convez-ai guptaprakhariitr/gst-validator-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Validação de números fiscais em processamento de faturas indianas
  • Verificação de dados de fornecedores durante onboarding B2B
  • Extração e verificação de PAN embutido em documentos KYC
  • Resolução de código de estado a partir de GSTIN

Veredito

Ferramenta especializada e bem-executada para validação de GSTIN indiano com implementação de checksum correto. Útil para cenários B2B e compliance na Índia, mas público-alvo restrito a negócios que operam com tributação indiana.

README

A tradução para o português deste README ainda está na fila.

gst-validator-mcp

MCP server that validates Indian GSTIN (Goods & Services Tax Identification Numbers) — structural checks, embedded PAN extraction, state-code lookup, and the official GSTN mod-36 check character. Pure local compute, no upstream API, microsecond latencies.

For AI agents that touch Indian invoices, vendor onboarding, KYC, B2B billing, or anything else that mentions a GSTIN.

Endpoint: https://gst-validator-mcp.prakhar-cognizance.workers.dev/mcp


Tools

ToolPurpose
validate_gstin(gstin)Full validation: length, character set, state code, embedded PAN, check character.
extract_pan(gstin)Pull the 10-char PAN out of a GSTIN.
state_from_gstin(gstin)Resolve the 2-char state code prefix to the state/UT name.

Example:

curl -sS -X POST https://gst-validator-mcp.prakhar-cognizance.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-key>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"validate_gstin","arguments":{"gstin":"27AAPFU0939F1ZV"}}}'

Returns:

{
  "valid": true,
  "state": "Maharashtra",
  "state_code": "27",
  "pan": "AAPFU0939F",
  "entity_code": "1",
  "check_char": "V"
}

Install in Cursor / Claude Desktop / Cline

Add to your MCP config (e.g. ~/.cursor/mcp.json, claude_desktop_config.json):

{
  "mcpServers": {
    "gst-validator": {
      "url": "https://gst-validator-mcp.prakhar-cognizance.workers.dev/mcp",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

Without a key, you get the free tier (100 calls/month, 10/min) keyed off your client IP.


Pricing

TierPriceCalls/monthRate
Free$010010/min
Solo$9 / mo2,00060/min
Team$29 / mo10,000200/min
Pro$79 / mo50,000600/min

Subscribe at https://gst-validator-mcp.prakhar-cognizance.workers.dev/upgrade?tier=solo. Powered by Dodo Payments as merchant of record — Dodo handles GST/VAT remittance worldwide.


GSTIN format reference

A GSTIN is 15 characters drawn from [0-9A-Z]:

PositionLengthMeaning
1-22State (TIN) code — e.g. 27 = Maharashtra
3-1210Embedded PAN (5 letters + 4 digits + 1 letter)
131Entity registration count for that PAN in that state (1-9, A-Z)
141Default Z (special bodies may use other letters)
151Check character (mod-36 factor checksum over the first 14)

The check-character algorithm is the one documented by GSTN: multiply each base-36 code-point by an alternating factor of 2,1,2,1,... walking right-to-left, fold each product as (p/36) + (p%36), sum, and the check code-point is (36 - sum%36) % 36.


Self-service

  • GET /account (with Authorization: Bearer <key>) — current tier, usage, portal link.
  • POST /account/rotate — revoke the current key and mint a new one on the same subscription.
  • Customer portal — manage / cancel / update payment method via Dodo.

Lost your key? Email prakshatechnologies@gmail.com with your Dodo subscription ID.


License

MIT © 2026 Prakhar Gupta · prakshatechnologies@gmail.com

Ver o original no GitHub

Bom para

Relacionados