Skip to main content
Glama
etmoney-lyr

etmoney-lyr

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

mf_search mf_list mf_detail mf_compare mf_categories mf_featured

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

stock_screen index_stocks sector_stocks stock_detail

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-lyr

Requires 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 container

CLI 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 worse

  • Next.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.py after 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 site

Part 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 tools
index_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_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

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

    B3.1/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      17
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to query financial datasets, including institutional holders, insider transactions, investor portfolios, and SEC filings, via MCP tools.
      95 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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