screener.in

This MCP server integrates with screener.in to fetch financial data and compute the Market Capitalization to Profit (MCP) ratio for listed companies. In addition to the MCP calculation, the server exposes a set of analytical tools for technical analysis and trading strategy generation, including moving average (MA) analysis, RSI computation, and comprehensive trade recommendations. Users can query the API to obtain the MCP ratio for a given symbol and then leverage the built-in analysis tools to derive bullish/bearish signals, swing trading prompts, and intraday strategies based on MA, RSI, support/resistance levels, and volume trends. The system is designed to be run locally or in the cloud and requires authentication tokens from screener.in to access data through the middleware layer. Typical usage involves starting the server, supplying the required environment variables, and issuing requests to /mcp or utilizing the provided analysis endpoints to build trading ideas and risk-managed strategies.

Prerequisites:

• Python 3.8+
• MCP Inspector CLI tool
• Access to middleware token from screener.in
• Basic knowledge of financial metrics

Installation steps:

1. Clone the repository: git clone https://github.com/yourusername/mcp-server-screener.git cd mcp-server-screener

2. Create and activate a virtual environment: python -m venv venv source venv/bin/activate # macOS/Linux venv\Scripts\activate # Windows

3. Install dependencies: pip install -r requirements.txt

4. Configure environment variables for screener.in (create a .env or export variables): SCREENER_CSRF_TOKEN='your-token' SCREENER_SESSION_ID='your-session-id' SCREENER_CSRF_MIDDLEWARE_TOKEN='your-middleware-token'

5. Run the server (via MCP Inspector dev workflow): mcp dev server.py

6. Access the running server at the default port (e.g., http://localhost:6274).

Note: The exact command to start the server may vary depending on your setup. The readme indicates using the MCP Inspector CLI to run server.py, and the default port is 6274 unless configured otherwise.

Tips and notes:

• Ensure all required environment variables are set with valid tokens from screener.in; missing tokens will prevent data access.
• The server expects a Python runtime and a virtual environment; activate the venv before running.
• If the port 6274 is in use, configure the server or environment to use an alternate port via your run script or configuration.
• The MCP calculation logic lives in mcp_calculator.py and can be customized if you need additional metrics beyond MCP, MA, and RSI.
• When testing API endpoints, use /mcp?symbol=SYMBOL to fetch the MCP ratio; other tools (MA, RSI, trade recommendations, swing/intraday strategies) operate on the same symbol inputs or stock datasets.
• Check logs for authentication issues or token expiration; tokens from screener.in are typically short-lived and require renewal.
• If you encounter dependency issues, ensure your virtual environment is active and that requirements.txt is up to date.