Stock market MCP server

Free MCP for the Indian stock market

Foliyo Markets is a free MCP server for the Indian stock market. It gives Claude, ChatGPT and any AI agent end-of-day prices, NAVs and returns for 2,900+ Indian stocks and ETFs, 35 benchmark series and 7 GIFT City funds.

How to connect

Endpointhttps://mcp.foliyo.ai/markets

You askHow have Reliance and the Nifty 50 done over the last year?
get_quotes({ instruments: ["stock:RELIANCE", "index:NIFTY_50"] })
{
  "quotes": [
    {
      "id": "stock:RELIANCE",
      "name": "RELIANCE INDUSTRIES LTD",
      "price": 1170.3, "currency": "INR",
      "price_type": "close", "as_of": "2026-10-09",
      "returns_pct": { "d1": -0.65, "d30": -8.5, "d365": -15.06 },
      "range_52w": { "low": 1160.2, "high": 1611.8 }
    },
    {
      "id": "index:NIFTY_50",
      "name": "Nifty 50",
      "price": 22231.8, "price_type": "index_level",
      "as_of": "2026-10-08",
      "returns_pct": { "d1": -1.64, "d30": -5.94, "d365": -11.24 },
      "valuation": { "pe": 19.02, "pb": 2.73, "div_yield": 1.24 }
    }
  ]
}
A real response from the server, shortened to fit. Values are as of the dates shown in the response.

What this MCP for the Indian stock market covers

One server, one search and one definition of returns across Indian stocks, ETFs, benchmark indices and GIFT City funds.

2,900+

Indian stocks and ETFs

Search by company name, ticker or ISIN. Get the latest close, the 52-week range, returns over five standard windows and up to ten years of price history, adjusted for splits and bonuses.

  • stock:RELIANCE
  • stock:TCS
  • stock:HDFCBANK
  • stock:INFY
  • stock:NIFTYBEES

35

Indices and benchmarks

Nifty 50, Nifty Next 50, Nifty 500, Midcap 150, Smallcap 250, Nifty Bank, IT, Pharma, Auto, FMCG, Metal and Realty, total return (TRI) versions, India VIX and BSE Sensex. Nifty indices come with P/E, P/B and dividend yield where available.

Also S&P 500, Nasdaq 100, Dow Jones, gold, silver, Brent crude, USD/INR and the US 10-year yield.

7

GIFT City funds

Daily NAV in US dollars, returns, expense ratio, fund size, manager, benchmark, minimum investment, top holdings and region and sector allocation for retail funds domiciled in GIFT IFSC.

  • DSP Global Equity Fund
  • Edelweiss Greater China Equity Fund
  • HDFC International Developed Markets Equity Fund
  • HDFC International Emerging Markets Equity Fund
  • Marcellus Global Equities Fund
  • Parag Parikh IFSC Nasdaq 100 Fund of Fund
  • Parag Parikh IFSC S&P 500 Fund of Fund

Funds and ETFs

Fund data today covers the seven GIFT City funds and Indian ETFs, including Nifty, gold, silver and sector ETFs. NAVs and returns use the same tools as stocks.

Indian mutual fund schemes by AMFI scheme code are not available yet. They are the next addition, with rolling returns, holdings and allocation.

Four stock market MCP tools for prices, indices and funds

Every result carries the full answer twice: as readable text and as typed JSON. Each value has its own date and currency.

search_instruments

Find an instrument ID by name, ticker, ISIN or fund house. Tolerates typos. Leave the query out to list every index or every GIFT City fund.

Inputs
query, types (stock, index, gift), limit

get_quotes

Latest end-of-day price or NAV for up to 10 instruments in one call, with percentage change over 1, 7, 30, 180 and 365 days and the 52-week range.

Inputs
instruments: IDs such as stock:RELIANCE, or exact tickers

get_price_history

Price or NAV series for one instrument: the last N days or a date range, as daily, weekly or monthly points. Open, high, low, close and volume for stocks and indices.

Inputs
instrument, days or from and to, interval, fields

get_fund_details

