Finance Get API key

MCP server

Let an AI assistant read the Finance APIs for you. The server speaks the Model Context Protocol, so Claude, Cursor and other MCP clients can look up schemes, NAV history, returns, holdings and industry flows, and the newest market session, in a conversation.

Two sets of tools, one connection: mf_ tools for the Mutual Fund API and market_ tools for the Market Data API.

Endpoint https://fin.ejiapi.com/mcp (Streamable HTTP). It uses your own API key, the same one as the REST API, so it counts against your own quota. Request a key if you do not have one.

Connect

claude mcp add --transport http mf-api https://fin.ejiapi.com/mcp \
  --header "x-api-key: YOUR_KEY"
{
  "mcpServers": {
    "mf-api": {
      "url": "https://fin.ejiapi.com/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}
{
  "mcpServers": {
    "mf-api": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://fin.ejiapi.com/mcp",
               "--header", "x-api-key:${MF_API_KEY}"],
      "env": { "MF_API_KEY": "YOUR_KEY" }
    }
  }
}
Claude Desktop reaches remote servers through the mcp-remote helper, which needs Node.js. Keep your key out of shared config files and repositories.

Mutual fund tools

All tools are read-only. Start with mf_search_schemes to get a scheme code, then use it in the others.

ToolWhat it does
mf_search_schemesFind schemes by words of the name.
mf_get_schemeOne scheme by code or ISIN: latest NAV and 52-week high and low.
mf_list_schemesBrowse schemes a page at a time, optionally by category.
mf_list_amcsAll fund houses with their scheme counts.
mf_list_amc_schemesSchemes of one fund house, by id or name.
mf_get_variantsPlan and option variants of an exact scheme name.
mf_get_nav_historyDaily NAV over a date range. Long ranges are thinned to about max_points points.
mf_get_returns1, 3, 5 and 10 year annualised returns (CAGR).
mf_compare_schemesTwo to five schemes side by side.
mf_get_holdingsMonth-end portfolio disclosures: largest positions, sectors and weights.
mf_get_industry_flowsAMFI monthly report by fund category: folios, money raised and redeemed, net inflow and AUM, from March 2020.
mf_get_category_flow_historyOne category month by month, for example Flexi Cap or Liquid funds.
mf_get_statusHow fresh the data is and which fund houses have holdings.

Market data tools

Also read-only, end of day. Dates are YYYY-MM-DD. Start with market_get_coverage to see the newest session held.

ToolWhat it does
market_get_coverageWhat is stored, from and to which date, and when each loader last ran.
market_get_indicesNSE indices for a session with close, change, P/E, P/B and yield; filter by name.
market_get_index_historyOne index over time. Long ranges are thinned to about max_points.
market_get_moversStocks ranked by change, delivery %, turnover or volume.
market_get_equity_historyOne stock's daily prices, volume and delivery %.
market_get_flowsFII/FPI and DII cash-market buy, sell and net.
market_get_participant_oiOpen interest by Client, DII, FII and Pro.
market_get_dealsBulk and block deals.
market_get_futuresFutures per expiry: settlement, open interest, lot size.
market_get_options_summaryCall and put open interest and put/call ratio per underlying and expiry.
market_get_corporate_actionsDividends, splits, bonus, rights and buybacks by ex-date.
market_get_eventsBoard meetings and results dates.
market_get_iposIPOs with price band, subscription and listing date.
market_get_fxRupee value of 14 currencies (ECB reference rates).

Example questions

Keys and limits