# Fundalysis MCP server: Ask your AI about mutual funds

> Connect Fundalysis to Claude, ChatGPT, Cursor or VS Code and ask about Indian mutual funds in plain words: what a fund manager bought, which holdings are under water, how a scheme does against its peers.

- Server URL: https://fundalysis.darkhorsestocks.in/mcp (the same address, opened in a browser, is this page)
- Covers 2,155 schemes, 49 fund houses, 4,152 stocks and 620 fund managers through 17 read-only tools.

Connect Fundalysis to Claude, ChatGPT or Cursor and ask in plain words: what a fund manager bought, which holdings are under water, how a scheme does against its peers. Your AI looks it up in every scheme's portfolio since 2012 as it answers.

## Connect

### Claude

claude.ai and the Claude desktop app, on any plan: Free allows one custom connector.

1. Open Settings › Connectors
2. Choose Add custom connector, name it Fundalysis and paste the server URL:
   ```
   https://fundalysis.darkhorsestocks.in/mcp
   ```
3. Press Connect and sign in with your Darkhorsestocks account.
4. In a chat, switch Fundalysis on from the tools menu, then ask away. + › Connectors › Fundalysis

On Team and Enterprise, an owner adds the connector for everyone first.

### ChatGPT

chatgpt.com in a browser, on Plus, Pro, Business, Enterprise or Education. The desktop and mobile apps can't add one.

1. Turn on Developer mode: Settings › Security and login › Developer mode
2. Go to chatgpt.com/plugins, press +, name it Fundalysis, set Authentication to OAuth and paste the server URL:
   ```
   https://fundalysis.darkhorsestocks.in/mcp
   ```
3. It lands under Drafts. In a chat, pick it from the plus menu: + › Developer mode › Fundalysis

### Claude Code

Anthropic's coding agent, in your terminal.

1. Add the server:
   ```sh
   claude mcp add --transport http fundalysis https://fundalysis.darkhorsestocks.in/mcp
   ```
2. Run /mcp in Claude Code, pick fundalysis and sign in, then ask in plain words.

### Cursor

The Cursor editor's agent.

1. Add it in one click:
   [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=fundalysis&config=eyJ1cmwiOiJodHRwczovL2Z1bmRhbHlzaXMuZGFya2hvcnNlc3RvY2tzLmluL21jcCJ9)
2. Or add it to ~/.cursor/mcp.json yourself:
   ```json
   {
     "mcpServers": {
       "fundalysis": {
         "url": "https://fundalysis.darkhorsestocks.in/mcp"
       }
     }
   }
   ```

### VS Code

GitHub Copilot's agent mode in VS Code.

1. Add it in one click:
   [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22fundalysis%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ffundalysis.darkhorsestocks.in%2Fmcp%22%7D)
2. Or from a terminal:
   ```sh
   code --add-mcp '{"name":"fundalysis","type":"http","url":"https://fundalysis.darkhorsestocks.in/mcp"}'
   ```

### Other apps

Any app that speaks MCP over Streamable HTTP connects to the URL as it is, and signs in with OAuth the first time.

1. Point it at the server URL:
   ```
   https://fundalysis.darkhorsestocks.in/mcp
   ```
2. An app that only runs local servers can reach it through mcp-remote:
   ```json
   {
     "mcpServers": {
       "fundalysis": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://fundalysis.darkhorsestocks.in/mcp"
         ]
       }
     }
   }
   ```

## What you can ask

Ask it as you'd ask a person; your AI picks the tools. Open one in Claude or ChatGPT with Fundalysis connected, or copy it.

### Fund managers

- What did Vinit Sambre buy in the last 3 months? (tools: search, get_changes)
- Which companies has Vinit Sambre held for more than a year that are now down 20% or more from what his funds paid? (tools: search, get_average_cost)
- How has Rajeev Thakkar done on each scheme he has run, against its peers and its benchmark? (tools: search, get_manager_performance)
- Which schemes does Samir Rachh run now, and what did he run before? (tools: search, get_fund_manager)

### Schemes

- Compare Parag Parikh Flexi Cap's 1, 3 and 5 year returns with the middle flexi cap fund. (tools: search, get_scheme)
- What did Nippon India Small Cap Fund buy and sell last month? (tools: search, get_changes)
- What are SBI Small Cap Fund's expense ratio and benchmark, and who runs it? (tools: search, get_scheme)
- How is Parag Parikh Flexi Cap split by market cap and by sector? (tools: search, get_allocation)

### Stocks

- Which mutual funds hold the most HDFC Bank, and who added to it last month? (tools: search, get_holdings, get_changes)
- On average, what did mutual funds pay for Nestle India, and are they in profit? (tools: search, get_average_cost)
- How many schemes hold ITC, and how has that changed over the past year? (tools: search, get_stock, get_changes)
- Show HDFC Bank's monthly share price since 2020, and any splits or bonuses. (tools: search, get_stock_prices)

