bahi-mcp

MCP server that gives AI assistants (Claude, Cursor, VS Code and others) access to Indian mutual fund data, NSE/BSE market data and financial calculators.

Bahi (बही) is the traditional Indian ledger. This server keeps the numbers straight so your assistant doesn't guess them.

Disclaimer: bahi-mcp provides information and calculations from public data sources (AMFI via the mftool library, and Yahoo Finance for stocks) and from assumptions you supply. It is not investment or tax advice and the author is not a SEBI-registered adviser. Data may be delayed or inaccurate, and tax rules change. Verify before making decisions.

What you can ask

• "Compare these three flexi-cap funds on 3-year return, volatility and max drawdown."
• "How often has this fund beaten 12% on rolling 3-year returns?"
• "If I had invested ₹10,000 a month in scheme 119551 since January 2020, what would it be worth today, and what is my XIRR?"
• "What's the Nifty at, and how has RELIANCE done over the last year?"
• "How much tax would I pay if I sell this equity fund after 14 months with a ₹2 lakh gain?"
• "How much corpus do I need to retire at 55 if I spend ₹60,000 a month today?"

Tools

Mutual fund data (AMFI)

Tool	What it does
search_schemes	Search schemes by name, returns AMFI scheme codes
get_scheme_quote	Latest NAV and quote for a scheme code
get_scheme_details	Fund house, type, category, start date
get_nav_history	NAV history with optional date range (capped to keep responses small)
get_portfolio_value	Current value of a list of holdings (scheme code + units)
clear_cache	Drop cached AMFI data so the next call fetches fresh NAVs

Mutual fund analytics

Tool	What it does
calculate_sip_returns	Monthly SIP simulation on a fund's real NAV history: invested, units, value, absolute return, XIRR
compare_funds	Side-by-side 1/3/5-year returns, volatility, max drawdown and Sharpe ratio for 1 to 5 funds
get_rolling_returns	Distribution of rolling returns: min, max, mean, median, how often positive or above a threshold

Stocks and market data (NSE/BSE, via Yahoo Finance; unofficial and best-effort)

Tool	What it does
get_stock_quote	Latest price, day and 52-week range for an NSE/BSE stock
get_index_quote	Nifty 50, Sensex, Bank Nifty, Nifty IT, India VIX
get_stock_history	OHLCV history for a stock or index

Calculators

Tool	What it does
calculate_xirr	XIRR for any dated cash flows
calculate_cagr	CAGR between two values over a date range
calculate_emi	Loan EMI, total payment, total interest
calculate_fd / calculate_rd	Fixed and recurring deposit maturity
calculate_lumpsum_value	Future value of a one-time investment
project_sip	SIP projection at an assumed return, with optional yearly step-up
calculate_swp	Does a corpus last under a monthly withdrawal?
plan_retirement	Corpus needed and the monthly SIP to build it
estimate_mf_tax	Capital gains tax estimate on a fund redemption; use purchase/sale dates for exact 12-month classification

Dates can be DD-MM-YYYY or YYYY-MM-DD.

Install

Requires Python 3.10+.

pip install bahi-mcp                # mutual funds + calculators
pip install "bahi-mcp[stocks]"      # adds NSE/BSE stock and index data

Or run without installing, using uv:

uvx bahi-mcp
uvx --with yfinance bahi-mcp        # with stock data

Configure your MCP client

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bahi-mcp": {
      "command": "uvx",
      "args": ["--with", "yfinance", "bahi-mcp"]
    }
  }
}

Drop "--with", "yfinance" if you don't need stock data. Restart

... View full README on GitHub