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

HSN Classifier MCP

guptaprakhariitr/hsn-classifier-mcp

Classifique produtos por HSN/GST indiano em agentes IA — zero latência, dataset local

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que classifica produtos segundo códigos HSN (Harmonized System Nomenclature) para GST na Índia. Oferece busca por código exato, pesquisa por palavras-chave e classificação automática de produtos com dataset embutido de ~4.700 entradas e latência microsegundos.

Instalação

$npx convez-ai guptaprakhariitr/hsn-classifier-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

  • Classificação automática de itens em faturas B2B indianas
  • Busca de códigos HSN para listagens de e-commerce
  • Mapeamento produto → código HST em pipelines de dados fiscais

Veredito

Solução niche mas executada com precisão: dataset robusto (~4.700 entradas), latência mínima e pricing escalonado acessível. Ideal para automação de compliance fiscal em B2B indiano; limitado geograficamente a contexto GST-Índia.

README

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

hsn-classifier-mcp

MCP server that looks up Indian HSN (Harmonized System Nomenclature) codes for GST classification — exact-code lookup, keyword search, and free-text product classification. Embedded ~4,700-entry dataset, no upstream API, microsecond latencies.

For AI agents that touch Indian B2B invoices, e-commerce listings, or anywhere you need to map "what is this product" → "what HSN code goes on the GST invoice".

Endpoint: https://hsn-classifier-mcp.prakhar-cognizance.workers.dev/mcp


Tools

ToolPurpose
lookup_hsn(code)Exact-code lookup. Accepts 4 / 6 / 8-digit (truncates 8 → 6 → 4).
search_hsn(query, limit?)Free-text keyword search across descriptions (limit 1-50, default 10).
classify_product(name)Best-effort classification: returns {best, alternatives, matched_tokens}.

Example:

curl -sS -X POST https://hsn-classifier-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":"classify_product","arguments":{"name":"basmati rice"}}}'

Install in Cursor / Claude Desktop / Cline

{
  "mcpServers": {
    "hsn-classifier": {
      "url": "https://hsn-classifier-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 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://hsn-classifier-mcp.prakhar-cognizance.workers.dev/upgrade?tier=solo. Powered by Dodo Payments as merchant of record — Dodo handles GST/VAT remittance worldwide.


Dataset

Embedded ~4,700-entry HSN dataset — the 4-digit headings and 6-digit subheadings from the CBIC schedule. 8-digit tariff items are not included (4 / 6-digit HSN is what gets reported on most GST invoices). Source: a clean MIT-licensed snapshot at https://github.com/QuantumByteStudios/gst-hsn-sac-codes.

The dataset is baked into the Worker bundle (~73KB gzipped) so lookups are pure local memory access — no external API, no rate limit on the upstream, no flaky network.

If the CBIC GST rates update, the embedded gst_rate field may lag the current schedule by some weeks — verify against the latest CBIC notification for high-value transactions.


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. See LICENSE for the dataset attribution.

Ver o original no GitHub

Bom para

Relacionados