# zerodha/kite-mcp-server architecture

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

- Interactive diagram: https://gitdiagram.com/zerodha/kite-mcp-server
- Repository: https://github.com/zerodha/kite-mcp-server

## Overview

Kite MCP Server exposes Kite Connect trading and account capabilities as MCP tools. The main workflow is an AI client connecting through a configured server mode, invoking a tool, and—when needed—logging in through a browser before the tool accesses Kite. The graph separates transport and registration, authentication/session management, account and trading tools, and market data. Source excerpts show key calls, but not every tool handler or HTTP route; unverified subsystem links are omitted.

Main entry points: [`kc/manager.go`](https://github.com/zerodha/kite-mcp-server/blob/master/kc/manager.go) (Kite manager), [`mcp/mcp.go`](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/mcp.go) (MCP tool registry), [`mcp/market_tools.go`](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/market_tools.go) (Market tools), [`app/app.go`](https://github.com/zerodha/kite-mcp-server/blob/master/app/app.go) (App and transports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Server runtime"]
  node_entry["Process entry<br/>[main.go]"]
  node_app["App and transports<br/>[app.go]"]
  node_tool_registry["MCP tool registry<br/>[mcp.go]"]
  node_metrics[("Usage metrics<br/>[metrics.go]")]
end

subgraph group_auth["Authentication and sessions"]
  node_session_manager["Kite manager<br/>[manager.go]"]
  node_session_store[("Session lifecycle<br/>[session.go]")]
  node_session_signing["Session signing<br/>[session_signing.go]"]
  node_templates["Auth templates"]
  node_login_tool["Login tool<br/>[setup_tools.go]"]
end

subgraph group_account["Account and trading"]
  node_shared_handlers["Tool helpers<br/>[common.go]"]
  node_account_tools["Account queries<br/>[get_tools.go]"]
  node_mf_tools["Fund holdings<br/>[mf_tools.go]"]
  node_trade_tools["Orders and GTT<br/>[post_tools.go]"]
end

subgraph group_market["Market data"]
  node_market_tools["Market tools<br/>[market_tools.go]"]
  node_instrument_manager[("Instrument catalogue<br/>[manager.go]")]
  node_instrument_search["Instrument search<br/>[search.go]"]
  node_instrument_types["Instrument models<br/>[instruments.go]"]
end

node_client(("AI client"))
node_browser(("User browser"))
node_kite{{"Kite Connect API"}}

node_client -->|"connects via MCP"| node_app
node_entry -->|"starts"| node_app
node_app -->|"creates"| node_session_manager
node_app -->|"registers tools"| node_tool_registry
node_app -->|"imports"| node_metrics
node_tool_registry -->|"registers"| node_login_tool
node_login_tool -->|"creates auth session"| node_session_manager
node_login_tool -->|"presents login link"| node_browser
node_browser -.->|"returns authorization"| node_session_manager
node_session_manager -->|"manages sessions"| node_session_store
node_session_manager -->|"verifies session IDs"| node_session_signing
node_session_manager -->|"sets up templates"| node_templates
node_tool_registry -->|"registers"| node_account_tools
node_tool_registry -->|"registers"| node_mf_tools
node_tool_registry -->|"registers"| node_trade_tools
node_tool_registry -->|"registers"| node_market_tools
node_account_tools -->|"uses helpers"| node_shared_handlers
node_trade_tools -->|"uses helpers"| node_shared_handlers
node_market_tools -->|"uses helpers"| node_shared_handlers
node_account_tools -->|"gets session"| node_session_manager
node_mf_tools -->|"gets session"| node_session_manager
node_trade_tools -->|"gets session"| node_session_manager
node_market_tools -->|"gets session"| node_session_manager
node_account_tools -->|"requests account data"| node_kite
node_mf_tools -->|"requests fund holdings"| node_kite
node_trade_tools -->|"submits trade requests"| node_kite
node_market_tools -->|"requests market data"| node_kite
node_market_tools -->|"searches instruments"| node_instrument_manager
node_instrument_manager -->|"indexes instruments"| node_instrument_types
node_market_tools -->|"uses search"| node_instrument_search

click node_entry "https://github.com/zerodha/kite-mcp-server/blob/master/main.go"
click node_app "https://github.com/zerodha/kite-mcp-server/blob/master/app/app.go"
click node_tool_registry "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/mcp.go"
click node_metrics "https://github.com/zerodha/kite-mcp-server/blob/master/app/metrics/metrics.go"
click node_session_manager "https://github.com/zerodha/kite-mcp-server/blob/master/kc/manager.go"
click node_session_store "https://github.com/zerodha/kite-mcp-server/blob/master/kc/session.go"
click node_session_signing "https://github.com/zerodha/kite-mcp-server/blob/master/kc/session_signing.go"
click node_templates "https://github.com/zerodha/kite-mcp-server/tree/master/kc/templates"
click node_login_tool "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/setup_tools.go"
click node_shared_handlers "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/common.go"
click node_account_tools "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/get_tools.go"
click node_mf_tools "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/mf_tools.go"
click node_trade_tools "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/post_tools.go"
click node_market_tools "https://github.com/zerodha/kite-mcp-server/blob/master/mcp/market_tools.go"
click node_instrument_manager "https://github.com/zerodha/kite-mcp-server/blob/master/kc/instruments/manager.go"
click node_instrument_search "https://github.com/zerodha/kite-mcp-server/blob/master/kc/instruments/search.go"
click node_instrument_types "https://github.com/zerodha/kite-mcp-server/blob/master/kc/instruments/instruments.go"

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_entry,node_app,node_tool_registry,node_metrics,node_client,node_browser toneBlue
class node_session_manager,node_session_store,node_session_signing,node_templates,node_login_tool toneAmber
class node_shared_handlers,node_account_tools,node_mf_tools,node_trade_tools,node_kite toneMint
class node_market_tools,node_instrument_manager,node_instrument_search,node_instrument_types toneRose
```

## Components

### Server runtime

- [Process entry](https://github.com/zerodha/kite-mcp-server/blob/master/main.go): `main.go`
- [App and transports](https://github.com/zerodha/kite-mcp-server/blob/master/app/app.go): `app/app.go`
- [MCP tool registry](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/mcp.go): `mcp/mcp.go`
- [Usage metrics](https://github.com/zerodha/kite-mcp-server/blob/master/app/metrics/metrics.go): `app/metrics/metrics.go`

### Authentication and sessions

- [Kite manager](https://github.com/zerodha/kite-mcp-server/blob/master/kc/manager.go): `kc/manager.go`
- [Session lifecycle](https://github.com/zerodha/kite-mcp-server/blob/master/kc/session.go): `kc/session.go`
- [Session signing](https://github.com/zerodha/kite-mcp-server/blob/master/kc/session_signing.go): `kc/session_signing.go`
- [Auth templates](https://github.com/zerodha/kite-mcp-server/tree/master/kc/templates): `kc/templates`
- [Login tool](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/setup_tools.go): `mcp/setup_tools.go`

### Account and trading

- [Tool helpers](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/common.go): `mcp/common.go`
- [Account queries](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/get_tools.go): `mcp/get_tools.go`
- [Fund holdings](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/mf_tools.go): `mcp/mf_tools.go`
- [Orders and GTT](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/post_tools.go): `mcp/post_tools.go`

### Market data

- [Market tools](https://github.com/zerodha/kite-mcp-server/blob/master/mcp/market_tools.go): `mcp/market_tools.go`
- [Instrument catalogue](https://github.com/zerodha/kite-mcp-server/blob/master/kc/instruments/manager.go): `kc/instruments/manager.go`
- [Instrument search](https://github.com/zerodha/kite-mcp-server/blob/master/kc/instruments/search.go): `kc/instruments/search.go`
- [Instrument models](https://github.com/zerodha/kite-mcp-server/blob/master/kc/instruments/instruments.go): `kc/instruments/instruments.go`

### Other components

- **AI client**
- **User browser**
- **Kite Connect API**

## Connections

- AI client → App and transports: connects via MCP (evidence: `README.md`)
- Process entry → App and transports: starts (evidence: `main.go`)
- App and transports → Kite manager: creates (evidence: `app/app.go`)
- App and transports → MCP tool registry: registers tools (evidence: `app/app.go`)
- App and transports → Usage metrics: imports (evidence: `app/app.go`)
- MCP tool registry → Login tool: registers (evidence: `mcp/mcp.go`)
- Login tool → Kite manager: creates auth session (evidence: `mcp/setup_tools.go`)
- Login tool → User browser: presents login link (evidence: `mcp/setup_tools.go`)
- User browser → Kite manager: returns authorization
- Kite manager → Session lifecycle: manages sessions (evidence: `kc/manager.go`)
- Kite manager → Session signing: verifies session IDs (evidence: `kc/manager.go`)
- Kite manager → Auth templates: sets up templates (evidence: `kc/manager.go`)
- MCP tool registry → Account queries: registers (evidence: `mcp/mcp.go`)
- MCP tool registry → Fund holdings: registers (evidence: `mcp/mcp.go`)
- MCP tool registry → Orders and GTT: registers (evidence: `mcp/mcp.go`)
- MCP tool registry → Market tools: registers (evidence: `mcp/mcp.go`)
- Account queries → Tool helpers: uses helpers (evidence: `mcp/get_tools.go`)
- Orders and GTT → Tool helpers: uses helpers (evidence: `mcp/post_tools.go`)
- Market tools → Tool helpers: uses helpers (evidence: `mcp/market_tools.go`)
- Account queries → Kite manager: gets session (evidence: `mcp/get_tools.go`)
- Fund holdings → Kite manager: gets session (evidence: `mcp/mf_tools.go`)
- Orders and GTT → Kite manager: gets session (evidence: `mcp/post_tools.go`)
- Market tools → Kite manager: gets session (evidence: `mcp/market_tools.go`)
- Account queries → Kite Connect API: requests account data (evidence: `mcp/get_tools.go`)
- Fund holdings → Kite Connect API: requests fund holdings (evidence: `mcp/mf_tools.go`)
- Orders and GTT → Kite Connect API: submits trade requests (evidence: `mcp/post_tools.go`)
- Market tools → Kite Connect API: requests market data (evidence: `mcp/market_tools.go`)
- Market tools → Instrument catalogue: searches instruments (evidence: `mcp/market_tools.go`)
- Instrument catalogue → Instrument models: indexes instruments (evidence: `kc/instruments/manager.go`)
- Market tools → Instrument search: uses search (evidence: `mcp/market_tools.go`)
