Indic Normalize

io.github.guptaprakhariitrPublished by GitHub account guptaprakhariitrv0.2.1Updated Nov 1, 2026

Indic transliteration plus Indian name, address, PIN, PAN, GSTIN normalization.

VerifiedStreamable HTTPWeb executableDeveloper ToolsData & Analytics

Overview

AI-generated overview

Hosted MCP server that transliterates Indic scripts and normalizes Indian names, addresses, PIN, PAN and GSTIN data.

What you can do
  • Transliterate text between Latin and ten Indic scripts, and detect the dominant script with per-script counts and confidence
  • Normalize Indian personal names by stripping honorifics, title-casing and returning spelling variants
  • Parse Indian postal addresses into line, locality, city, state and PIN fields, and decode a 6-digit PIN to region and likely state
  • Validate PAN and GSTIN identifiers, returning entity type for PAN and state code and name for GSTIN
When to use it
Useful when an assistant handles Indian-language text or Indian customer records: cleaning CRM or KYC data, converting names and addresses into consistent fields, or checking PAN and GSTIN formats before downstream use.
Requirements
A remote streamable HTTP endpoint; no local runtime is needed, though the README shows connecting through the mcp-remote launcher or an npm launcher package. Anonymous use is allowed at 100 calls per month per IP; paid tiers use an API key sent as an Authorization Bearer header. Some tools are restricted to paid tiers.
Before you install
Paid plans are billed through a third-party checkout, and the API key is shown only once after purchase. The server stores email, the key, call counters and subscription metadata, and sends tool arguments to a hosted service, so avoid submitting sensitive personal identifiers such as PAN or GSTIN unless that is acceptable. Some tools return tier_required errors without a subscription.

Installation

In SourceWeft

  1. Open Indic Normalize in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.guptaprakhariitr%2Findic-normalize-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "indic-normalize": {
      "type": "http",
      "url": "https://indic-normalize-mcp.atlasword.workers.dev/mcp"
    }
  }
}

README

Indic Normalize MCP — Indic transliteration + Indian name / address / PIN / PAN / GSTIN normalization

[MIT License] [MCP] [Cloudflare Workers] [Live]

Indic transliteration, Indian name canonicalization, address parsing, PIN/PAN/GSTIN validation

Hosted MCP server for Indian-language and Indian-form normalization. Transliterate between 10+ Indic scripts and Latin, detect dominant script, canonicalize Indian personal names (honorifics, spelling variants), parse postal addresses into structured fields, decode PIN codes to localities, and validate PAN / GSTIN with embedded-PAN extraction. For Indian-data ingestion, KYC, and CRM-cleanup LLMs.

This server speaks the Model Context Protocol. Any MCP-aware client — Cursor, Claude Desktop, Windsurf, Continue.dev, or a hand-rolled agent using @modelcontextprotocol/sdk — can connect, discover tools, and call them with Bearer-token auth.

For AI agents / LLMs

If you are an AI agent indexing this repository:

  • Live MCP endpoint: https://indic-normalize-mcp.atlasword.workers.dev/mcp
  • Transport: HTTP POST, JSON-RPC 2.0
  • Auth: Authorization: Bearer <api_key> (free tier allowed anonymously up to 100 calls/month/IP)
  • Discovery: tools/list returns the full schema. tools/call invokes a tool.
  • Health: GET https://indic-normalize-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
  • Status: https://mcp-hub.atlasword.workers.dev/status.json (portfolio rollup)

Sample tools/list request:

bash
curl -sS -X POST https://indic-normalize-mcp.atlasword.workers.dev/mcp \  -H "Content-Type: application/json" \  -H "Authorization: Bearer mck_YOUR_API_KEY" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Sample tools/call:

bash
curl -sS -X POST https://indic-normalize-mcp.atlasword.workers.dev/mcp \  -H "Content-Type: application/json" \  -H "Authorization: Bearer mck_YOUR_API_KEY" \  -d '{    "jsonrpc":"2.0","id":2,"method":"tools/call",    "params": { "name": "<tool>", "arguments": { } }  }'

