finviz

The Finviz MCP Server provides a comprehensive set of stock screening, fundamental analysis, and technical analysis tools powered by Finviz data. It includes earnings, volume surge, trend analysis, dividend growth, ETF screening, and premarket/afterhours earnings tracking. On top of screening, you can fetch fundamental data for individual or multiple stocks, compare sectors and industries, track news and sentiment, and perform basic to advanced technical analysis such as RSI, beta, moving averages (including the new get_moving_average_position), and relative volume checks. The server exposes a set of Python-based MCP tools that you can call to build complex investment screens or feed results into other workflows or Claude Desktop integrations.

Prerequisites:

• Python 3.11 or higher
• Finviz Elite Subscription (required for full functionality)
• Finviz API key (optional but recommended for higher rate limits)

Setup:

1. Clone and setup the project:

# Clone the repository
git clone <repository-url>
cd finviz-mcp-server

# Create virtual environment with Python 3.11
python3.11 -m venv venv

# Activate virtual environment
# macOS/Linux
source venv/bin/activate
# Windows
venv\Scripts\activate

# Install the package in development mode
pip install -e .

2. Configure environment variables:

# Copy the example environment file
cp .env.example .env

# Edit .env file and add your Finviz API key
FINVIZ_API_KEY=your_actual_api_key_here

3. Test the installation:

# Test if the server starts correctly (press Ctrl+C to stop)
finviz-mcp-server

# You should see the server starting in stdio mode

Running the server:

# Make sure virtual environment is activated
source venv/bin/activate

# Run the server
finviz-mcp-server

Tips and common considerations:

• The Finviz Elite subscription is required for full functionality; without it, some screening features may be limited.
• Add your API key to the environment (.env or Claude config) to maximize rate limits and access Elite data.
• When integrating with Claude Desktop, provide absolute paths to the executable and set cwd to your project root for reliable operation.
• The MCP_PORT and MCP_HOST environment variables control where the server listens; choose values appropriate for your environment (e.g., MCP_PORT=8000, MCP_HOST=0.0.0.0 for Docker).
• If you’re using Docker, remember to pass the FINVIZ_API_KEY and other relevant env vars into the container.
• The new get_moving_average_position feature returns the price position relative to 20-, 50-, and 200-day SMAs in a single call – great for quick trend situational awareness.