Skip to main content
skill CX Codex

broker-integration — Claude Code skill for broker connections

The broker-integration Claude Code skill connects Indian brokers through MCP servers and handles their market data and orders. It activates for broker setup, quote requests, and trade preparation.

MIT ★ 69 updated 2026-11-13

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india
/plugin install india-trading-skills@india-trading-skills
Open on GitHub

What broker-integration does

The skill guides connections to MCP servers for Groww, Zerodha Kite, Dhan, Upstox, Fyers, and Kotak Neo, then helps identify the tools exposed by each server. Available actions vary: servers may provide quotes, candles, portfolio details, or order status, while order placement depends on the broker. A candle workflow uses python3 and ta.py.

Before an order is sent, the skill requires a trade ticket and explicit confirmation. API orders require a broker-registered app and a whitelisted static IP tied to the client; dynamic IPs are rejected. Without a connected broker, ta.py can fetch data through yfinance, installed with pip install yfinance. Intraday quotes from this fallback may be delayed.

What it helps with

  • connect an Indian broker's MCP server
  • retrieve quotes, candles, or portfolio data
  • inspect the tools exposed by a broker server
  • prepare an order that waits for confirmation
  • pass candle data to ta.py for analysis

Example prompts for the agent

  • Connect Groww and show me the available tools.
  • Fetch my positions and the current share price.
  • Prepare a limit order, show its details, and wait for confirmation.

How to install broker-integration

1Plugin marketplace

/plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india
/plugin install india-trading-skills@india-trading-skills

This installs the whole india-trading-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Shubhamkumartrichy/claude-trading-skills-india --skill broker-integration -a claude-code

3Manually: put the files in place

~/.claude/skills/broker-integration/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/broker-integration/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about broker-integration

How do I install broker-integration in Claude Code?

Add the marketplace with /plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india, then install the skill with /plugin install india-trading-skills@india-trading-skills.

What does broker-integration do?

It explains how to connect Indian brokers through MCP servers and use the data and order actions those servers expose. It requires explicit confirmation before sending an order.

What does broker-integration need to work?

Connect an MCP server and complete the authentication required by that broker. API orders require a broker-registered app and a whitelisted static IP; the yfinance fallback requires the Python package installed with pip install yfinance.

Source text

SKILL.md · MIT
---
name: broker-integration
description: |
  Connect Claude to Indian brokers and use them safely: official MCP servers for Groww, Zerodha
  Kite, Dhan, Upstox, Fyers and Kotak Neo (endpoints, auth, read vs order capabilities as of Oct 2026),
  tool discovery and capability mapping, saving candles for the analysis scripts, a mandatory
  order-confirmation protocol, SEBI retail-algo/static-IP rules, and data fallbacks (yfinance, CSV).

  Use when the user asks to connect or set up Groww/Zerodha/Kite/Dhan/Upstox/Fyers/Angel One, "fetch my
  holdings/positions", "get live price", "place/modify/cancel an order", "set a GTT", "why was my order
  rejected", or when another skill needs live data.
---

# Broker Integration (India)

## Which broker does what (official MCP servers, checked Oct 2026)

| Broker | Endpoint | Auth | Can place orders? | Read access |
|---|---|---|---|---|
| **Groww** (largest by active clients, ~29% share) | `https://mcp.groww.in/mcp` | OAuth; token lasts a day | **Yes**: buy, limit and stop-loss. Sells need DDPI | Holdings, positions, P&L, candles (stocks and F&O) |
| **Zerodha Kite** | `https://mcp.kite.trade/mcp` | Kite login with 2FA | Hosted: **GTT only**. The open-source server (github.com/zerodha/kite-mcp-server) has order tools when self-hosted with your API keys | Quotes, LTP, OHLC, historical, instruments, holdings, positions, margins, MF holdings, orders and trades |
| **Dhan** | `https://mcp.dhan.co/mcp` | OAuth | **Yes**, including Super Orders | Funds, holdings, positions, order and trade book, candles. Live quotes and option chain need the Data API (₹499 + tax a month) |
| **Upstox** | `https://mcp.upstox.com/mcp` | OAuth, renewed daily | **No** (read-only). Upstox's separate Agent Skill (Python SDK) can trade | Holdings, orders, positions, MFs, funds |
| **Fyers** | `https://mcp.fyers.in/mcp` | Fyers login | No (watchlists and alerts only) | Funds, holdings, positions, orders, GTTs, option chain, history |
| **Kotak Neo** | `https://neo.kotaksecurities.com/mcp-server/mcp` | Client code + QR in app | No | Holdings, orders, positions, live prices |
| **Angel One** | No official server | — | Community servers only | Use SmartAPI directly |

Capabilities change often. After connecting, list the actual tools and trust that list over this table.

## Connect (Claude Code)

```bash
claude mcp add --transport http groww https://mcp.groww.in/mcp
claude mcp add --transport http kite  https://mcp.kite.trade/mcp
claude mcp add --transport http dhan  https://mcp.dhan.co/mcp
claude mcp add --transport http upstox https://mcp.upstox.com/mcp
# then run /mcp inside Claude Code to complete the browser login (OAuth)
```

Or commit a project `.mcp.json` (see `references/brokers.md` for more variants):

```json
{
  "mcpServers": {
    "groww": { "type": "http", "url": "https://mcp.groww.in/mcp" },
    "kite":  { "type": "http", "url": "https://mcp.kite.trade/mcp" }
  }
}
```

In Claude Desktop or claude.ai, add the URL under Settings → Connectors → Add custom connector. Older
clients can bridge with `npx mcp-remote <url>`.

## Capability map (use whatever the connected server exposes)

