Stock Market

You run a Python-based MCP server that delivers real-time and historical stock data, financial analytics, and professional charts for Indian and global markets. It uses intelligent symbol resolution to accept company names or symbols, provides rapid quotes, rich financial insights, and high-quality charts suitable for reports and presentations.

How to use

You connect to the server with an MCP client to request quotes, historical data, charts, and financial analyses. Start by ensuring the server is running and your client is configured to authenticate with your token. Typical workflows include retrieving a live quote by name or symbol, generating a chart for a given period, or loading multiple quotes for portfolio analysis. You can also generate comparative charts and access in-depth company profiles and financial statements.

How to install

Prerequisites: Python 3.11 or higher and environment variables configured.

# Prerequisites are assumed to be installed
# 1) Prepare environment variables
cp .env.example .env
# 2) Install Python dependencies
pip install -r requirements.txt
# 3) Run the server
python stock_market_server.py

The server will be available at http://0.0.0.0:8087 once it starts.

# Quick Docker deployment
docker build -t stock-market-mcp .

# Run locally with environment variables
docker run -p 8087:8087 \
  -e AUTH_TOKEN=your_secure_auth_token_here \
  -e MY_NUMBER=your_validation_number_here \
  stock-market-mcp

If you prefer local development with Docker Compose, you can copy the environment example and start the services with build.

cp .env.example .env
# Edit .env with your values

# Start the service with Docker Compose
docker-compose up --build

Configuration and runtime details

Authentication uses a token-based bearer mechanism. You must provide AUTH_TOKEN in your environment or your MCP client header when making requests. The system also supports a phone-based validation number via MY_NUMBER for certain security workflows.

Environmental variables shown here are needed to run and test the server locally. Provide placeholder values if you are just validating the setup, and replace them with real credentials in production.

Supported deployment methods and MCP endpoints

HTTP endpoint (remote MCP server) is available at the local port once the server starts. You can point an MCP client to the address when running on your host or in a container.

Notes and tips

The server includes an HTTP endpoint and a local stdio interface for development. When running in production, prefer the HTTP endpoint for scalable access and security. Ensure you protect AUTH_TOKEN and keep your environment secure.

Available tools

get_stock_quote

Real-time stock quotes with intelligent symbol resolution

get_multiple_stock_quotes

Batch quotes for multiple stocks simultaneously

get_stock_info

Comprehensive company information and financial metrics

get_stock_history

Historical price data across multiple timeframes

search_stocks

Find stocks by company name with search suggestions

resolve_symbol

Convert company name to exact symbol

get_income_statement

Revenue and profit analysis

get_balance_sheet

Assets and liabilities analysis

get_cashflow_statement

Cash flow analysis

get_earnings_data

Earnings history data

get_earnings_dates

Upcoming earnings calendar and estimates

get_stock_dividends

Dividend history and yield analysis

get_stock_splits

Stock split history

get_stock_news

Latest company news and market updates

get_market_indices

Major market indices (Indian and global)

get_market_movers

Top gainers and losers from major indices

compare_stocks

Side-by-side financial comparison of multiple stocks

get_analyst_recommendations

Analyst ratings and guidance

get_analyst_price_targets

Consensus price targets and upside potential

create_stock_chart

Professional price charts with technical indicators

create_comparison_chart

Multi-stock performance comparison charts

create_candlestick_chart

OHLC candlestick charts for technical analysis

create_volume_analysis_chart

Volume analysis with VWAP and related metrics

screen_stocks

Filter stocks by criteria such as activity, movers, and market cap