# guptaprakhariitr/indian-regulatory-mcp architecture

> Architecture diagram of the GitHub repository guptaprakhariitr/indian-regulatory-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guptaprakhariitr/indian-regulatory-mcp
- Repository: https://github.com/guptaprakhariitr/indian-regulatory-mcp

## Overview

This is a Cloudflare Worker MCP server offering Indian regulatory and market-data tools, GSTIN validation, and account/subscription management. The main workflow is an MCP client request routed through the Worker, authenticated and quota-checked, dispatched to a registered tool, then served from an upstream source (with caching where implemented). Separate routes support checkout, account and team administration, and payment webhooks. The README documents all six data capabilities; excerpts show only some source fetches, so unsampled source wiring is not inferred.

Main entry points: [`src/index.ts`](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/index.ts) (HTTP Worker), [`src/sources.ts`](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts) (Source client), [`src/checkout.ts`](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/checkout.ts) (Checkout & accounts), [`src/webhook.ts`](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/webhook.ts) (Payment webhooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["MCP API"]
  node_worker["HTTP Worker<br/>[index.ts]"]
  node_protocol["MCP protocol<br/>[mcp-server.ts]"]
  node_toolregistry["Tool registry<br/>[tools.ts]"]
  node_openapi["OpenAPI schema<br/>[openapi.ts]"]
end

subgraph group_data["Regulatory Data"]
  node_sources["Source client<br/>[sources.ts]"]
  node_cache[("Response cache<br/>[cache.ts]")]
  node_sebi["SEBI data<br/>[sources.ts]"]
  node_rbi["RBI data<br/>[sources.ts]"]
  node_mca["MCA lookup<br/>[sources.ts]"]
  node_gst["GSTIN validation<br/>[sources.ts]"]
  node_nse["NSE announcements<br/>[sources.ts]"]
  node_amfi["AMFI NAV<br/>[sources.ts]"]
end

subgraph group_accounts["Accounts &amp; Billing"]
  node_auth["Key authentication<br/>[auth.ts]"]
  node_quotas["Quota enforcement<br/>[billing.ts]"]
  node_checkout["Checkout &amp; accounts<br/>[checkout.ts]"]
  node_webhook["Payment webhooks<br/>[webhook.ts]"]
  node_email["Transactional email<br/>[email.ts]"]
end

subgraph group_ops["Operations"]
  node_admin["Admin endpoints<br/>[admin.ts]"]
end

node_client(("MCP client"))
node_payments["Dodo Payments"]
node_kv[("Cloudflare KV")]

node_client -->|"sends requests"| node_worker
node_worker -->|"dispatches MCP"| node_protocol
node_worker -->|"registers tools"| node_toolregistry
node_worker -->|"resolves keys"| node_auth
node_worker -.->|"checks quotas"| node_quotas
node_toolregistry -->|"calls source client"| node_sources
node_sources -->|"memoizes results"| node_cache
node_sources -->|"fetches SEBI feeds"| node_sebi
node_sources -->|"fetches RBI feeds"| node_rbi
node_sources -->|"fetches NAV data"| node_amfi
node_sources -.->|"provides lookup"| node_mca
node_sources -.->|"provides validation"| node_gst
node_sources -.->|"provides announcements"| node_nse
node_auth -.->|"reads and writes"| node_kv
node_quotas -.->|"stores counters"| node_kv
node_worker -->|"routes account requests"| node_checkout
node_worker -->|"routes admin requests"| node_admin
node_worker -.->|"routes webhook requests"| node_webhook
node_checkout -->|"uses key helpers"| node_auth
node_checkout -->|"sends email"| node_email
node_checkout -.->|"creates checkout"| node_payments
node_webhook -->|"verifies signatures"| node_payments
node_webhook -->|"updates keys"| node_auth
node_webhook -->|"sends notices"| node_email
node_worker -.->|"serves schema"| node_openapi
node_admin -.->|"reads records"| node_kv

click node_worker "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/index.ts"
click node_protocol "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/mcp-server.ts"
click node_toolregistry "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/tools.ts"
click node_openapi "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/openapi.ts"
click node_auth "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/auth.ts"
click node_quotas "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/billing.ts"
click node_checkout "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/checkout.ts"
click node_webhook "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/webhook.ts"
click node_email "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/email.ts"
click node_sources "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_cache "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/cache.ts"
click node_sebi "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_rbi "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_mca "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_gst "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_nse "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_amfi "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts"
click node_admin "https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/admin.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_worker,node_protocol,node_toolregistry,node_openapi,node_client toneBlue
class node_sources,node_cache,node_sebi,node_rbi,node_mca,node_gst,node_nse,node_amfi,node_kv toneAmber
class node_auth,node_quotas,node_checkout,node_webhook,node_email toneMint
class node_admin toneRose
class node_payments toneIndigo
```

## Components

### MCP API

- [HTTP Worker](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/index.ts): `src/index.ts`
- [MCP protocol](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/mcp-server.ts): `src/mcp-server.ts`
- [Tool registry](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/tools.ts): `src/tools.ts`
- [OpenAPI schema](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/openapi.ts): `src/openapi.ts`

### Regulatory Data

- [Source client](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`
- [Response cache](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/cache.ts): `src/cache.ts`
- [SEBI data](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`
- [RBI data](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`
- [MCA lookup](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`
- [GSTIN validation](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`
- [NSE announcements](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`
- [AMFI NAV](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/sources.ts): `src/sources.ts`

### Accounts & Billing

- [Key authentication](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/auth.ts): `src/auth.ts`
- [Quota enforcement](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/billing.ts): `src/billing.ts`
- [Checkout & accounts](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/checkout.ts): `src/checkout.ts`
- [Payment webhooks](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/webhook.ts): `src/webhook.ts`
- [Transactional email](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/email.ts): `src/email.ts`

### Operations

- [Admin endpoints](https://github.com/guptaprakhariitr/indian-regulatory-mcp/blob/main/src/admin.ts): `src/admin.ts`

### Other components

- **MCP client**
- **Dodo Payments**
- **Cloudflare KV**

## Connections

- MCP client → HTTP Worker: sends requests (evidence: `README.md`)
- HTTP Worker → MCP protocol: dispatches MCP (evidence: `src/index.ts`)
- HTTP Worker → Tool registry: registers tools (evidence: `src/index.ts`)
- HTTP Worker → Key authentication: resolves keys (evidence: `src/index.ts`)
- HTTP Worker → Quota enforcement: checks quotas (evidence: `src/index.ts`)
- Tool registry → Source client: calls source client (evidence: `src/tools.ts`)
- Source client → Response cache: memoizes results (evidence: `src/sources.ts`)
- Source client → SEBI data: fetches SEBI feeds (evidence: `src/sources.ts`)
- Source client → RBI data: fetches RBI feeds (evidence: `src/sources.ts`)
- Source client → AMFI NAV: fetches NAV data (evidence: `src/sources.ts`)
- Source client → MCA lookup: provides lookup (evidence: `src/sources.ts`)
- Source client → GSTIN validation: provides validation (evidence: `src/sources.ts`)
- Source client → NSE announcements: provides announcements (evidence: `src/sources.ts`)
- Key authentication → Cloudflare KV: reads and writes
- Quota enforcement → Cloudflare KV: stores counters
- HTTP Worker → Checkout & accounts: routes account requests (evidence: `src/index.ts`)
- HTTP Worker → Admin endpoints: routes admin requests (evidence: `src/index.ts`)
- HTTP Worker → Payment webhooks: routes webhook requests (evidence: `src/index.ts`)
- Checkout & accounts → Key authentication: uses key helpers (evidence: `src/checkout.ts`)
- Checkout & accounts → Transactional email: sends email (evidence: `src/checkout.ts`)
- Checkout & accounts → Dodo Payments: creates checkout
- Payment webhooks → Dodo Payments: verifies signatures (evidence: `src/webhook.ts`)
- Payment webhooks → Key authentication: updates keys (evidence: `src/webhook.ts`)
- Payment webhooks → Transactional email: sends notices (evidence: `src/webhook.ts`)
- HTTP Worker → OpenAPI schema: serves schema (evidence: `src/index.ts`)
- Admin endpoints → Cloudflare KV: reads records
