icegate-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
icegate-mcp
MCP server for the public (no-login) enquiries of ICEGATE, India's Customs gateway. It calls the ICEGATE 2.0 JSON APIs on foservices.icegate.gov.in directly; none of these need a login or captcha.
Tools
Tool | What it does |
| Search customs location/port codes (e.g. "nhava" → |
| Full SB tracking: details, current status, EGM, drawback, RoSL/RoDTEP, IGST invoices, OGA, e-docs |
| SB status in RBI EDPMS |
| SB integration status with DGFT |
| Whether a Bill of Entry was transmitted to GSTN |
| Duty challan bank status |
| VCN / rotation numbers for a vessel IMO in a date range |
| Bonded warehouse lookup by code or name |
| Customs status of an India Post import article |
| CBIC customs exchange rates (import/export) in force on a date, or by notification |
| List exchange-rate notifications |
| Public enquiries ICEGATE currently has enabled |
| SEZ location list |
| Call any other |
| CODES directory: tariff (CTH + BCD rate), ITC(HS), location, currency, country, state, UQC, package, sea/air port, airline, shipping line, supporting-document codes |
| Trade Guide on Exports: ITC(HS) items with export policy, unit and tariff rate, plus chapter notes and policy conditions |
| Trade Guide on Imports: ITC(HS) items with import policy, unit and BCD rate, plus chapter and sub-heading notes |
| "Know your Import Duty" for an 8-digit CTH: tariff vs effective rate per head (BCD, AIDC, SWS, IGST, cesses, ADD/safeguard), governing notification, exemption notifications, policy notes, total duty % and duty on an assessable value |
| GSTIN enquiry: whether a GSTIN is active with Customs, legal name, last GSTN update |
icegate_import_duty reproduces the duty page's own formula (e.g. 85171300 smartphones: 49.152% = BCD 20 + AIDC 4 + SWS 2.4 + IGST 22.752). It is indicative: specific duties are listed but not added into the % total, and ICEGATE currently returns no preferential/FTA rates even when a country of origin is given.
The CODES, trade-guide, duty and GSTIN tools use the legacy www.icegate.gov.in/Webappl pages. That host omits its intermediate TLS certificate, so the server ships it (src/ca.ts, expires 2027-12-10) and keeps verification on. The /Webappl/ landing page itself has a CAPTCHA, but these pages don't need it; the server never solves CAPTCHAs.
All dates go in as YYYY-MM-DD; the server converts them to each endpoint's format.
Not available without login (ICEGATE returns "auth error"): Bill of Entry status tracking, FE realization, IGST refund/scroll, drawback, IEC details. Those need an ICEGATE account and are out of scope.
Related MCP server: gstinapi-mcp
Install
Requires Bun. Run straight from GitHub, no clone needed:
bunx github:quantavil/icegate-mcpClaude Code:
claude mcp add --scope user icegate -- bunx github:quantavil/icegate-mcpCodex (~/.codex/config.toml):
[mcp_servers.icegate]
command = "bunx"
args = ["github:quantavil/icegate-mcp"]Claude Desktop (claude_desktop_config.json):
{ "mcpServers": { "icegate": { "command": "bunx", "args": ["github:quantavil/icegate-mcp"] } } }Or build a one-click Desktop extension that runs on Node (no Bun needed): bun run pack:mcpb, then open icegate.mcpb.
Develop
bun install
bun test # unit + in-process server tests (ICEGATE mocked)
bun run test:live # adds a few live requests to ICEGATEConfig
ICEGATE_BASE_URL(defaulthttps://foservices.icegate.gov.in)ICEGATE_WEBAPPL_URL(defaulthttps://www.icegate.gov.in/Webappl)ICEGATE_TIMEOUT_MS(default30000)
License
GPL-3.0-or-later. Not affiliated with CBIC or ICEGATE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Free, read-only public-source threat intel over MCP. No account or API key.
Global customs bill of lading shipments, HS code, importer/exporter & supplier trade data MCP API.
1Global customs bill of lading shipments, HS code, importer/exporter & supplier trade data MCP API.
1SEC MCP — SEC EDGAR public APIs (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying official Brazilian Federal Revenue data on foreign trade habilitation (Radar), allowing users to check habilitation status directly from the official source. Read-only MCP server with a single consultation tool.MIT
- AlicenseAqualityCmaintenanceEnables live GSTIN verification, GST return and compliance history lookup, HSN/SAC code searches, and MCA company registry queries through MCP clients.1052 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables keyless, read-only access to a wide range of public APIs (including weather, elevation, Japanese addresses, environment, science, and civic data) through MCP clients, with usage limits and abuse protection built in.MIT
- FlicenseNot gradedqualityBmaintenanceEnables any MCP client to anonymously query listed API prices across official, inference, and relay providers, find free credits and promotions, resolve model names, and retrieve quote evidence and glossary information without an API key.1,412-