How harsha238/indiaquant-mcp-stock-ai-assistant works
IndiaQuant MCP serves stock-market analytics through FastAPI endpoints that return prices, signals, options analysis, sentiment, Greeks, and portfolio results. Its main workflow is an AI agent or API client requesting a tool, the server dispatching to a domain module, and that module obtaining market/news data or using portfolio storage before returning a result. The README documents additional capabilities such as sector heatmaps and market scanning. Sampled source supports the principal calls; unsampled internals are represented only where documented.
Main entry points: server.py FastAPI Tools · market_data.py Market Data · signals.py Trade Signals · portfolio.py Portfolio Manager
Components 15
API Layer
- FastAPI Tools
server.py
Market Analytics
- Market Data
modules/market_data.py - Sector Heatmap
modules/market_data.py - Trade Signals
modules/signals.py - Market Scanner
modules/signals.py - Technical Indicators
utils/indicators.py - Options Chain
modules/market_data.py - Unusual Activity
modules/options_analysis.py - Greeks Calculator
utils/black_scholes.py - News Sentiment
modules/sentiment.py
Portfolio
- Portfolio Manager
modules/portfolio.py - Portfolio Database
database/portfolio.db
External Data
- Yahoo Finance
- NewsAPI
Other components
- AI Agent / Client
Connections 21
- AI Agent / Client → FastAPI Tools: requests tools
README.md - FastAPI Tools → Market Data: gets prices
server.py - FastAPI Tools → Options Chain: gets chain
server.py - FastAPI Tools → Trade Signals: generates signal
server.py - FastAPI Tools → Market Scanner: scans market
server.py - FastAPI Tools → Sector Heatmap: gets heatmap
server.py - FastAPI Tools → Unusual Activity: detects activity
server.py - FastAPI Tools → Greeks Calculator: calculates Greeks
server.py - FastAPI Tools → News Sentiment: analyzes sentiment
server.py - FastAPI Tools → Portfolio Manager: manages portfolio
server.py - Market Data → Yahoo Finance: fetches market data
modules/market_data.py - Sector Heatmap → Market Data: reads price changes
modules/market_data.py - Options Chain → Yahoo Finance: fetches option chain
modules/market_data.py - Unusual Activity → Yahoo Finance: fetches option data
modules/options_analysis.py - Trade Signals → Market Data: loads history
modules/signals.py - Trade Signals → Technical Indicators: calculates indicators
modules/signals.py - Market Scanner → Market Data: loads history
modules/signals.py - Market Scanner → Technical Indicators: calculates RSI
modules/signals.py - Portfolio Manager → Market Data: gets live prices
modules/portfolio.py - Portfolio Manager → Portfolio Database: reads and writes
modules/portfolio.py - News Sentiment → NewsAPI: requests headlines
modules/sentiment.py