Skip to main content

MCP Server for publicly available Indian Mutual Funds data

Project description

🇮🇳 mftool-mcp

MCP Server for publicly available Indian Mutual Funds data
Powered by mftool · Works with Claude, Cursor, and any MCP-compatible LLM client

PyPI Python 3.10+ License: MIT MCP


What is this?

mftool-mcp is a Model Context Protocol (MCP) server that gives any LLM client access to live Indian Mutual Fund data from AMFI (Association of Mutual Funds in India).

Ask your AI assistant questions like:

  • "What is the current NAV of SBI Bluechip Direct Growth?"
  • "Show me 3-year returns for HDFC Midcap Opportunities Fund"
  • "List all schemes under Mirae Asset AMC"
  • "Find all flexi cap funds and compare their 5-year returns"

Tools Available

Tool Description
get_scheme_quote Live NAV for any scheme by code
get_scheme_details Fund house, type, category, start date
get_scheme_historical_nav Full NAV history (all dates)
get_scheme_historical_nav_for_dates NAV history within a date range
get_scheme_codes All AMFI scheme codes and names
get_available_schemes All schemes under a specific AMC
is_valid_scheme_code Validate a scheme code
search_scheme_by_name Find scheme codes by keyword
get_equity_scheme_performance Daily equity fund performance (1Y/3Y/5Y)
get_debt_scheme_performance Daily debt fund performance
get_hybrid_scheme_performance Daily hybrid fund performance
get_elss_scheme_performance ELSS / tax-saving fund performance

Quick Start

Using uvx (Recommended — no install needed)

uvx mftool-mcp

Using pip

pip install mftool-mcp
mftool-mcp

Claude Desktop Setup

Add this to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mftool-mcp": {
      "command": "uvx",
      "args": ["mftool-mcp"]
    }
  }
}

Restart Claude Desktop. You'll see mftool-mcp listed under connected tools.


Cursor / Other MCP Clients

In your MCP client settings, add:

{
  "mftool-mcp": {
    "command": "uvx",
    "args": ["mftool-mcp"]
  }
}

Example Conversations

Finding a fund:

You: "Find all SBI midcap mutual fund scheme codes"
Claude: calls search_scheme_by_name(query='midcap', amc_name='sbi')
Claude: "Here are the SBI midcap schemes: SBI Magnum Midcap Fund - Direct Growth (code: 125497)..."

Live NAV:

You: "What's the current NAV of scheme 125497?"
Claude: calls get_scheme_quote(scheme_code='125497')
Claude: "SBI Magnum Midcap Fund - Direct Growth: NAV ₹234.56 (as of 05-Apr-2025)"

Performance comparison:

You: "Compare 5-year returns for large cap equity funds"
Claude: calls get_equity_scheme_performance()
Claude: "Here's the 5-year return comparison for Large Cap funds: ..."


Data Source

All data is sourced via the mftool library. Data accuracy depends on AMFI's published figures. This tool is for informational purposes only and does not constitute financial advice.


Development

git clone https://github.com/NayakwadiS/mftool-mcp
cd mftool-mcp
pip install -e ".[dev]"

# Run the server locally
python -m mftool_mcp.server

Acknowledgements

  • mftool by NayakwadiS — the underlying data library

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mftool_mcp-0.2.0.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mftool_mcp-0.2.0-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file mftool_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: mftool_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for mftool_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 bed1fb0be4dde7250a77d135324c065b0435ca7fc4c7a5e3406c11ab19866e43
MD5 35c36907216448203ef956152c830e72
BLAKE2b-256 ba4f08aead8e85e0822a6b67f3b4fd92d4935038b25c5de70a658cc9d84a61f1

See more details on using hashes here.

File details

Details for the file mftool_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: mftool_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 8.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for mftool_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 32e897e05cf32f2908ede30c5fabe75dfe867b0564caabf25089b1624c93dc29
MD5 bfd821eef64221b5e4175970cacc5505
BLAKE2b-256 e17ffa560b763515792bb456b4ee20029c7de073d003501894def8e82bee90a1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page