etmoney-lyr
A read-only MCP server that exposes ET Money's mutual-fund and stock research data as 10 typed tools returning structured JSON — no login, no API keys.
Fund search (
mf_search) — find funds by name, e.g. "parag parikh flexi", with a result limit.Screen funds (
mf_list) — page through 67 fund categories, filtering by group (equity/debt/hybrid/commodities/others), category, SIP vs lumpsum, duration (1m–10y), and sorted by ET Money rank, returns, or fund size.Full report card (
mf_detail) — NAV, returns vs category averages, expense breakdown, holdings, sectors, Sharpe/beta/alpha risk ratios, peers, managers, and tax treatment for a single scheme id.Fund comparison (
mf_compare) — side-by-side metrics (returns, risk ratios, expense, rank) for 2–4 funds at once.Category reference (
mf_categories) — list all fund categories with their ids for use inmf_list.Curated lists (
mf_featured) — ET Money's themed picks: best mutual funds, best SIP/index/gold funds, low risk, high return, retirement, beginners, better-than-FD, etc.Market screens (
stock_screen) — gainers, losers, 52-week and all-time highs/lows, high dividend yield, bluechip, multibagger, most active — with price, PE, and market cap.Index constituents (
index_stocks) — members of NIFTY 50 through NIFTY 500, midcap/smallcap variants, Bank, and FMCG with live metrics.Sector constituents (
sector_stocks) — stocks grouped by ET Money sector pages (autos, banking, defence, FMCG, healthcare, IT, refineries, pharma, power, telecom).Stock overview (
stock_detail) — price, day change, multi-horizon returns, scores, and peer fundamentals for a stock id or/stocks/<slug>/<id>path.Research only — no orders, SIPs, KYC, or portfolio writes; the same binary also works as an AXI-style CLI (TOON/JSON output) or a Dockerized stdio server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@etmoney-lyr Compare Parag Parikh Flexi Cap with Motilal Oswal Flexi Cap"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ET Money has no public API. Your agent wants one. etmoney-lyr reverse-engineers
ET Money's research surfaces into a local MCP server:
all 67 mutual-fund categories, stock market screens, NIFTY index and sector
constituents — served as 10 typed tools with structured JSON output.
Read-only, no login, no keys.
See it work
A real session, real numbers, straight from the tools:
// mf_search {"query": "parag parikh"}
{ "total": 7, "results": [ { "scheme_id": 19230, "name": "Parag Parikh Flexi Cap Fund Regular-Growth", ... } ] }
// mf_detail {"scheme_id": 19230}
{
"name": "Parag Parikh Flexi Cap Fund Regular-Growth",
"riskometer": "Very High",
"nav": 82.81,
"expense_ratio_total_pct": 1.29,
"trailing_returns": [ { "period": "1 Year", "fund_pct": -2.02, "category_avg_pct": 1.58 }, "...9 more horizons" ],
"holdings": [ { "name": "HDFC Bank Ltd.", "bucket": "EQUITY", "pct": 7.55 }, "...84 more" ],
"sectors": [ { "name": "Financial", "pct": 25.69 }, "...17 more" ],
"risk_ratios_fund": { "sharpeRatio": 0.76, "beta": 0.60, "alpha": 3.48 },
"risk_ratios_category": { "sharpeRatio": 3.54, "beta": 0.57 },
"managers": [ "Raj Mehta", "Rajeev Thakkar", "+4" ]
}
// mf_compare {"scheme_ids": [19230, 25643]}
{ "funds": [ { "name": "Parag Parikh Flexi Cap...", "etm_rank": 9, "rating": 5, "sharpe": 0.76 },
{ "name": "Motilal Oswal Flexi Cap...", "etm_rank": 7, "rating": 3, "sharpe": 0.75 } ] }Every number above is parsed from ET Money's own pages — not hand-typed.
Verified: 195 offline tests against captured fixtures · 54 live end-to-end checks across every tool and parameter edge · protocol handshake tested through the real stdio binary and Docker image.
Related MCP server: financial-datasets
What it covers
Tools | What your agent can ask | |
Mutual funds |
| Screen any of 67 categories (large cap → gold → index funds → retirement), full report cards with holdings & risk ratios, side-by-side compares of up to 4 funds |
Stocks |
| Gainers/losers/52-week extremes/multibagger screens, NIFTY 50–500 & Bank constituents, sector lists, per-stock fundamentals |
Typical flow: mf_search("small cap") → mf_detail(6558) → mf_compare([6558, 11077]).
Install
# uv from GitHub — the one-liner
uv tool install git+https://github.com/ishan-parihar/etmoney-lyr.git
# or the bootstrapping installer (installs uv if missing; pipx/pip fallbacks)
curl -fsSL https://raw.githubusercontent.com/ishan-parihar/etmoney-lyr/main/install.sh | bash
# upgrade anytime
uv tool upgrade etmoney-lyrRequires Python 3.11+ — uv provisions it automatically.
Point your agent at it
{
"mcpServers": {
"etmoney": {
"command": "etmoney-lyr",
"args": []
}
}
}That's it. The same binary is dual-mode: an interactive terminal shows a help home view; piped stdin serves MCP.
etmoney-lyr search "hdfc small cap" # TOON output built for agents
etmoney-lyr fund 19230 --full # full report card
etmoney-lyr stocks top_gainers # market screens
etmoney-lyr categories # category id reference
etmoney-lyr --list-tools --fields stock # tool inventory
docker build -t etmoney-lyr .
docker run -i --rm etmoney-lyr # stdio MCP server in a containerCLI output is TOON by default (token-efficient), with --json when you want raw.
Errors are machine-readable (error: / help: lines) and always exit code 2.
How it works
ET Money's web app leaks its data through three different mechanisms — each gets a dedicated parser instead of one brittle HTML scraper:
JSON APIs for the screener and search (the site's own XHR contract)
Embedded JS DTOs on fund pages — full report cards arrive as ready-made JSON inside
<script>var compSchemeDTO = …; parsing HTML tables would be strictly worseNext.js RSC flight payloads on stock pages, reassembled from
self.__next_f.push()chunks
Parsers are pinned to committed fixture copies of real pages, so markup drift
fails tests loudly instead of silently corrupting numbers. Indian number formats
(₹1,48,429 Cr, 13 yrs 3 m) are normalized to floats everywhere.
Limits, honestly
Research only. No orders, SIPs, KYC, or portfolio writes — by design. Portfolio tracking and Genius insights sit behind login upstream and are out of scope.
App-exclusive data (interactive ET Money Rank scorecard, Genius verdicts) isn't exposed; the rank commentary that ships on public pages is included.
Upstream drift: ET Money can change its pages anytime. Fixture tests catch structural breaks; run
python scripts/live_check.pyafter any parser change.
Development
git clone https://github.com/ishan-parihar/etmoney-lyr && cd etmoney-lyr
uv sync --dev
uv run pytest # 195 tests, fully offline via fixtures
uv run ruff check . # lint
uv run python scripts/live_check.py # optional: 54 checks against live sitePart of the -lyr family (twitter-lyr,
reddit-lyr,
swiggy-lyr): one platform, one
MCP server, one AXI-compliant CLI.
License
MIT — see LICENSE. Not affiliated with ET Money / 360 ONE; data is public research information. Nothing here is investment advice.
Updating
Use etmoney-lyr update --check to check without changing the installation, or etmoney-lyr update to update it. etmoney-lyr upgrade is an alias. The command delegates to the manager that owns this installation (uv, pipx, or pip) and refuses editable, local-checkout, system, or unknown installs instead of replacing package-manager-owned files. For example: uv tool upgrade etmoney-lyr.
Available Tools
10 toolsindex_stocksC
Constituents of major NSE indices with live metrics.
Inputs: index (required), limit. Returns: object
mf_categoriesA
All fund categories with ids (use with mf_list's category param).
Inputs: no named parameters. Returns: object
mf_compareA
Side-by-side compare of 2-4 funds (returns, risk ratios, expense, rank).
Inputs: scheme_ids (required). Returns: object
mf_detailA
Full fund report card by scheme id: NAV, returns vs category, expense breakdown, holdings, sectors, risk ratios, peers, managers, tax treatment.
Inputs: scheme_id (required). Returns: object
mf_featuredD
ET Money curated lists: best_mutual_funds, best_sip_funds, best_index_funds, best_gold_funds, low_risk, high_return, retirement, beginners, better_than_fd...
Inputs: theme (required). Returns: object
mf_listB
Browse/screen funds across all 67 categories (index, gold, silver, FoF, sectoral, debt durations, hybrid, retirement, international...).
Inputs: page, size, group, sort_by, +4 more. Returns: object
mf_searchB
Search mutual funds by name (e.g. 'parag parikh flexi', 'small cap').
Inputs: query (required), limit. Returns: object
sector_stocksC
Stocks grouped by ET Money sector pages.
Inputs: sector (required), limit. Returns: object
stock_detailB
Stock overview by numeric id or '/stocks//' path: price, day change, returns across horizons, scores, peer fundamentals.
Inputs: stock_ref (required). Returns: object
stock_screenC
ET Money market-data screens (gainers/losers/52w extremes/multibagger/ bluechip/most active/dividend yield) with price, PE, market cap per stock.
Inputs: screen (required), limit. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct resource and operation. Mutual fund tools (mf_*) are separated by action (search, detail, list, compare, featured, categories) and stock tools (stock_screen, index_stocks, sector_stocks, stock_detail) cover distinct data views. No two tools appear to do the same thing.
Mutual fund tools share a consistent 'mf_' prefix pattern. Stock tools are slightly inconsistent: 'stock_screen' and 'stock_detail' use 'stock_', while 'index_stocks' and 'sector_stocks' embed the resource type before 'stocks'. This is a minor deviation from a uniform pattern but still predictable and readable.
With 10 tools, the server is well-scoped for covering two asset classes (mutual funds and stocks). Each tool serves a clear purpose, and the count is within the optimal 3-15 range, neither bloated nor insufficient.
Mutual fund coverage is strong (search, detail, list, compare, featured, categories), but stock coverage has a notable gap: no tool for searching stocks by name, requiring users to already know stock IDs or slugs. This limits discovery and may cause agent failures when trying to locate a specific stock.
Maintenance
Related MCP Connectors
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.
SEC filings — 13F, Form 4, 8-K, 13D, IPO and short-interest data — as 17 agent tools.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to fetch Indian mutual-fund NAVs and NSE market data, calculate GST and income-tax amounts, and look up RBI policy rates, with provenance blocks for citations. Works with any MCP client over stdio or HTTP.17MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query financial datasets, including institutional holders, insider transactions, investor portfolios, and SEC filings, via MCP tools.95 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to research Indian stock markets by accessing NSE/BSE corporate filings with measured price reactions, fundamentals, a 108-metric screener, IPO pipeline, FPI flows, results calendar, and daily market briefings through MCP tools.2MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search, screen, and analyze 8,200+ NSE and BSE listed stocks through 55 tools covering live quotes, quarterly financials, technical indicators, a 326-ratio screener, FII/DII flows, option chains and IV, corporate filings, IPOs, bulk deals, and portfolio P&L. It can be connected remotely over OAuth or locally via npx/uvx from Claude, ChatGPT, Cursor, VS Code, Codex, Gemini CLI, and other MCP clients.MIT