Skip to content
MCP server

India Company Diligence

Look up Indian companies by CIN from a local MCA mirror, with provenance on every field

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.2.0
Listing updated
3 days ago

About India Company Diligence

India Company Diligence is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.

Instead of calling a live service, this server queries a local DuckDB copy of the Ministry of Corporate Affairs company master data covering 3,738,721 companies. You fetch the mirror once with icd-fetch, roughly a 530 MB download and 1.4 GB on disk. The version described was built on 2026-10-25 from an upstream dataset updated 2026-10-13, and monthly rebuilds are planned.

Every answer returns data alongside a provenance list naming each field's source and as-of date, plus lists of what is missing or stale, so gaps are stated rather than filled in. In the README demo, a vendor check surfaces an Active company and a similarly named one marked Strike Off. Directors, charges and financials are not available yet; a live MCA layer is on the roadmap.

Two tools work fully offline: a CIN decoder that reads listing status, state, year and company type from the identifier, and a GSTIN validator that checks structure and the mod-36 checksum. The validator deliberately does not return legal name or registration status, since no keyless public GST API exists. The data is published under India's Government Open Data License.

Install

Run in a terminal

claude mcp add india-company-diligence -- uvx india-company-diligence

Add to claude_desktop_config.json

{
  "mcpServers": {
    "india-company-diligence": {
      "command": "uvx",
      "args": [
        "india-company-diligence"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "india-company-diligence": {
      "command": "uvx",
      "args": [
        "india-company-diligence"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "india-company-diligence": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "india-company-diligence"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "india-company-diligence": {
      "command": "uvx",
      "args": [
        "india-company-diligence"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "india-company-diligence": {
      "command": "uvx",
      "args": [
        "india-company-diligence"
      ]
    }
  }
}

Configuration

  • ICD_MIRROR_DBPath to mca_mirror.duckdb (fetch once: uvx --from india-company-diligence icd-fetch). Default: data/mca_mirror.duckdb.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

company_lookup
Returns the full registry row for one CIN with per-field provenance.
company_search
Searches companies by name, returning up to 50 ranked rows.
cin_decode
Decodes listing status, state, year and company type from a CIN offline.
gstin_validate
Validates GSTIN structure and checksum offline.

What it does

Local MCA mirror
Queries a 3.74 million company copy of the master data without a network call.
Provenance on every field
Each answer lists field sources, as-of dates, missing items and stale items.
CIN decoding
Reads listing status, state, year and company type from a CIN offline.
GSTIN validation
Checks GSTIN structure and the mod-36 checksum offline.
Name search
Case-insensitive search returning up to 50 ranked rows.
Open source
MIT licensed, with a roadmap for live director and charge data.

Good for

  • Check a vendor before extending credit
  • Confirm an Indian company's status and registrar
  • Spot lookalike company names before paying an invoice
  • Validate GSTIN formats in a document pipeline
  • Decode what a CIN says about a company

Pricing

Open source

Free, MIT licence

Prices change. Check pypi.org before you buy.

India Company Diligence FAQ

Does it need internet access?

The lookups use a local mirror; CIN decoding and GSTIN validation need no network.

How big is the data download?

About 530 MB to download and 1.4 GB on disk.

Does it return directors or financials?

Not yet. They are listed as missing pending a live layer.

Where does the data come from?

MCA Company Master Data via data.gov.in under the Government Open Data License - India.

What licence is the code?

MIT.

Is India Company Diligence free?

Yes. India Company Diligence is open source, so you can use and self-host it for free.

How do I add India Company Diligence to Claude Code?

Run this command in your terminal: claude mcp add india-company-diligence -- uvx india-company-diligence

What are the best alternatives to India Company Diligence?

The closest alternatives to India Company Diligence are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to India Company Diligence

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government