mcpField
N
nse-trading-toolkit

nse-trading-toolkit

github.com/bhala-srinivashOther53187 installsUpdated 34w ago
Repository

About nse-trading-toolkit

A trading workflow for Indian NSE/BSE equities that coordinates eight specialized analysis skills. It can work from user-provided prices or use optional data sources to inform analysis.

Key features

  1. 01Coordinates eight trading analysis skills
  2. 02Selects primary and supporting skills by question
  3. 03Covers multi-timeframe, technical, and Fibonacci analysis
  4. 04Provides frameworks for trade decisions and position sizing
  5. 05Works with manual prices or connected data sources

Use cases

  1. 01Analyze NSE/BSE stock movements
  2. 02Assess holdings and define trade triggers
  3. 03Calculate position size and stop-loss risk
  4. 04Compare trends across timeframes

MCP support

Optionally uses Groww MCP for live quotes, technical indicators, candles, and holdings; TradingView MCP is also mentioned for screening.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bhala-srinivash/nse-trading-skills --skill nse-trading-toolkit

After installing, type/nse-trading-toolkitin Claude Code to confirm it loaded.

Bundled filesevals/evals.json

Details

From the project README

NSE Trading Toolkit — Orchestrator

This is the master workflow that coordinates 8 specialized trading framework skills for Indian NSE/BSE equities.

Prerequisites

All skills work standalone with zero dependencies — they're prompt-based frameworks that Claude applies during analysis. Connecting data sources makes them more powerful:

Data SourceRequired?What It AddsSetup
Groww MCPOptionalLive quotes, portfolio, technical indicators, candle data, order placementAdd to .mcp.json (see README)
yfinanceOptionalHistorical OHLCV (>6 months), backtestingpip install yfinance
TradingView MCPOptionalCrypto screening, volume scannersSee tradingview-mcp

Without any data source: You provide prices manually, Claude applies the frameworks. With Groww MCP: Claude pulls live data automatically. Use search_stock_and_others_symbol first to resolve the trading symbol.

Groww MCP Tool Reference
ToolUse For
search_stock_and_others_symbolFind correct trading symbol
get_quotes_and_depthLive price, volume, bid/ask depth
get_historical_technical_indicatorsRSI, MACD, SMA, EMA, Bollinger, ADX, ATR
fetch_historical_candle_dataOHLCV candles (1m to 1w intervals)
get_equity_portfolio_holdingsYour current holdings and P&L
get_ltpQuick last traded price
yfinance Quick Reference
import yfinance as yf
data = yf.download("RELIANCE.NS", period="2y", interval="1d")  # NSE: .NS, BSE: .BO

Master Workflow

Follow this sequence for a full analysis. Skip steps not relevant to the user's question.

1. CONTEXT    → What does the user hold? What's their goal?
2. DATA       → Pull live quotes + historical candles + indicators
3. STRUCTURE  → Multi-timeframe analysis (→ use multi-timeframe-analysis skill)
4. TECHNICALS → Chart reading, indicators (→ use technical-analysis skill)
                 RSI divergences (→ use rsi-divergence skill)
                 Fibonacci levels (→ use fibonacci-trading skill)
5. DECISION   → Buy / Sell / Hold with specific triggers
6. SIZING     → How many shares, at what risk (→ use position-sizing skill)
7. STOPS      → Initial stop-loss (→ use stop-loss-strategies skill)
                 Trailing plan (→ use trailing-stops skill)
8. TARGETS    → R:R ratio check (→ use risk-reward-ratio skill)
                 Fibonacci extensions (→ use fibonacci-trading skill)
9. PLAN       → Concrete action plan with prices and triggers

When to Use Which Skill

User's QuestionPrimary SkillSupporting Skills
"Analyze BBTC"This orchestratorAll 8 as needed
"Position size for RELIANCE"position-sizingstop-loss-strategies, risk-reward-ratio
"Where to set stop-loss?"stop-loss-strategiestechnical-analysis (for S/R levels)
"RSI divergence on TATAMOTORS?"rsi-divergencetechnical-analysis, fibonacci-trading
"Fib levels for INFY"fibonacci-tradingtechnical-analysis
"Should I trail my stop?"trailing-stops—
"Is this trade worth taking?"risk-reward-ratioposition-sizing
"Weekly vs daily trend?"multi-timeframe-analysistechnical-analysis

Output Format

When presenting a full analysis, use this structure:

# [STOCK] Analysis — [Date]

## Quick Take
[1-2 sentence summary: bullish/bearish/neutral + key level to watch]

## Position (if held)
[Current holdings, avg price, P&L]

## Technical Setup
[Trend, key levels, indicator readings]

## Scenarios
[Bullish / Bearish / Sideways with probabilities]

## Action Plan
| Action | Trigger | Price | Size | Stop | Target | R:R |
|--------|---------|-------|------|------|--------|-----|

## Risk Summary
- Max risk: Rs.XXX (X% of capital)
- Stop-loss: Rs.XXX
- Trailing plan: [method]

Indian Market Notes

  • NSE trading hours: 9:15 AM - 3:30 PM IST
  • Pre-open session: 9:00 - 9:15 AM
  • T+1 settlement
  • Circuit limits: 5%, 10%, 20% (varies by stock)
  • STT, brokerage, GST affect actual P&L — factor ~0.1% for delivery trades
  • Use BSE symbol if NSE not available

Comments

Markdown supported