Skip to main content
Glama
FinvizMCP

FinvizMCP

by Psichico

FinvizMCP

A Model Context Protocol (MCP) server that exposes Finviz stock screening, fundamentals, news, and market data as tools for MCP clients such as Claude Code and Claude Desktop.

Detached fork of tradermonty/finviz-mcp-server, maintained here for personal use.

Features

~40 tools across:

  • Screeners — uptrend, volume surge, trend reversion, dividend growth, ETF, technical analysis, earnings (pre-market / after-hours / upcoming), and a fully custom screener.

  • Fundamentals — single or batch stock fundamentals (70+ fields).

  • News — market, sector, and stock-specific news.

  • Market analysis — sector, industry, country, and capitalization performance; market overview; relative volume.

  • SEC / EDGAR — company filings, facts, concepts, and insider transactions.

Related MCP server: stockprice-mcp

Requirements

  • Python 3.11+

  • A Finviz Elite subscription + API key (required for full functionality)

Setup

git clone https://github.com/Psichico/FinvizMCP.git
cd FinvizMCP
python -m venv venv
venv\Scripts\activate        # Windows
# source venv/bin/activate   # macOS / Linux
pip install -e .

Create a .env file in the project root (it is gitignored — never commit your key):

FINVIZ_API_KEY=your_finviz_elite_api_key_here
LOG_LEVEL=INFO
RATE_LIMIT_REQUESTS_PER_MINUTE=100

Running

finviz-mcp-server        # stdio MCP server

The process starts and waits for an MCP client to connect over stdio (no output is expected on its own).

Connecting to Claude Code

Add an .mcp.json at your client's project root:

{
  "mcpServers": {
    "finviz": {
      "command": "C:\\path\\to\\FinvizMCP\\venv\\Scripts\\finviz-mcp-server.exe",
      "args": [],
      "cwd": "C:\\path\\to\\FinvizMCP",
      "env": {
        "LOG_LEVEL": "INFO",
        "RATE_LIMIT_REQUESTS_PER_MINUTE": "100"
      }
    }
  }
}

The FINVIZ_API_KEY is read from .env (via cwd), so it stays out of the committed config. Restart the client and approve the finviz server when prompted.

License

See LICENSE.

Credits

Built on tradermonty/finviz-mcp-server.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      MCP server providing comprehensive access to Finnhub financial market data API for AI assistants like Claude Desktop.
      15
      23 PyPI
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for stock prices, historical data, FX rates, and ticker search, powered by yfinance with no API key required. Designed for Claude Desktop.
      1
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server wrapping yfinance to provide stock market data, financials, and analytics via 24 tools.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that exposes real-time financial data tools for stock search, company info, historical prices, and financial metrics from Yahoo Finance, enabling AI agents to answer natural-language questions about stocks and financial markets.
      MIT