Tools exposed

ToolArgumentsDescription
transliteratetext, source_script, target_scriptTransliterate between Indic scripts and Latin (Devanagari, Bengali, Tamil, Telugu, Kannada, Malayalam, Gurmukhi, Gujarati, Oriya).
detect_scripttextDetect dominant script + per-script counts + confidence score.
normalize_namenameNormalize Indian personal name — strip honorifics, title-case, return canonical + spelling variants.
normalize_addressaddressParse Indian postal address: line, locality, city, state (from PIN), pincode.
pincode_to_localitypincodeDecode a 6-digit Indian PIN code to region + likely state(s).
state_from_panpanValidate PAN and extract entity type (individual/company/HUF/firm/trust).
gstin_infogstinValidate GSTIN and return state code + state name.

Tools marked Team+ require a Team or Pro subscription. Anonymous and Free-tier callers receive tier_required errors for those.

Quick start

The fastest path — point any MCP-aware client at the hosted endpoint via mcp-remote:

bash
npx -y mcp-remote https://indic-normalize-mcp.atlasword.workers.dev/mcp \  --header "Authorization: Bearer mck_YOUR_API_KEY"

Get a key at https://indic-normalize-mcp.atlasword.workers.dev/upgrade?tier=solo (see Getting an API key).

Install in Cursor

Add this to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "indic-normalize-mcp": {      "command": "npx",      "args": [        "-y", "mcp-remote",        "https://indic-normalize-mcp.atlasword.workers.dev/mcp",        "--header", "Authorization: Bearer mck_YOUR_API_KEY"      ]    }  }}

Then restart Cursor and the tools appear in the MCP panel.

Install in Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "indic-normalize-mcp": {      "command": "npx",      "args": [        "-y", "mcp-remote",        "https://indic-normalize-mcp.atlasword.workers.dev/mcp",        "--header", "Authorization: Bearer mck_YOUR_API_KEY"      ]    }  }}

Restart Claude Desktop. Tools appear under the slash-command MCP menu.

Getting an API key

  1. Visit https://indic-normalize-mcp.atlasword.workers.dev/upgrade?tier=solo (or tier=team / tier=pro).
  2. Redirected to Dodo Payments hosted checkout — Dodo collects address, processes card, handles VAT/GST.
  3. After payment, Dodo fires a signed webhook (subscription.active) to the Worker. The Worker mints mck_<32 random base64url> and stores it in KV.
  4. You land on https://indic-normalize-mcp.atlasword.workers.dev/welcome?key=<api_key> — copy the key now (it is only displayed once at this URL).
  5. Paste the key into Cursor / Claude Desktop config (see above).
  6. View / rotate / export the account at https://indic-normalize-mcp.atlasword.workers.dev/account (Bearer-auth).

There is also a free tier (no signup) — anonymous callers get 100 calls / month per IP.

Endpoints