Facts about one GIFT City fund: overview, returns since the first NAV on record, top holdings, region allocation and sector allocation.

Inputs
fund, sections, holdings_limit (up to 25)

Connect the stock market MCP server to Claude, ChatGPT, Cursor or your own agent

The server is free to use and speaks Streamable HTTP at a single URL. There is no sign-up and no API key.

Claude

In Claude on the web or desktop, open Settings, then Connectors, and choose Add custom connector. Name it Foliyo Markets and paste the URL.

https://mcp.foliyo.ai/markets

Claude Code

Run one command in your terminal. The tools are available in your next session.

claude mcp add --transport http foliyo-markets https://mcp.foliyo.ai/markets

ChatGPT

Turn on developer mode under Settings, Apps and Connectors. Create a connector, paste the URL and set authentication to none.

https://mcp.foliyo.ai/markets

Cursor

Add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json inside a project.

{
  "mcpServers": {
    "foliyo-markets": { "url": "https://mcp.foliyo.ai/markets" }
  }
}

VS Code

Add the server to .vscode/mcp.json and use it from agent mode in Copilot Chat.

{
  "servers": {
    "foliyo-markets": { "type": "http", "url": "https://mcp.foliyo.ai/markets" }
  }
}

Your own agent

Any MCP client works, including the OpenAI Agents SDK, the Claude Agent SDK, LangChain and LlamaIndex. Point a Streamable HTTP transport at the URL and call tools/list.

POST https://mcp.foliyo.ai/markets
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Questions an AI assistant can answer with it

Ask in plain language. The assistant picks the tool, the server returns the numbers.

  • What is the latest closing price of Reliance Industries, and how far is it from its 52-week high?

    get_quotes
  • Compare the one-year returns of TCS, Infosys and the Nifty IT index.

    get_quotes
  • Show the Nifty 50 P/E, P/B and dividend yield today.

    get_quotes
  • Chart HDFC Bank's weekly closes for the last two years.

    get_price_history
  • Compare gold in rupees with the Nifty 50 over the last year.

    get_price_history
  • Which GIFT City funds can I look up, and who manages them?

    search_instruments
  • What does the Parag Parikh IFSC S&P 500 Fund of Fund hold, and what is its expense ratio?

    get_fund_details
  • Which is cheaper to own, the DSP Global Equity Fund or the HDFC International Developed Markets Equity Fund?

    get_fund_details
get_fund_details({ fund: "gift:parag-parikh-ifsc-sp-500-fund-of-fund", sections: ["overview", "returns", "holdings"] })
{
  "id": "gift:parag-parikh-ifsc-sp-500-fund-of-fund",
  "name": "Parag Parikh IFSC S&P 500 Fund of Fund",
  "currency": "USD",
  "overview": {
    "as_of": "2026-08-31",
    "fund_house": "PPFAS IFSC",
    "benchmark": "S&P 500 Net Total Returns Index",
    "expense_ratio_pct": 0.3,
    "aum_usd_mn": 24.31,
    "launch_date": "2026-03-20",
    "minimum_investment": "US$ 500 (additional US$ 500)"
  },
  "returns": {
    "as_of": "2026-10-08",
    "nav": 116.8198,
    "returns_pct": {
      "d1": -0.07, "d7": 1.65, "d30": 0.94,
      "d180": 12.04, "d365": null
    },
    "since_first_nav": { "from": "2026-03-23", "pct": 15.69 }
  },
  "holdings": {
    "as_of": "2026-08-31",
    "items": [
      { "name": "Invesco S&P 500 UCITS ETF Acc", "weight_pct": 96.86 },
      { "name": "Cash & Money Market Instruments", "weight_pct": 3.14 }
    ]
  }
}
A real response from the server, shortened to fit. A return window the fund has not lived through yet comes back as null, never as a guess.

How the market data behaves

