india-reg-mcp

An MCP server that gives Claude (and any MCP client) searchable, cited access to RBI and SEBI regulatory documents — circulars, master directions, notifications, and regulations.

No API keys. No subscriptions. Built entirely on free public government data.

---

Why This Exists

Regulatory rules in India are scattered across thousands of PDFs and HTML pages on rbi.org.in and sebi.gov.in. They reference and supersede each other constantly. There is no AI-accessible way to ask "what are the current rules on X" and get sourced answers.

This MCP solves that. It scrapes, indexes, and exposes the full text of RBI and SEBI documents in a local SQLite database — so Claude can search and retrieve primary-source regulatory text with official citations, instantly.

This is not a legal advice tool. It retrieves primary-source documents so you can reason over actual rules instead of hallucinated summaries.

---

What It Does

Full-text search across all indexed RBI and SEBI documents
Retrieve full document body by ID, with official source link
List recent documents — useful for "what changed this month" questions
List Master Directions and Master Circulars — the consolidated, currently-in-force rules on each subject
Browse by department — SEBI's Investment Management, Market Regulation, etc.
On-demand sync — pull newly published documents from regulators' sites
Topic search — returns both consolidated master rules AND recent circulars on a subject in one call

---

Tools (8 total)

| Tool | Description | |---|---| | search_regulations | Full-text search with optional regulator/type filter | | get_document | Retrieve full text of a document by ID | | get_recent | Most recent documents, optionally filtered | | list_master_directions | All RBI Master Directions + SEBI Master Circulars | | list_by_department | SEBI documents by department name | | sync_latest | Incremental scrape of new documents from RBI + SEBI | | sync_status | Document count breakdown + last sync time | | search_by_topic | Combined master rules + recent circulars on a topic |

---

Architecture

RBI / SEBI websites
        │
        ▼
   Scrapers (TypeScript)
   rbi.ts  ──── ASP.NET POST with viewstate tokens
   sebi.ts ──── AJAX pagination via JSP endpoint
        │
        ▼
   SQLite DB  (~/.india-reg-mcp/regdata.db)
   ├── documents table (full text, metadata, source URLs)
   ├── documents_fts (FTS5 full-text index, porter stemmer)
   └── sync_meta (last sync timestamp)
        │
        ▼
   MCP Server (stdio transport)
   ├── 8 tools exposed to Claude
   └── Every result includes official source URL + disclaimer

Key design decision: Tools never scrape live. The scrapers populate a local SQLite database once, and tools query that instantly. Only sync_latest hits the regulators' sites. This makes every tool call fast, keeps you off government servers during normal use, and works offline once indexed.

---

Installation

Prerequisites

Node.js 18+
Claude Code CLI or Claude Desktop

---

Option A — npm (recommended)

Install globally and register with Claude Code in one step:

npm install -g india-reg-mcp
claude mcp add -s user india-reg india-reg-mcp

Or use without installing via npx:

claude mcp add -s user india-reg npx india-reg-mcp

First-run sync

After adding the server, ask Claude to sync: `` Run sync_latest to populate the index ``

Or run directly: ``bash npx india-reg-mcp # starts the MCP server ``

---

Option B — from source

git clone https://github.com/Akhilgovind02/india-regulatory-mcp.git
cd india-regulatory-mcp
npm install
npm run build

First-run sync (populates the database)

npm run sync

This scrapes RBI notifications for the last 36 months and SEBI circulars (~1000 recent documents). Takes 5–15 minutes depending on your connection. The database is stored at ~/.india-reg-mcp/regdata.db and survives rebuilds.

Progress is printed to stderr: `` [sync] RBI 2026-6: 12 docs found [sync] RBI 2026-5: 18 docs found ... [sync] SEBI ssid=6 page 0: 25 docs ... [sync] Sync complete. ``

---

Configuration

Claude Code (CLI)

Via npm (global install): ``bash claude mcp add -s user india-reg india-reg-mcp ``

Via npx (no install): ``bash claude mcp add -s user india-reg npx india-reg-mcp ``

Via source build: ``bash claude mcp add -s user india-reg node /ABSOLUTE/PATH/TO/india-regulatory-mcp/dist/index.js ``

Or add to ~/.claude.json manually: ``json { "mcpServers": { "india-reg": { "command": "npx", "args": ["india-reg-mcp"] } } } ``

Claude Desktop

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

{
  "mcpServers": {
    "india-reg": {
      "command": "npx",
      "args": ["india-reg-mcp"]
    }
  }
}

Restart Claude Desktop fully after editing the config.

---

Usage Examples

Once connected, ask Claude naturally:

What are the current RBI rules on digital lending?

→ Claude calls search_by_topic("digital lending") — returns the Master Direction on Digital Lending plus recent amending circulars, each with official source links.

What new SEBI circulars came out this month?

