● FREE · NO API KEY · NO ACCOUNT

LIVE MARKET DATA
FOR YOUR AI AGENT

A Model Context Protocol server for Indian equities. Live NSE and BSE quotes, 57 technical indicators, 54 fundamental ratios and a stock screener, over plain MCP stdio, from three free public sources.

npx -y @aswathas/trademcp

npm: waiting on publish The package is written and tested, but it is not on the registry yet, so that command will not resolve yet. The one below works today: same server, same tools, no key. Full install.

git clone https://github.com/aswathas/TradeMCP && pip install -e .

Cursed technique Tick ▸ —

Analysis panel

SNAPSHOT · RELIANCE INDUSTRIES · NSE

Last price —INR

Change −0.76% on 1.56 Cr volume

P/E 22.46 from statement EPS

ROE 8.93% net income ÷ equity

ROCE 11.52% EBIT ÷ invested capital

Debt / equity 0.44 net debt ₹260,673 Cr

Dividend yield 0.50% current ratio 1.10

Technical score — not in this snapshot

−100 SELLNEUTRAL+100 BUY

52-week range

— · low — · high —

RSI 14 · 46.58

oversold 30 · overbought 70

Health score · 62.10

0–100 across 54 ratios

Snapshot captured 21 Oct 2026, 03:20 IST from Yahoo Finance, NSE archives and Screener.in.

Developer Paste one config block. The agent gets the tools.

Trader Every ratio is computed from raw statement lines, not scraped off a screen.

14tools
57technical indicators
54fundamental ratios
3free data sources
0API keys

MARKET BOARD

The same numbers, from the last server run

Cursed chart & screener filter Infinite convergence chart Chart & screener filter

These candles are a saved run of the TradeMCP server, and the indicators below are recomputed in your browser from that same raw series. Type any NSE symbol and press Enter.

Reliance Industries Limited …

— snapshot feed

Ritual · finger synchronisation — / 20 seals converged Limitless · six eyes — / 6 lenses charged

INDICATORS · COMPUTED HERE

FUNDAMENTALS · TRAILING

THE SCREENER

Filter 50 real NIFTY constituents

Every row was pulled by trademcp_screen_stocks and trademcp_compare_stocks, the same tools your agent calls. The filters below apply the same predicates the server applies, and the panel prints the exact call.

Search symbol, company or industry

Max P/E 800 Min ROE % -50 Min ROCE % -50 Min div yield % 0 Max D/E 20 Max RSI 100 Min RSI 0 Min rev CAGR % -100 Min health -500 Min mkt cap ₹Cr 0

SEND THIS TO YOUR AGENT

— matching

Click any row to load that symbol into the board above.

THE CATALOGUE

14 tools, 64 parameters

Every tool runs over plain MCP stdio. Open a card to read its parameters — the front stays scannable, the detail lives on the back.

01trademcp_get_quote3 params

Latest price quote and key statistics for an Indian stock.

symbol required: string — NSE symbol or company name, e.g. RELIANCE or tata motors
exchange: string — NSE or BSE
response_format: markdown or json

02trademcp_get_fundamentals3 params

A full fundamental picture: valuation, profitability, leverage, liquidity, growth and DuPont.

symbol required: string — NSE symbol or company name, e.g. HDFCBANK
include_india_metrics: boolean — add India-specific ratios from Screener.in
response_format: markdown or json

03trademcp_get_valuation3 params

A focused valuation sheet, optionally against a peer set from the same NSE industry.

symbol required: string — e.g. BAJFINANCE
peers: boolean — also fetch a small peer set for comparison
response_format: markdown or json

04trademcp_get_financial_statements4 params

Income statement, balance sheet and cash flow line items.

symbol required: string — e.g. SBIN
period: string — annual or quarterly
years: integer — how many periods to include (1–10)
response_format: markdown or json

05trademcp_get_price_history6 params

Historical OHLCV candles for an Indian stock.

symbol required: string — e.g. INFY
range: string — 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
interval: string — 1d, 1wk, 1mo, 1h, 30m, 15m, 5m
limit: integer — maximum candles (1–500)
exchange: string — NSE or BSE
response_format: markdown or json

06trademcp_get_technical_indicators6 params

Compute any of the 57 technical indicators, computed in pure Python.

symbol required: string — e.g. RELIANCE
indicators: array — e.g. ['rsi_14','macd','atr_14']; omit for all
range: string — 3mo, 6mo, 1y, 2y, 5y
interval: string — 1d, 1wk, 1h, 30m
limit: integer — recent points kept per indicator (1–100)
response_format: markdown or json