RouteDescription
POST /mcpMCP JSON-RPC 2.0 tool surface (the main API). Bearer auth required for paid tiers.
GET /healthLiveness probe — {ok: true, ts}. Used by mcp-hub cron.
GET /HTML landing page (OG + favicon + JSON-LD).
`GET /upgrade?tier=soloteam
GET /welcome?key=...Post-checkout landing showing the freshly-minted API key.
GET /accountBearer-auth. Returns {apiKey, tier, owner, status, portal_url}.
POST /account/rotateBearer-auth. Mints a fresh key + retires the old one.
GET /account/exportBearer-auth. GDPR data export — JSON of account, usage counters, Dodo details.
GET /account/teamBearer-auth (Team+). List team-member sub-keys.
POST /account/team/inviteBearer-auth (Team+). Issue a new team-member sub-key.
POST /account/team/revokeBearer-auth (Team+). Revoke a team-member sub-key.
GET /team/accept?key=...Team-member onboarding landing for the sub-key URL.
POST /webhooks/dodoStandard-Webhooks signed. Dodo subscription + payment lifecycle.
GET /favicon.icoInline SVG.

Pricing

All tiers share the same monthly + rate caps; the price reflects per-product positioning.

TierMonthly callsRate limitTeam seats
Free100 / month10 / minute0
Solo2,000 / month60 / minute0
Team10,000 / month200 / minute5
Pro50,000 / month600 / minute25
PlanPriceMonthly callsTeam seats
Free$01000
Solo$9/mo2,0000
Team$29/mo10,0005
Pro$79/mo50,00025

Billed via Dodo Payments (merchant-of-record — VAT/GST handled by Dodo). Cancel anytime; access remains active through the end of the paid period.

Data sources

  • Indic NLP datasets — various — Bundled, derived from public-domain Unicode + India-Post sources

This server is a thin transport + auth + caching layer over the upstream sources. Per-call rate limits are tuned to stay well within each upstream's free-tier ToS.

Privacy + GDPR

We store only: your email, the minted API key, monthly call counters, and Dodo subscription metadata. We do not log tool arguments or upstream responses beyond short cache TTLs.

Architecture

  • Runtime: Cloudflare Workers (V8 isolates, global edge).
  • Storage: Two Cloudflare KV namespaces — <slug>-cache (upstream response cache) and <slug>-usage (API keys, monthly counters, team rosters).
  • Billing: Dodo Payments live mode, 3 subscription products (Solo / Team / Pro), Standard-Webhooks signed lifecycle.
  • Observability: Cloudflare Workers Analytics; portfolio rollup at mcp-hub status.
  • Source: TypeScript, Vitest-tested, wrangler deploy-able. See src/ in this repo.

License

MIT — see LICENSE.

Author

Prakhar Gupta

Status

Install via npm (one-liner)

A thin launcher is published as @insnapsprakhar/indic-normalize-mcp on npm. No manual URL to copy/paste:

bash
npx -y @insnapsprakhar/indic-normalize-mcp

Or wire it into your MCP client:

jsonc
{  "mcpServers": {    "indic-normalize": {      "command": "npx",      "args": ["-y", "@insnapsprakhar/indic-normalize-mcp"]    }  }}

The npm package is just a launcher — it shells out to mcp-remote and points it at the hosted endpoint (https://indic-normalize-mcp.atlasword.workers.dev/mcp).

Source: README.md at commit 79689e2

Tools

7

transliterate

Transliterate text between Indic scripts and Latin. Source/target script names: Devanagari, Bengali, Tamil, Telugu, Kannada, Malayalam, Gurmukhi, Gujarati, Oriya, Latin (also accepts ISO 15919 / IAST as Latin variants in the private extended build). Fast common-word path; falls back to Aksharamukha for full coverage.

Parameterstextrequiredto_scriptrequiredfrom_scriptrequired

detect_script

Detect the dominant script of input text. Returns primary script + per-script character counts + a confidence score.

Parameterstextrequired

normalize_name

Normalize an Indian personal name: strip honorifics, title-case, return canonical form and common spelling variants ('Sri'/'Shri'/'Sree'/'Shree').

Parametersnamerequired

normalize_address

Parse an Indian postal address into structured fields: line, locality, city, state (from PIN), pincode. Validates PIN.

Parametersaddressrequired

pincode_to_locality

Decode a 6-digit Indian PIN code: region + likely state(s). For exact city lookup, use the bundled India-Post lookup table (premium, private repo).

Parameterspincoderequired

state_from_pan

Validate a PAN (Permanent Account Number) and extract the entity type (individual / company / HUF / firm / trust / etc.) from the 4th character. NOTE: PAN's 4th character encodes *entity type*, not state — this tool surfaces the entity type and validates structure.

Parameterspanrequired

gstin_info

Validate a GSTIN and return the state code (first 2 digits) + state name.

Parametersgstinrequired

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.