finviz-market-mcp

MCP server exposing Finviz market data via the finvizfinance library.

Provides 23 tools for stock fundamentals, analyst ratings, screener, insider trading, sector analysis, forex, crypto, futures, and calendars.

Installation

Using uvx (recommended)

No installation needed. Run directly:

uvx finviz-market-mcp

Using pip

pip install finviz-market-mcp

From source

pip install -e .

Usage

Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "finviz": {
      "command": "uvx",
      "args": ["finviz-market-mcp"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "finviz": {
      "command": "uvx",
      "args": ["finviz-market-mcp"]
    }
  }
}

Tools Reference

Quote / Single Ticker (11 tools)

Tool	Description
`get_stock_fundamentals(ticker)`	70+ fundamental fields: P/E, EPS, Recom, Target Price, Market Cap, etc.
`get_stock_description(ticker)`	Company description text
`get_stock_ratings(ticker)`	Analyst ratings (upgrades, downgrades, initiations)
`get_stock_news(ticker, max_rows)`	Ticker-specific news articles
`get_stock_insider_trades(ticker, max_rows)`	Insider trading for a specific stock
`get_stock_snapshot(ticker)`	Composite: fundamentals + description + ratings + news + peers
`get_stock_peers(ticker)`	Peer ticker symbols
`get_stock_etf_holders(ticker)`	ETFs holding this stock
`get_stock_chart_url(ticker, timeframe, chart_type)`	Finviz chart URL
`get_financial_statements(ticker, statement, timeframe)`	Income/Balance/CashFlow statements
`get_current_price(ticker)`	Current stock price

Screener (3 tools)

Tool	Description
`screen_stocks(signal, filters, ticker, view, order, limit, ascend)`	Full screener with 33 signals + filters across 6 views
`screen_tickers(signal, filters, ticker, order, limit, ascend)`	Lightweight screener returning ticker symbols only
`get_screener_filters(filter_name)`	Discover available filters, signals, and sort orders

Market News (1 tool)

Tool	Description
`get_market_news(max_rows)`	General market news and blogs

Insider Trading (1 tool)

Tool	Description
`get_insider_trades(option, max_rows)`	Market-wide insider trading activity

Group / Sector Analysis (2 tools)

Tool	Description
`get_group_overview(group, view, order)`	Sector/Industry/Country group analysis
`get_group_filters()`	Discover available groups and sort orders

Macro / Multi-Asset (3 tools)

Tool	Description
`get_forex_performance(change)`	Forex pairs performance
`get_crypto_performance()`	Cryptocurrency performance
`get_futures_performance(timeframe)`	Futures performance

Calendars (2 tools)

Tool	Description
`get_earnings_calendar(period, mode)`	Earnings calendar by day
`get_economic_calendar()`	Economic releases calendar

Publishing to PyPI

uv build
uv publish

License

MIT

Metadata

Release files for finviz-market-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for finviz-market-mcp 0.1.1
File	Size	Uploaded
finviz_market_mcp-0.1.1.tar.gz	9.2 kB	Apr 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for finviz-market-mcp 0.1.1
File	Interpreter	ABI	Platform	Reset
finviz_market_mcp-0.1.1-py3-none-any.whl 9.1 kB Apr 12, 2026	Python 3	none	any	Details

Total release size: 18.3 kB

Release files / finviz_market_mcp-0.1.1.tar.gz

Download URL	finviz_market_mcp-0.1.1.tar.gz
Size	9.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`bb67cb15ead8e41473e518debd37baf7866dcb5aac3c082a53e8aaa47daa066f`
BLAKE2b-256 checksum How to use checksums	`e811534cdc44d8ef21a3f604a0c853c4be5054e7b13219882bb3ee40114b2020`
Upload date	Apr 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / finviz_market_mcp-0.1.1-py3-none-any.whl

Download URL	finviz_market_mcp-0.1.1-py3-none-any.whl
Size	9.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`97ce5a809a7abb086f0ffda42e1e4a75a4765ceb3ac2dea4912e46af619e4b2b`
BLAKE2b-256 checksum How to use checksums	`89bb6fcf2223ac9ab5b6d69dcd9715c235fe5d547bf16ca9fbb182e157e14ab3`
Upload date	Apr 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release history Release notifications | RSS feed

This release

0.1.1 This release

Apr 12, 2026 2 release files

0.1.0