### Fund houses

- What are SBI Mutual Fund's 10 largest holdings, and what did it sell last month? (tools: search, get_holdings, get_changes)
- How has HDFC Mutual Fund's market share moved over the last 5 years? (tools: search, get_aum_history)
- Which stocks in HDFC Mutual Fund's schemes are down more than 30% from what they paid? (tools: search, get_average_cost)
- How is ICICI Prudential Mutual Fund's money split across equity, debt and hybrid, and which states does it come from? (tools: search, get_fund_house)

### Sectors

- Which schemes hold the most bank stocks right now? (tools: search, get_holdings)
- Which fund managers hold the most IT software stocks? (tools: search, get_holdings)
- What did mutual funds buy and sell in pharma last month? (tools: search, get_changes)
- Which fund houses hold the most power stocks, and how much of their AUM is that? (tools: search, get_holdings)

### Mix

- List the 5 largest small cap funds by AUM and what each bought last month. (tools: list, get_changes)
- Which small cap funds have the best 3 year returns with an expense ratio under 1%? (tools: list)
- Which stocks do both Parag Parikh Flexi Cap and HDFC Flexi Cap hold? (tools: search, get_portfolio)
- How big is the mutual fund industry now, and which fund houses gained the most share this year? (tools: get_industry)

## Tools

What your AI can call. It reads these itself; you never name them.

### Find

#### search: Search

Find any scheme, stock, fund house, sector or fund manager by name.

Inputs:
- `query` (needed): A name or part of one.
- `types` (optional): Only these types; all when left out.
- `limit` (optional): Results to return, at most 25.

#### list: Rank a list

Rank every scheme, stock, fund house, sector or manager by any column.

