Skip to main content

MCP Server for real-time Indian Mutual Funds data

Project description

🇮🇳 mftool-mcp

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

PyPI version 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 from AMFI India 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

License

MIT © 2025 Sujit Nayakwadi


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.1.0.tar.gz (6.7 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.1.0-py3-none-any.whl (8.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mftool_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b3b1f91272d06fcb1f8500d8dd49c5fe911fb46be2ad19b4042399c1bdb0b9ef
MD5 02fb92b327ee0de6c1dda4b3552d14e2
BLAKE2b-256 f80d3abfe73e885c2d57feb87277a157e59cb66d7889e5417e3194fdd653f711

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for mftool_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 92a834bc4ce2e5845d854d15e0d10b70e5290d7f819dab56b5b11b237063cf66
MD5 48487bd49f7e010d14206e1d1d875cc6
BLAKE2b-256 a24b3e0c17dc866dfedabede0181704dbb5ef5f36a265e37a840524527c0b0a1

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