End of day, not live
Prices and NAVs are closing values. Each one carries its own as_of date, so an assistant can say how fresh a number is.
One definition of returns
Percentage change over 1, 7, 30, 180 and 365 calendar days for every instrument, so a stock, an index and a fund can be compared directly.
Splits and bonuses handled
Stock returns and price history are adjusted for confirmed stock splits and bonus issues. A window that cannot be verified is returned as null.
Ten years of history
Daily points up to 90 days, weekly up to two years and monthly beyond that, or up to 260 daily rows on request.
Built for model context
Compact results with hard size caps, typed JSON beside readable text, and tool descriptions short enough to leave room for your conversation.
Free and open to every caller
No charge, no account and no key. Each caller can make 60 requests a minute.

The server provides market information for research and education. It does not place orders, hold portfolios or give investment advice. Stock returns are price returns and exclude dividends.

Looking for an NSE or BSE MCP server?

Foliyo Markets covers the Indian market in one hosted server: Indian stocks and ETFs, the Nifty indices and the BSE Sensex index, all end of day. There is nothing to install and no API key. If you need live intraday ticks, futures and options, or order placement, a broker's MCP server is the better fit.

Frequently asked questions

What is the Foliyo Markets MCP server?

It is a free Model Context Protocol (MCP) server for the Indian stock market. It gives AI assistants Indian market data: end-of-day prices, NAVs, returns, history and fund details for Indian stocks and ETFs, benchmark indices and GIFT City funds. The endpoint is https://mcp.foliyo.ai/markets.

Is there an MCP for the Indian stock market?

Yes. Foliyo Markets is a stock market MCP server that covers more than 2,900 Indian stocks and ETFs, plus the Nifty and Sensex indices, with closing prices, 52-week ranges, returns and up to ten years of history. It works with any MCP client.

Is this MCP for the Indian stock market free? Do I need an API key?

Yes, it is free, and no, you do not need a key. The server is open at a single URL with no sign-up, no API key and no charge. Each caller can make 60 requests a minute.

Is this an NSE and BSE MCP server?

Partly. If you are looking for an NSE BSE MCP, Foliyo Markets gives end-of-day prices for more than 2,900 Indian stocks and ETFs, the Nifty family of indices including Nifty 50, Nifty Bank and Nifty 500, and the BSE Sensex index. It does not provide BSE stock quotes as a separate exchange feed, and prices are not live. Use search_instruments with a company name, ticker or ISIN to check whether a specific stock is available.

What is the best free MCP for the Indian stock market?

It depends on what you need. Foliyo Markets is a free option with no API key that puts Indian stocks, ETFs, Nifty and Sensex indices, global benchmarks and GIFT City funds behind one server, with the same return windows for every instrument. If you need live intraday prices or order placement, you will need a different kind of service, because this one is end of day and read-only. It suits research, comparisons and portfolio questions that only need closing prices.

Which AI assistants and tools can use it?

Any client that supports remote MCP servers over Streamable HTTP. That includes Claude, Claude Code, ChatGPT in developer mode, Cursor, VS Code, and agents built with the OpenAI Agents SDK, the Claude Agent SDK, LangChain or LlamaIndex.

Is the data real time?

No. Prices and NAVs are end of day. Every value comes with its own as_of date and currency so the assistant can state how current it is.

Does it cover mutual funds and their NAVs?

Not Indian mutual fund schemes yet. Today it covers the seven GIFT City funds, with daily NAV, returns, holdings and allocation, and Indian ETFs. Indian mutual fund schemes identified by AMFI scheme code are the next addition.

Which GIFT City funds are available?

Seven today: DSP Global Equity Fund, Edelweiss Greater China Equity Fund, HDFC International Developed Markets Equity Fund, HDFC International Emerging Markets Equity Fund, Marcellus Global Equities Fund, Parag Parikh IFSC Nasdaq 100 Fund of Fund and Parag Parikh IFSC S&P 500 Fund of Fund.

Can it place trades or recommend what to buy?

No. It is read-only market information. It cannot place orders, move money or see anyone's portfolio, and it does not give investment advice.

What is the Model Context Protocol?

MCP is an open standard that lets an AI assistant call external tools and data sources in a consistent way. A server such as this one describes its tools, and any compatible assistant can use them without custom integration code.

Add the Indian stock market to your AI assistant

Paste one URL into your MCP client and start asking about stocks, indices and funds.