07trademcp_get_technical_analysis4 params

Full technical analysis with a directional read, risk statistics and recent candlestick patterns.

symbol required: string — e.g. INFY
range: string — 6mo, 1y, 2y, 5y
benchmark: string — NIFTY 50 or SENSEX for beta and relative strength
response_format: markdown or json

08trademcp_get_support_resistance3 params

Support and resistance levels computed from swing structure.

symbol required: string — e.g. TCS
range: string — 6mo, 1y, 2y, 5y
response_format: markdown or json

09trademcp_screen_stocks19 params

Screen Indian stocks by fundamental and technical criteria. NIFTY 50 in 8.8 s cold, 3.6 s warm.

universe: string — NIFTY 50, NIFTY 100, NIFTY 500 or NSE
min_pe / max_pe: number — P/E bounds
min_roe: number — return on equity (%)
min_roce: number — return on capital employed (%)
min_net_margin: number — net profit margin (%)
max_debt_to_equity: number — leverage ceiling
min_market_cap: number — in rupees
min_dividend_yield: number — (%)
min_current_ratio: number — liquidity floor
min_revenue_cagr: number — 3-year revenue CAGR (%)
rsi_below / rsi_above: number — oversold and overbought screens
above_sma50 / above_sma200: boolean — trend filters
limit: integer — maximum stocks returned (1–100)
sort_by: string — market_cap, pe_ratio, roe_pct, health_score and more
sort_order: string — desc or asc
response_format: markdown or json

10trademcp_compare_stocks2 params

Compare two to five Indian stocks across price, valuation, quality and momentum.

symbols required: array — two to five NSE symbols or company names
response_format: markdown or json

11trademcp_analyze_portfolio3 params

Analyse an Indian equity portfolio: weights, P&L, concentration risk and per-position technicals.

holdings required: array — e.g. [{'symbol':'RELIANCE','quantity':10,'cost_price':1200}]
benchmark: string — NIFTY 50 or SENSEX
response_format: markdown or json

12trademcp_get_index_snapshot2 params

Live quotes for 15 major Indian indices.

indices: array — e.g. ['NIFTY 50','SENSEX','NIFTY BANK']; omit for the default set
response_format: markdown or json

13trademcp_get_market_breadth3 params

Measure market breadth for an Indian index across its constituents.

index: string — NIFTY 50 or NIFTY 100
include_trend: boolean — also count constituents above their 200-day average (slower)
response_format: markdown or json

14trademcp_search_symbol3 params

Search NSE-listed companies by ticker symbol or company name.

query required: string — e.g. RELIANCE, tata, bank of baroda
limit: integer — maximum results (1–50)
response_format: markdown or json

THE METRICS

57 indicators. 54 ratios. 18 candlestick patterns.

No pandas, no numpy, no yfinance. Every indicator is computed in pure Python, and every ratio is derived locally from raw statement lines.

Those names are a catalogue, not a manual. Every formula, its parameters and a worked example are in the tool reference, and the live board above shows the ones that matter for the stock you are looking at.

TECHNICAL · 57

Indicators

FUNDAMENTAL · 54

Ratios

ALSO INCLUDED

And more

18 candlestick patterns, 5 pivot point styles
DuPont identity, reconciled end to end
0–100 health score with a per-metric breakdown
Sharpe, Sortino, max drawdown, beta, alpha
ROCE, promoter / FII / DII holding, debtor days
15 indices, from NIFTY 50 to INDIA VIX

THE CALL Standing by

An agent asks. The market answers.

Everything else on this page is what the server returns. This is the part before that: the JSON-RPC handshake your agent performs to get it. The request that goes out, the response that comes back, and how long the round trip actually took.

REQ Caller AGENT mcp client Server MARKET trademcp reading

— — — —

Request jsonrpc 2.0 · tools/call

Response result.content[0].text

Tool: trademcp_get_quote
Method: tools/call
Latency: —
Source: —
Payload: —

The page calls /api/quote over HTTP; the showcase server turns that into one MCP tools/call over stdio against the real server. No API key, no relay, no hard-coded price.

HOW IT WORKS

Five steps, then it caches

1
Resolve

RELIANCE, tata motors, NSE:TCS, RELIANCE.NS, INE002A01018 and nifty all resolve to the same instrument.
2
Fetch

Prices from Yahoo's chart endpoint, statements from its timeseries endpoint, symbol identity from NSE's static CSV listings.
3
Compute

Each ratio is derived from raw statement lines, so valuation, profitability and leverage reconcile with each other and with DuPont.
4
Score