Inputs:
- `kind` (needed): What to list: category is the scheme types.
- `within` (optional): Schemes only: one scheme type's or asset class's (search finds a type's name as a category).
- `houseId` (optional): Schemes only: one fund house's, by its id.
- `sort` (optional): A column id to rank by, largest first (see columns); the list's own order (largest first) when left out.
- `ascending` (optional): Smallest first instead.
- `offset` (optional): Rows to skip: the `next` of the previous page.
- `limit` (optional): Rows to return, at most 200.

### Schemes

#### get_scheme: Scheme profile

A scheme's AUM, costs, exit load, managers, returns against peers and top holdings.

Inputs:
- `id` (needed): The scheme's id, from search (type fund).

#### get_portfolio: Scheme portfolio

Everything a scheme held, in any month it reported.

Inputs:
- `id` (needed): The scheme's id, from search (type fund).
- `month` (optional): The month, YYYY-MM; its latest when left out.
- `offset` (optional): Rows to skip: the `next` of the previous page.
- `limit` (optional): Rows to return, at most 200.

#### get_nav_history: Scheme NAV history

A scheme's NAV at every month's end since 2006.

Inputs:
- `id` (needed): The scheme's id, from search (type fund).
- `from` (optional): The first month, YYYY-MM; its first NAV when left out.
- `until` (optional): The last month, YYYY-MM; the latest when left out.

### Holdings and trades

#### get_holdings: Holdings

Who holds a stock, or what a scheme, fund house, manager or sector holds.

Inputs:
- `type` (needed): stock: a company's share (or a bond, REIT, foreign share); fund: a mutual fund scheme; house: a fund house (AMC); sector: a box of NSE's industry tree; manager: a fund manager.
- `id` (needed): Its id, from search (or any answer's `id`).
- `view` (optional): A grouped view instead of the rows themselves: sector (scheme, fund house, manager and sector pages), fund or manager (sector pages), house (stock and sector pages).
- `offset` (optional): Rows to skip: the `next` of the previous page.
- `limit` (optional): Rows to return, at most 200.

#### get_holding_history: Holding over time

One holding month by month: its value, shares and share of NAV.

Inputs:
- `type` (needed): stock: a company's share (or a bond, REIT, foreign share); fund: a mutual fund scheme; house: a fund house (AMC); sector: a box of NSE's industry tree; manager: a fund manager.
- `id` (needed): Its id, from search (or any answer's `id`).
- `other` (needed): The row's id: a scheme on a stock, a company elsewhere, or the view's group (a sector, scheme, fund house or manager).
- `view` (optional): A grouped view instead of the rows themselves: sector (scheme, fund house, manager and sector pages), fund or manager (sector pages), house (stock and sector pages).
- `from` (optional): The first month, YYYY-MM; all history when left out.

#### get_changes: Buys and sells

What was bought, added to, trimmed and sold out, month by month.

Inputs:
- `type` (needed): stock: a company's share (or a bond, REIT, foreign share); fund: a mutual fund scheme; house: a fund house (AMC); sector: a box of NSE's industry tree; manager: a fund manager.
- `id` (needed): Its id, from search (or any answer's `id`).
- `view` (optional): A grouped view instead of the rows themselves: sector (scheme, fund house, manager and sector pages), fund or manager (sector pages), house (stock and sector pages).
- `measure` (optional): value (₹ crore at month-end prices), quantity (shares) or share (%, of what shareOf says).
- `from` (optional): The first month, YYYY-MM.
- `until` (optional): The last month, YYYY-MM; the latest when left out.
- `filter` (optional): Only rows with this kind in a month shown.
- `offset` (optional): Rows to skip: the `next` of the previous page.
- `limit` (optional): Rows to return, at most 200.

#### get_allocation: Allocation

The split by market cap and by sector, or for a stock by fund house.

Inputs:
- `type` (needed): stock: a company's share (or a bond, REIT, foreign share); fund: a mutual fund scheme; house: a fund house (AMC); sector: a box of NSE's industry tree; manager: a fund manager.
- `id` (needed): Its id, from search (or any answer's `id`).
- `offset` (optional): Rows to skip: the `next` of the previous page.
- `limit` (optional): Rows to return, at most 200.

### Stocks and prices

#### get_stock: Stock profile

A stock's tickers, sector, latest price and how much funds own of it.

Inputs:
- `id` (needed): The stock's id, from search (type stock).

#### get_stock_prices: Share prices

Daily or monthly share prices since 2012, with splits and bonuses.

Inputs:
- `id` (needed): The stock's id, from search (type stock).
- `interval` (optional): month: a row a month, its last close; day: a row a trading day, at most 400.
- `from` (optional): The first month, YYYY-MM.
- `until` (optional): The last month, YYYY-MM; up to today when left out.

#### get_average_cost: Funds' average buy price

What funds paid for a share on average, how long they've held it and how far it's up or down.

Inputs:
- `type` (needed): stock: who paid what for it; fund, house, manager: what the scheme, the fund house's schemes or the manager's schemes paid for each share.
- `id` (needed): Its id, from search (or any answer's `id`).
- `history` (optional): Stock only: every month's all-funds average and close too.
- `heldMonths` (optional): Not stock: only shares held at least this many months.
- `heldMonthsMax` (optional): Not stock: only shares held at most this many months.
- `stock` (optional): type fund only: one share's id, for the scheme's holding of it month by month.
- `gainBelow` (optional): Not stock: only shares at most this % up on what was paid (-20: down 20% or more).
- `gainAbove` (optional): Not stock: only shares at least this % up on what was paid.
- `sort` (optional): Not stock: cost (largest first) or gain (most down first).
- `offset` (optional): Rows to skip: the `next` of the previous page.
- `limit` (optional): Rows to return, at most 200.

### Fund houses and the industry

#### get_fund_house: Fund house profile

A fund house's AUM, market share, asset mix, schemes and managers.

Inputs:
- `id` (needed): The fund house's id, from search (type house).

#### get_aum_history: AUM over time

AUM over time for a scheme, a fund house or the whole industry.

Inputs:
- `type` (needed): fund: a scheme's AUM; house: a fund house's; industry: every fund house's together.
- `id` (optional): The scheme's or fund house's id; none for the industry.
- `from` (optional): The first month, YYYY-MM; all when left out.

#### get_industry: Mutual fund industry

The industry's AUM, its asset mix and every fund house's market share.

Inputs: none.

### Fund managers

#### get_fund_manager: Fund manager profile

A manager's profile, career and every scheme they run and ran.

Inputs:
- `id` (needed): The fund manager's id, from search (type manager).

#### get_manager_performance: Fund manager's track record

How each scheme did while a manager ran it, against peers and its benchmark.

Inputs:
- `id` (needed): The fund manager's id, from search (type manager).

## Good to know

- **Read-only**: It can only look things up. It can't trade, change anything or see your accounts.
- **Sign in once**: The first time you connect, your app opens the Darkhorsestocks sign-in, then asks you to allow it. Up to 30 calls a minute per account.
- **Where the data comes from**: Each scheme's own monthly portfolio since Sep 2012, AMFI's AUM, NAVs and returns, NSE's and BSE's prices, and each scheme's documents for its managers and costs. A month's portfolios land 10 to 15 days after it ends.
- **What we keep**: Each call your AI makes to us: the tool, what it asked for and how long it took, to see what's useful and fix what fails. Never your chat: your AI only sends us its tool calls.
- **Not advice**: Every answer is what the schemes disclosed, worked out. What to buy or sell is yours to decide.