→ Claude calls get_recent(regulator="SEBI", limit=10).

Show me all RBI Master Directions

→ Claude calls list_master_directions(regulator="RBI").

What are the KYC requirements for mutual funds?

→ Claude calls search_regulations("KYC mutual fund", doc_type="master_direction").

Pull in the latest regulatory updates

→ Claude calls sync_latest() — incremental, only fetches new documents.

---

Data Sources

RBI (Reserve Bank of India)

Notifications + Circulars: rbi.org.in/Scripts/NotificationUser.aspx
Master Directions: rbi.org.in/Scripts/BS_ViewMasterDirections.aspx
Master Circulars: rbi.org.in/Scripts/BS_ViewMasterCirculardetails.aspx
Document bodies: HTML page text (with PDF fallback for PDF-only docs)

SEBI (Securities and Exchange Board of India)

Circulars (ssid=7): ~2,775 documents as of June 2026
Master Circulars (ssid=6): consolidated current rules by topic
Regulations (ssid=3): statutory regulations
Document bodies: primarily PDF-embedded content extracted via pdf-parse

---

Document Types

| Type | Source | Description | |---|---|---| | circular | RBI + SEBI | Point-in-time regulatory guidance | | master_direction | RBI | Consolidated current rules on a subject (supersedes earlier circulars) | | master_circular | SEBI | Same as master direction, SEBI's term | | notification | RBI | Statutory notifications under various Acts | | regulation | SEBI | Formal regulations (e.g. SEBI (FPI) Regulations 2019) |

For compliance questions, start with master_direction/master_circular. These represent the current state of rules, not a point-in-time snapshot.

---

Keeping the Index Fresh

The database is a point-in-time snapshot. RBI and SEBI publish new documents frequently (several per week).

Option 1 — Ask Claude: "Pull in the latest regulatory updates" → Claude calls sync_latest.

Option 2 — CLI: ``bash npm run sync ``

Option 3 — Scheduled (example cron, runs every Sunday at 2am): `` 0 2 0 cd /path/to/india-regulatory-mcp && npm run sync >> ~/.india-reg-mcp/sync.log 2>&1 ``

sync_latest and npm run sync are both incremental — they skip documents already in the database.

---

Project Structure

india-regulatory-mcp/
├── src/
│   ├── index.ts                  ← MCP server, all 8 tools
│   ├── db/
│   │   ├── schema.ts             ← SQLite schema + FTS5 setup
│   │   └── queries.ts            ← DB read/write functions
│   ├── scrapers/
│   │   ├── rbi.ts                ← RBI scraper (ASP.NET POST + viewstate)
│   │   ├── sebi.ts               ← SEBI scraper (AJAX pagination)
│   │   ├── pdf.ts                ← PDF download + text extraction
│   │   ├── run-sync.ts           ← CLI full sync runner
│   │   └── repair-bodies.ts      ← Utility: backfill missing body text
│   └── util/
│       ├── http.ts               ← Polite fetch (UA + retry + delay)
│       └── format.ts             ← MCP response helpers
├── dist/                         ← Compiled output (not in repo)
├── package.json
└── tsconfig.json

---

Technical Notes

Scraping approach

RBI uses ASP.NET with viewstate tokens. The scraper fetches viewstate on startup, then POSTs month-by-month to get document listings. Content is extracted from the HTML circular page; PDF fallback for PDF-only documents.

SEBI uses a JSP-based listing with AJAX pagination. Page 1 is a GET request (establishes JSESSIONID). Pages 2+ POST to getnewslistinfo.jsp with the session cookie. Circular content is typically a PDF embedded in an iframe — the scraper extracts the PDF URL and parses it with pdf-parse.

Polite scraping

Concurrency capped at 2 parallel requests per host
300ms delay between document fetches
500ms delay between listing pages
Exponential backoff on 429/5xx responses
Real User-Agent string identifying the tool

Database

Location: ~/.india-reg-mcp/regdata.db
WAL mode for performance
FTS5 with Porter stemmer — handles morphological variants ("lending" matches "lend", "lender")
Full-text search terms are quoted per-word to handle hyphens and special characters safely

---

Stack

| Package | Version | Purpose | |---|---|---| | @modelcontextprotocol/sdk | 1.29.0 | MCP server framework | | better-sqlite3 | 12.10.0 | SQLite with built-in FTS5 | | cheerio | 1.2.0 | HTML parsing | | pdf-parse | 2.4.5 | PDF text extraction | | turndown | 7.2.4 | HTML → Markdown | | p-limit | 7.3.0 | Concurrency control | | zod | 4.4.3 | Schema validation |

---

Disclaimer

This tool retrieves and surfaces primary-source regulatory documents from official RBI and SEBI publications. It does not provide legal advice. Always verify against the official linked document. The index is a point-in-time snapshot — use sync_latest to pull recent publications.

india-regulatory-mcp