Finviz
MCP server providing stock screening, fundamental analysis, news, and SEC filing tools powered by Finviz.
What is Finviz?
Finviz is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server providing stock screening, fundamental analysis, news, and sec filing tools powered by finviz.
MCP server providing stock screening, fundamental analysis, news, and SEC filing tools powered by Finviz.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server providing stock screening, fundamental analysis,
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx finvizConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Finviz
The Finviz MCP server provides AI assistants with professional-grade stock market data tools powered by Finviz Elite, including stock screeners, fundamental and technical analysis, real-time news, and SEC filing retrieval. It exposes over a dozen specialized tools for earnings screening, volume surge detection, dividend analysis, insider transaction tracking, and more — giving traders and analysts the ability to run complex market queries through natural language. A Finviz Elite subscription is required for full API access.
Prerequisites
- Python 3.11 or higher installed
- A Finviz Elite subscription with a valid FINVIZ_API_KEY
- EDGAR_USER_AGENT string (your name and email) if using SEC filing tools
- An MCP-compatible client such as Claude Desktop or Cursor
Clone the repository and create a virtual environment
Clone the Finviz MCP server repository and set up an isolated Python 3.11 virtual environment.
git clone https://github.com/tradermonty/finviz-mcp-server.git
cd finviz-mcp-server
python3.11 -m venv venv
source venv/bin/activate # macOS/Linux
# On Windows: venv\Scripts\activateInstall dependencies
Install the package and all required dependencies in editable mode.
pip install -e .Configure environment variables
Copy the example env file and fill in your Finviz Elite API key and optional EDGAR user agent string.
cp .env.example .env
# Edit .env and set:
# FINVIZ_API_KEY=your_finviz_elite_api_key
# EDGAR_USER_AGENT=Your Name [email protected]Configure Claude Desktop
Add the Finviz MCP server to your Claude Desktop configuration, pointing to the Python executable in your virtual environment.
{
"mcpServers": {
"finviz": {
"command": "/path/to/finviz-mcp-server/venv/bin/python",
"args": ["-m", "finviz_mcp_server"],
"env": {
"FINVIZ_API_KEY": "your_finviz_elite_api_key",
"EDGAR_USER_AGENT": "Your Name [email protected]"
}
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop. Ask Claude to screen for stocks to confirm the Finviz tools are available and the API key is working.
Finviz Examples
Client configuration
Claude Desktop config using the virtual environment Python to run the Finviz MCP server with API credentials.
{
"mcpServers": {
"finviz": {
"command": "/path/to/finviz-mcp-server/venv/bin/python",
"args": ["-m", "finviz_mcp_server"],
"env": {
"FINVIZ_API_KEY": "YOUR_FINVIZ_ELITE_API_KEY",
"EDGAR_USER_AGENT": "Your Name [email protected]",
"LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Market analysis queries you can run through Claude once the Finviz server is connected.
- "Screen for large-cap stocks reporting earnings today after market close"
- "Find stocks with a volume surge of at least 150% today and price increase above 2%"
- "Get the fundamentals for AAPL including P/E ratio, EPS, and 52-week range"
- "Show me dividend stocks with yield above 3% and ROE above 15%"
- "Retrieve the latest SEC insider filings for TSLA"
- "Which S&P 500 stocks are currently in a strong uptrend with high relative volume?"Troubleshooting Finviz
API key errors or rate limit exceeded responses
Ensure FINVIZ_API_KEY is set to a valid Finviz Elite key. Free Finviz accounts do not have API access. You can also set RATE_LIMIT_REQUESTS_PER_MINUTE in your .env to a lower value (e.g., 30) to avoid hitting Finviz rate limits during heavy usage.
EDGAR tools fail with 403 or user-agent errors
The SEC EDGAR API requires a descriptive User-Agent string. Set EDGAR_USER_AGENT to a string in the format 'Your Name [email protected]' as required by SEC fair-access policy. Empty or generic user agent strings will be rejected.
Python version mismatch causing import errors
This server requires Python 3.11 specifically. Run 'python --version' to verify. If your system Python is older, install Python 3.11 via pyenv or from python.org and recreate the virtual environment with the correct version: 'python3.11 -m venv venv'.
Frequently Asked Questions about Finviz
What is Finviz?
Finviz is a Model Context Protocol (MCP) server that mcp server providing stock screening, fundamental analysis, news, and sec filing tools powered by finviz. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Finviz?
Follow the installation instructions on the Finviz GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Finviz?
Finviz works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Finviz free to use?
Yes, Finviz is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Finviz Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Finviz? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Finviz in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Finviz?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.