Indicators become signals, signals become a composite score from Strong Buy to Strong Sell, explained in plain language.
5
Cache

Responses are cached on disk with per-type TTLs, so repeated screens stay off the free endpoints and stay fast.

SOURCES

Three sources. All free. All keyless.

If a source changes its markup, that one section degrades. The rest keeps working.

Yahoo Finance

Chart, quote and fundamentals-timeseries. Public JSON endpoints; the quote endpoint needs a free cookie and crumb handshake, which the server does itself.

OHLCV candles, 52-week range
Price, market cap, multiples, dividend yield
Annual, quarterly and trailing statement lines

NSE static archives

Symbol universe, company names, ISIN, industry and index membership, from static CSV listings that need no session.

NIFTY 50 / 100 / 500 listings
Full listed-company equity universe
Not behind the bot protection on the live JSON API

Screener.in

India-specific ratios and ownership, parsed defensively and treated as optional.

ROCE and book value, on Screener's own definition
Promoter, FII, DII and public holding
Debtor days, inventory days, cash conversion cycle

TradeMCP reports ROCE as EBIT ÷ invested capital. Screener.in reports its own ROCE on a different capital base. Both are shown; they are never merged.

INSTALL

Install it, then restart your client

The npm package is waiting on a publish, so the source path below is what works today. Same server, same fourteen tools, no key, no signup, no dashboard.

From source — works today

git clone https://github.com/aswathas/TradeMCP.git
cd TradeMCP
python -m venv .venv
.venv/Scripts/activate          # macOS / Linux: source .venv/bin/activate
pip install -e .

Two dependencies, mcp and httpx, and nothing else. The server then runs as python -m trademcp or as the trademcp command.

npx waiting on publish

npx -y @aswathas/trademcp

That is the whole install. The package carries the Python server and builds its own environment on first run, so all you need is Node 18+ and Python 3.11+. No clone, no venv, no pip. The first run spends about half a minute building that environment; every run after that is about a second.

Global install

npm i -g @aswathas/trademcp

If your MCP client has a short start-up timeout, install the package once like this and point the client at the trademcp command instead of npx. The environment is built at install time, so the server starts in about a second.

claude_desktop_config.json

{
  "mcpServers": {
    "trademcp": {
      "command": "npx",
      "args": ["-y", "@aswathas/trademcp"]
    }
  }
}

For Claude Desktop, Cursor, Windsurf and VS Code. In Claude Code it is a single line: claude mcp add trademcp -- npx -y @aswathas/trademcp.

Manual setup

{
  "mcpServers": {
    "trademcp": {
      "command": "python",
      "args": ["-m", "trademcp"]
    }
  }
}

If you installed from source and want to point at your own interpreter, use this instead: git clone, python -m venv .venv, pip install -e ., then python -m trademcp. python must be the interpreter that has TradeMCP installed — scripts/install.ps1 prints the exact path to paste. Installed globally instead? Use "command": "trademcp" with no args.

1
Install
```
npx -y @aswathas/trademcp
```
Or from source: clone, python -m venv .venv, pip install -e ., then python -m trademcp.
2
Verify it works
```
python scripts/verify_all_tools.py
python -m pytest tests -q
```
109 offline unit tests, plus a live call against every one of the 14 tools.
3

Ask your agent

“What is the technical score on TCS over one year, and is it above its 200-day average?”

CONFIGURATION

Every setting has a default

Environment variables and their defaults
Variable	Default	Purpose
`TRADEMCP_TIMEOUT`	30	Request timeout in seconds
`TRADEMCP_CACHE_DIR`	~/.cache/trademcp	Disk cache location
`TRADEMCP_QUOTE_TTL`	300	Quote cache lifetime
`TRADEMCP_PRICE_TTL`	900	Price history cache lifetime
`TRADEMCP_FUNDAMENTALS_TTL`	21600	Fundamentals cache lifetime
`TRADEMCP_UNIVERSE_TTL`	43200	Symbol universe cache lifetime
`TRADEMCP_MAX_CONCURRENCY`	8	Parallel outbound requests
`TRADEMCP_ENABLE_SCREENER_IN`	1	Set to 0 to skip Screener.in

LIVE MARKET DATAFOR YOUR AI AGENT

Analysis panel

Indicators

Ratios

And more

Resolve

Fetch

Compute

Score

Cache

Yahoo Finance

NSE static archives

Screener.in

Install

Verify it works

Ask your agent

LIVE MARKET DATA
FOR YOUR AI AGENT