HSN Classifier — hosted on Cloudflare Workers (HTTP + npm stdio)

What is HSN Classifier?

HSN Classifier is a hosted MCP server that looks up Indian HSN (Harmonized System Nomenclature) codes used for GST classification, with a built-in dataset of 4,676 entries. It supports lookup by 4/6/8-digit code, free-text search across descriptions, and a product-name classifier returning best and alternative HSN candidates with matched-token explanations. It is designed for Indian e-commerce, accounting, and procurement LLMs.

How to use HSN Classifier?

Point any MCP-aware client (Cursor, Claude Desktop, Windsurf, Continue.dev) at the hosted endpoint via mcp-remote or the npm launcher @insnapsprakhar/hsn-classifier-mcp. Authentication uses a Bearer token. Free tier (no signup) allows 100 calls/month per IP; paid keys are obtained via Dodo Payments checkout.

Key features of HSN Classifier

• Full 4,676-entry Indian HSN/GST code dataset
• Lookup by 4/6/8-digit HSN code
• Free-text keyword search across descriptions
• Product-name classifier with alternatives and matched tokens
• Hosted on Cloudflare Workers global edge
• HTTP JSON-RPC 2.0 transport with Bearer token auth

Use cases of HSN Classifier

• Classify product names into correct HSN codes for GST filings
• Search HSN descriptions by keyword for accounting or procurement
• Integrate HSN lookup into an LLM-powered e-commerce or ERP agent
• Validate or cross-check HSN codes from invoices or purchase orders

FAQ from HSN Classifier

What does HSN Classifier do and how is it different from alternatives?

It is an MCP server that provides Indian HSN code lookup, search, and product classification. The README does not compare it to alternatives beyond describing its hosted, MCP-native approach.

What are the runtime and dependency requirements?

No local installation is required; the server runs on Cloudflare Workers. Access requires an MCP-aware client and an API key. The npm package is a launcher that shells out to mcp-remote.

Where does the data live and how is user privacy handled?

The HSN dataset is from the public Indian GST portal (gst.gov.in). Only your email, API key, monthly call counters, and Dodo subscription metadata are stored. Tool arguments and upstream responses are not logged beyond short cache TTLs. Data export and deletion are available.

What are the usage limits and pricing tiers?

Tiers: Free (100 calls/month, 10/min), Solo ($9/mo, 2,000 calls, 60/min), Team ($29/mo, 10,000 calls, 200/min, 5 seats), Pro ($79/mo, 50,000 calls, 600/min, 25 seats). Access remains active through end of paid period.

How is the server accessed and authenticated?

Transport is HTTP POST to the MCP endpoint with JSON-RPC 2.0. Authentication uses a Bearer token in the Authorization header. Free anonymous callers get 100 calls/month per IP. Paid keys are obtained through Dodo Payments checkout.