Finviz
Provides comprehensive stock screening and fundamental analysis capabilities using Finviz data, including earnings tracking, volume surge detection, technical indicators, dividend growth screening, and SEC filing retrieval.
What is Finviz?
Finviz is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides comprehensive stock screening and fundamental analysis capabilities using finviz data, including earnings tracking, volume surge detection, technical indicators, dividend growth screening, an...
Provides comprehensive stock screening and fundamental analysis capabilities using Finviz data, including earnings tracking, volume surge detection, technical indicators, dividend growth screening, and SEC filing retrieval.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides comprehensive stock screening and fundamental analy
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx finviz-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Finviz
The Finviz MCP Server connects Claude to Finviz Elite's financial data platform, enabling comprehensive stock screening, fundamental analysis, and technical indicator queries directly from your AI assistant. It exposes tools for earnings tracking, volume surge detection, dividend growth screening, and SEC filing retrieval — all backed by real Finviz data. Traders and analysts can run screeners, compare sector performance, and pull insider trading filings without leaving their AI workflow.
Prerequisites
- Python 3.11 or higher installed
- A Finviz Elite subscription (required for full API access) and your FINVIZ_API_KEY
- EDGAR_USER_AGENT set in the format 'Your Name [email protected]' if you plan to use SEC filing tools
- An MCP-compatible client such as Claude Desktop
Clone the repository
Clone the finviz-mcp-server repository to your local machine and navigate into the project directory.
git clone https://github.com/tradermonty/finviz-mcp-server.git
cd finviz-mcp-serverCreate and activate a virtual environment
Create an isolated Python 3.11 virtual environment and activate it to avoid dependency conflicts.
python3.11 -m venv venv
source venv/bin/activateInstall the package
Install the server and all its dependencies in editable mode using pip.
pip install -e .Verify the installation
Run the server binary directly to confirm it starts without errors before wiring it into your MCP client.
finviz-mcp-serverConfigure your MCP client
Add the server to Claude Desktop's config file, passing your Finviz Elite API key and optional EDGAR user agent as environment variables.
{
"mcpServers": {
"finviz": {
"command": "/path/to/finviz-mcp-server/venv/bin/finviz-mcp-server",
"env": {
"FINVIZ_API_KEY": "your_finviz_elite_api_key",
"EDGAR_USER_AGENT": "Your Name [email protected]"
}
}
}
}Finviz Examples
Client configuration
Full Claude Desktop configuration block for the Finviz MCP server with required environment variables.
{
"mcpServers": {
"finviz": {
"command": "/path/to/finviz-mcp-server/venv/bin/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
Example prompts that exercise the server's screening, fundamental analysis, and SEC filing tools.
- "Screen for large-cap stocks reporting earnings after market close today with at least 1 million daily volume"
- "Get the PE ratio, EPS, and dividend yield for AAPL, MSFT, and GOOGL"
- "Find stocks with a volume surge in the last session that are in a confirmed uptrend"
- "Pull the most recent insider trading SEC filings for TSLA"
- "Compare sector performance for Technology vs Healthcare over the past month"Troubleshooting Finviz
Server starts but all screener calls return empty results or authentication errors
Verify your FINVIZ_API_KEY belongs to a Finviz Elite subscription. Free-tier API keys do not have access to the screener endpoints used by this server.
SEC filing tools return an error about a missing user agent
Set the EDGAR_USER_AGENT environment variable in your config to the format 'Your Name [email protected]'. The SEC's EDGAR system requires a valid contact identifier to accept requests.
The finviz-mcp-server command is not found after install
Make sure the virtual environment is activated before running the command. Run 'source venv/bin/activate' and then retry. In your MCP config, use the full absolute path to the binary inside the venv/bin directory.
Frequently Asked Questions about Finviz
What is Finviz?
Finviz is a Model Context Protocol (MCP) server that provides comprehensive stock screening and fundamental analysis capabilities using finviz data, including earnings tracking, volume surge detection, technical indicators, dividend growth screening, and sec filing retrieval. 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 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.