| Need | Kite tool | Groww tool (names as published by the community; confirm in the tool list) |
|---|---|---|
| Resolve symbol / instrument | `search_instruments` | `search_stock_and_others_symbol` |
| Live quote / depth | `get_quotes`, `get_ltp`, `get_ohlc` | `get_quotes_and_depth`, `get_ltp` |
| Candles | `get_historical_data` | `fetch_historical_candle_data` |
| Holdings / positions | `get_holdings`, `get_positions` | `get_equity_portfolio_holdings`, positions tool |
| Margins / funds | `get_margins` | margin or funds tool |
| Orders / trades | `get_orders`, `get_trades`, `get_order_history` | order book tools |
| GTT | `get_gtts`, `place_gtt_order`, `modify_gtt_order`, `delete_gtt_order` | — |

**Feeding the scripts:** write the candle response to a JSON file (the list of
`[timestamp, open, high, low, close, volume]` or a list of dicts), then run
`python3 ../technical-analysis/scripts/ta.py summary --candles candles.json --symbol X`. Compute
indicators with `ta.py`, not by eyeballing a tool's indicator output. That keeps every broker's data
consistent.

**Symbols:** always resolve F&O contracts through the instrument search. Formats differ by broker and
between weekly and monthly contracts. Kite, for example, uses `NIFTY26NOV23000CE` for monthlies and a
month-code plus day format for weeklies.

## Order protocol (mandatory)

1. **Only on an explicit request in this conversation.** Never place, modify or cancel orders from a
   loop, schedule, tip, or your own initiative.
2. **Pre-trade checks:** market open, not a holiday (`indian-market-structure`); correct exchange,
   symbol and series; quantity is a lot multiple and below the freeze limit; price inside the circuit
   band; funds and margin available; sizing within `position-sizing` limits; event risk noted.
3. **Show a ticket and wait for "yes":**
   ```
   BUY 25 TCS (NSE, EQ) | CNC | LIMIT ₹3,412.50 | DAY
   Value ₹85,312 | Est. charges ₹.. | Funds available ₹..
   Stop plan: GTT SL trigger ₹3,320 / limit ₹3,300 (separate confirmation)
   Confirm? (yes / no)
   ```
4. **LIMIT by default.** Avoid market orders in options and small caps. Use SL-limit with a buffer.
   Use GTT for stops on delivery holdings.
5. **After sending:** fetch the order status, then report the order id, status, and fill price and
   quantity. On rejection, explain the reason: margin shortfall, circuit limit, DDPI/eDIS missing for a
   sell, freeze quantity, ban-period position, product not allowed, or an expired session token.
6. **Secrets:** never ask the user to paste API secrets or TOTP seeds into chat. Self-hosted servers
   read them from environment variables. Prefer read-only connections for analysis. With Kite
   self-hosting, `EXCLUDED_TOOLS` can strip order tools.

## SEBI retail algo framework (fully in force from 1 Apr 2026)

- API orders must come from a broker-registered app with a **whitelisted static IP** tied to the client.
  Dynamic IPs are rejected.
- Strategies beyond exchange order-rate thresholds must be registered algos with exchange-issued IDs.
- How brokers apply this to hosted MCP order tools is broker-specific and not well documented. For
  self-hosted API setups (Kite Connect, Upstox API, SmartAPI, Dhan API), register the static IP first.
- In practice, MCP order tools are for **manual, confirmed, one-at-a-time orders**, not automation.

## Fallbacks when no broker is connected

- `ta.py --symbol X` uses yfinance (`pip install yfinance`). It is fine for end-of-day analysis;
  intraday quotes may be delayed.
- The user can export CSV from their charting tool or paste a screenshot of prices. Ask for the date
  and time of the data.
- NSE website reports (bhavcopy, delivery data, option chain CSV) can be downloaded manually.
  nseindia.com blocks most scripted access.

© Shubham Kumar · MIT · Shubhamkumartrichy/claude-trading-skills-india

Similar skills

All skills for Finance and business →

From the same set36

The whole set →
options-strategies This Claude Code skill helps select and assess options strategies for Indian markets. It activates for strategy selection, position management, or payoff calculations on multi-leg trades. CX Codex +1 ★ 69repo stars market-pulse The market-pulse Claude Code skill builds Indian market briefs for pre-market, intraday and closing checks. It responds to requests about GIFT Nifty, FII/DII flows, market breadth or the day’s wrap-up. CX Codex +1 ★ 69repo stars position-sizing The position-sizing Claude Code skill calculates position size and trade risk for Indian equities and F&O. It activates for questions about share or lot counts, risk per trade, and capital allocation. CX Codex +1 ★ 69repo stars technical-analysis The technical-analysis Claude Code skill reads charts for NSE/BSE stocks and indices. The agent invokes it to assess trends, price levels, indicators, and volume. CX Codex +1 ★ 69repo stars indian-tax-for-traders The indian-tax-for-traders Claude Code skill explains Indian tax treatment of stock-market income for resident individuals. It helps classify trades, estimate tax, and choose an ITR form. CX Codex +1 ★ 69repo stars fno-options-analysis The fno-options-analysis Claude Code skill analyses Indian futures and options, including option chains, volatility, Greeks and expiries. It activates for questions about NIFTY, PCR, India VIX, margins or expiry rules. CX Codex +1 ★ 69repo stars breakout-planner breakout-planner — a Claude Code skill that evaluates breakout setups for NSE/BSE stocks and works out a trade plan. It responds to requests about Stage 2 trends, bases, entry points, or scanning a stock list. CX Codex +1 ★ 69repo stars stock-screener The stock-screener Claude Code skill filters and ranks Indian stocks using fundamentals from a CSV. It runs on requests to screen a company list, find stocks by financial criteria, or explain a failed rule. CX Codex +1 ★ 69repo stars

Project sponsors

Companies that keep this analytics open