{
  "markdown": "<!-- mcp-name: io.github.NayakwadiS/mftool-mcp -->\n# 🇮🇳 mftool-mcp\n\n> **MCP Server for publicly available Indian Mutual Funds data**  \n> Powered by [mftool](https://github.com/NayakwadiS/mftool) · Works with Claude, Cursor, and any MCP-compatible LLM client\n\n[![PyPI](https://img.shields.io/badge/pypi-v0.3.0-orange)](https://pypi.org/project/mftool-mcp/)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)\n\n---\n\n## What is this?\n\n`mftool-mcp` is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives any LLM client access to **Indian Mutual Fund data**.\n\nAsk your AI assistant questions like:\n- *\"What is the current NAV of SBI Bluechip Direct Growth?\"*\n- *\"Show me 3-year returns for HDFC Midcap Opportunities Fund\"*\n- *\"List all schemes under Mirae Asset AMC\"*\n- *\"Find all flexi cap funds and compare their 5-year returns\"*\n\n---\n\n## Tools Available\n\n| Tool | Description |\n|---|---|\n| `get_scheme_quote` | Live NAV for any scheme by AMFI scheme code |\n| `get_bulk_quotes` | Live NAV for multiple schemes at once (concurrent) |\n| `get_scheme_historical_nav` | Full NAV history for a scheme (all available dates) |\n| `get_scheme_historical_nav_for_dates` | NAV history filtered to a specific date range (DD-MM-YYYY) |\n| `get_scheme_history` | NAV history via BSE/YFinance code with period or date range |\n| `get_scheme_codes` | All AMFI scheme codes and names |\n| `get_available_schemes` | All schemes under a specific AMC |\n| `get_scheme_details` | Fund house, type, category, start date (AMFI code) |\n| `get_scheme_info` | Rich scheme info — AUM, returns, ratings (BSE/YFinance code) |\n| `is_valid_scheme_code` | Validate an AMFI numeric scheme code |\n| `is_valid_new_scheme_code` | Validate a BSE/new format scheme code |\n| `search_schemes` | Search schemes by name keyword with relevance ranking |\n| `search_schemes_by_amc` | Search schemes within a specific AMC |\n| `search_schemes_by_type` | Search schemes by type/category (equity, debt, elss, etc.) |\n| `get_average_aum` | Average AUM (domestic & overseas) for all AMCs by quarter |\n| `get_equity_scheme_performance` | Daily performance for all equity funds (1Y/3Y/5Y returns) |\n| `get_debt_scheme_performance` | Daily performance for all debt funds (1Y/3Y/5Y returns) |\n| `get_hybrid_scheme_performance` | Daily performance for all hybrid funds (1Y/3Y/5Y returns) |\n| `get_solution_scheme_performance` | Daily performance for solution-oriented funds (retirement, children) |\n| `get_other_scheme_performance` | Daily performance for index funds and Fund of Funds |\n| `calculate_returns` | Calculate SIP returns — absolute return % and annualised IRR |\n| `get_cache_stats` | View hit/miss stats for NAV and scheme code caches |\n| `clear_cache` | Clear all cached data to force fresh fetches |\n| `set_cache_enabled` | Enable or disable mftool caching globally |\n\n---\n\n## Quick Start\n\n### Using `uvx` (Recommended — no install needed)\n\n```bash\nuvx mftool-mcp\n```\n\n### Using `pip`\n\n```bash\npip install mftool-mcp\nmftool-mcp\n```\n\n---\n\n## Claude Desktop Setup\n\nAdd this to your `claude_desktop_config.json`:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"mftool-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mftool-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You'll see **mftool-mcp** listed under connected tools.\n\n---\n\n## Cursor / Other MCP Clients\n\nIn your MCP client settings, add:\n\n```json\n{\n  \"mftool-mcp\": {\n    \"command\": \"uvx\",\n    \"args\": [\"mftool-mcp\"]\n  }\n}\n```\n\n---\n\n## Example Conversations\n\n**Finding a fund:**\n> You: \"Find all SBI midcap mutual fund scheme codes\"  \n> Claude: *calls `search_schemes_by_amc(amc_name='sbi', query='midcap')`*  \n> Claude: \"Here are the SBI midcap schemes: SBI Magnum Midcap Fund - Direct Growth (code: 125497)...\"\n\n**Live NAV:**\n> You: \"What's the current NAV of scheme 125497?\"  \n> Claude: *calls `get_scheme_quote(scheme_code='125497')`*  \n> Claude: \"SBI Magnum Midcap Fund - Direct Growth: NAV ₹234.56 (as of 05-Apr-2025)\"\n\n**Performance comparison:**\n> You: \"Compare 5-year returns for large cap equity funds\"  \n> Claude: *calls `get_equity_scheme_performance()`*  \n> Claude: \"Here's the 5-year return comparison for Large Cap funds: ...\"\n\n---\n\n## Data Source\n\nAll data is sourced via the `mftool` library. Data accuracy depends on published figures. This tool is for **informational purposes only** and does not constitute financial advice.\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/NayakwadiS/mftool-mcp\ncd mftool-mcp\npip install -e \".[dev]\"\n\n# Run the server locally\npython -m mftool_mcp.server\n```\n\n<!-- ### Project Structure\n\n```\nmftool-mcp/\n├── src/\n│   └── mftool_mcp/\n│       ├── __init__.py\n│       ├── server.py          # MCP server entry point\n│       └── tools/\n│           ├── __init__.py\n│           ├── nav.py         # NAV & historical data tools\n│           ├── schemes.py     # Scheme discovery & search tools\n│           └── performance.py # Daily performance tools\n├── pyproject.toml\n├── LICENSE\n└── README.md\n```\n-->\n\n---\n\n## Acknowledgements\n\n- [mftool](https://github.com/NayakwadiS/mftool) — the underlying data library\n\n## Associated Initiatives\n\n- NSE Stock predictions *[NSE-Neuron](https://github.com/NayakwadiS/NSE-Neuron)*\n",
  "bytes": 5597,
  "sha": "67d5cdb8dbb14303d3ecdacd1f91b0f9310a74556498064b9252a09efb57caed",
  "repo_slug": "nayakwadis/mftool-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nayakwadis_mftool_mcp_da1635af/readme"
}