Skip to main content
Glama
Finviz + SEC EDGAR MCP Server

Finviz + SEC EDGAR MCP Server

by iabraham23

Finviz + SEC EDGAR MCP Server

A free MCP server for stock research using Finviz screening and SEC EDGAR filings. No paid subscriptions required.

Works with any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Zed, and more.

https://financial-research-finviz-sec-mcp.onrender.com/mcp

Collaboration Preference

This project is released under the MIT license. If you build on it, I would highly prefer and appreciate active collaboration.

This is a request about how I would like collaboration to happen, not an additional license restriction.

Related MCP server: OpenInsider MCP

What You Get

24 tools accessible conversationally through any MCP client:

Tool

What it does

screen_stocks

Full Finviz screener with 67+ filters: P/E, ROE, margins, debt ratios, etc.

screen_value_stocks

Quick value screen with sensible defaults

screen_from_url

Paste any finviz.com screener URL and run it

list_filter_options

Discover all available filter codes

get_stock_fundamentals

90+ data points for any ticker

compare_stocks

Side-by-side fundamental comparison

get_sec_filings

List recent SEC filings (10-K, 10-Q, 8-K, etc.)

get_filing_text

Read clean text of SEC filings (iXBRL properly stripped)

get_financial_history

Historical revenue, net income, EPS from XBRL data

get_per_share_fundamentals

Historical per-share valuation inputs from SEC XBRL filings

get_financial_snapshot

Full income statement, balance sheet & cash flow from latest filing

get_financial_ttm

Trailing twelve months for one or more companies

compare_financials

Compare a metric across multiple companies for a given year

get_insider_filings

SEC Form 3/4/5 insider filings with structured trade data

compare_sectors

Sector-level comparison

compare_industries

Industry aggregate comparison

stock_vs_industry

Compare one stock against its industry aggregates

screen_industry

Filter within a specific industry

get_analyst_ratings

Analyst price targets and ratings

get_insider_activity

Insider buy/sell activity

get_stock_news

Recent news headlines

get_earnings_news

Earnings-related and transcript-related headlines

get_annual_price_history

Annual high, low, and average close price history from Yahoo Finance

get_inputs_tab_data

Consolidated extraction package for CWC specific valuation workbook

Data Sources

  • Finviz (free tier): Screener, fundamentals, news, insiders, analyst data. Delayed 15–20 min (irrelevant for value research).

  • SEC EDGAR (free, public): 10-K/10-Q/8-K filings, XBRL financial data, insider forms. No API key needed.


Setup Guide (macOS / Linux / Windows)

Step 1: Prerequisites

You need Python 3.10+ and pip. Check with:

python3 --version   # Should be 3.10 or higher
pip3 --version

If you don't have Python 3.10+, install it from python.org.

Step 2: Fork, Clone & Install

Preferred workflow: fork this repository on GitHub first, then clone your fork so improvements can flow back cleanly.

git clone https://github.com/YOUR_USERNAME/finviz-sec-mcp.git
cd finviz-sec-mcp

# Create a virtual environment
python3 -m venv venv

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

# Install the package
pip install -e .

For the remote server entrypoint, the package also installs:

finviz-sec-mcp-remote

Step 3: Configure Environment

Copy the example env file and add your email (required by the SEC for EDGAR API access):

cp .env.example .env

Edit .env and set your contact email:

SEC_EMAIL=your-email@example.com

Step 4: Test It Works

# Quick test — should print the current tool count
python -c "
from finviz_sec_mcp.server import server
print(f'{len(server._tool_manager._tools)} tools registered')
"

# Full test — runs a live value screen
python -c "
from finviz_sec_mcp.clients.finviz_client import FinvizClient
results = FinvizClient.screen(
    filters=['cap_largeover', 'fa_pe_u20', 'fa_roe_o15'],
    table='Valuation',
)
print(f'Found {len(results)} value stocks')
for s in results[:3]:
    print(f'  {s[\"Ticker\"]} — P/E: {s.get(\"P/E\")}')
"

Step 5: Configure Claude Desktop

Open your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Add the following (replace /path/to/ with your actual path):

{
  "mcpServers": {
    "finviz-sec": {
      "command": "/path/to/finviz-sec-mcp/venv/bin/finviz-sec-mcp"
    }
  }
}

Finding your actual path:

# Run this in the project folder to get the exact paths
echo "\"command\": \"$(pwd)/venv/bin/finviz-sec-mcp\""

Step 6: Restart Claude Desktop

Quit and reopen Claude Desktop. You should see a hammer icon (🔨) in the chat input area. Click it to see all 24 tools.


Remote Server Deployment

This repo can also run as a public remote MCP over FastMCP streamable HTTP. That is the preferred setup for org-wide use because the production service can deploy from GitHub main and users no longer need .mcpb uploads.

Remote Environment

Set the remote variables from .env.example:

MCP_HOST=0.0.0.0
MCP_PORT=8000
MCP_STREAMABLE_HTTP_PATH=/mcp
SEC_EMAIL=your-email@example.com

Local Remote Run

finviz-sec-mcp-remote

This exposes:

  • /mcp

  • /healthz

Render Deployment

This repo includes a starter render.yaml that:

  • deploys the web service from GitHub

  • runs finviz-sec-mcp-remote

  • health-checks /healthz

To keep production tied to GitHub main, configure the Render production service to deploy only from the main branch. Unpushed local changes will not affect the live server.

This public remote deployment does not require OAuth or a backing database. Anyone with the deployed /mcp URL can connect, so put rate limiting or basic WAF rules in front of it if you expect outside traffic.


Screener Table Views

The screen_stocks tool accepts a table parameter that controls which columns are returned. Each view shows different metrics:

View

Columns Returned

Overview

Company, Sector, Industry, Market Cap, P/E, Price, Change, Volume

Valuation

Market Cap, P/E, Fwd P/E, PEG, P/S, P/B, P/C, P/FCF, EPS This Y, EPS Next Y, EPS Past 5Y, EPS Next 5Y, Sales Past 5Y, Price, Change, Volume

Financial

Market Cap, Dividend, ROA, ROE, ROI, Current Ratio, Quick Ratio, LTDebt/Eq, Debt/Eq, Gross Margin, Oper Margin, Profit Margin, Earnings, Price, Change, Volume

Ownership

Market Cap, Outstanding, Float, Insider Own, Insider Trans, Inst Own, Inst Trans, Float Short, Short Ratio, Avg Volume, Price, Change, Volume

Performance

Perf Week, Perf Month, Perf Quart, Perf Half, Perf Year, Perf YTD, Volatility W, Volatility M, Recom, Avg Volume, Rel Volume, Price, Change, Volume

Technical

Beta, ATR, SMA20, SMA50, SMA200, 52W High, 52W Low, RSI, Price, Change, Volume

Default is Valuation. You can run the same screen with different views to get a fuller picture of the results.


Example Prompts

Once set up, you can just talk naturally:

"Find me undervalued large-cap stocks with strong margins and low debt"

"Compare AAPL, MSFT, and GOOGL on valuation and profitability metrics"

"Show me the most recent 10-K filing for Berkshire Hathaway"

"What's the historical revenue trend for NVDA from SEC filings?"

"Screen for dividend stocks with yield over 3%, payout under 60%, and ROE over 15%"

"Show me all consumer defensive stocks with P/E under 20"

"What are the latest insider trades for AAPL?"

"Get analyst price targets for META"


Troubleshooting

"No module named 'finviz'" → Make sure you activated the venv and ran pip install -e .

No module named 'src' or stale value-investor-mcp paths → You renamed the project but are still using an old editable install or old Claude config. Recreate the venv, reinstall with pip install -e ., and point Claude Desktop at venv/bin/finviz-sec-mcp.

Screener returns empty → Some filter combinations are too restrictive. Try list_filter_options to check valid codes.

SEC EDGAR rate limit → The client auto-throttles to 10 req/sec. If you hit issues, wait a few seconds.

Claude Desktop doesn't show the tools → Double-check the path in claude_desktop_config.json. The command should point to venv/bin/finviz-sec-mcp inside this project, not your system Python.

License

MIT. See LICENSE.

Available Tools

24 tools
compare_financialsA

Compare a financial metric across multiple companies using SEC XBRL data. Returns actual reported values from SEC filings.

Companies with non-December fiscal year ends are automatically handled — no ticker is silently dropped.

Args: tickers: Comma-separated ticker symbols, e.g. "AAPL,MSFT,GOOGL". metric: XBRL concept name. Common metrics: "Revenues" — Total revenue "NetIncomeLoss" — Net income "GrossProfit" — Gross profit "OperatingIncomeLoss" — Operating income "EarningsPerShareBasic" — Basic EPS "EarningsPerShareDiluted" — Diluted EPS "Assets" — Total assets "Liabilities" — Total liabilities "StockholdersEquity" — Shareholder equity "CashAndCashEquivalentsAtCarryingValue" — Cash on hand "LongTermDebt" — Long-term debt "CommonStockSharesOutstanding" — Shares outstanding "ResearchAndDevelopmentExpense" — R&D expense "SellingGeneralAndAdministrativeExpense" — SG&A expense year: Calendar year to compare (e.g. 2024). Defaults to previous year if not specified. quarter: Optional quarter (1-4). 0 = full year (default).

Inputs: tickers (required), year, metric, quarter. Returns: result

compare_industriesA

Compare all industries with aggregate metrics from Finviz. Returns industry-level aggregates for all ~144 industries. Data source: Finviz groups page (current snapshot). To screen stocks within a specific industry, use screen_industry.

Args: view: Data view — "overview", "valuation", or "performance". See compare_sectors for column details per view. order: Sort column — e.g. "name", "marketcap", "pe", "change", "volume", "dividendyield".

Inputs: view, order. Returns: result

compare_sectorsA

Compare all market sectors with aggregate metrics from Finviz. Returns sector-level aggregates (median P/E, total market cap, etc.) for all 11 sectors in a single view. Data source: Finviz groups page (current snapshot).

Args: view: Data view to return. Options: "overview" — Stocks, Market Cap, Dividend, P/E, Fwd P/E, PEG, LTDebt/Eq, Debt/Eq, Float Short, Recom, Change, Volume "valuation" — Market Cap, P/E, Fwd P/E, PEG, P/S, P/B, P/C, P/FCF, EPS past 5Y, EPS next 5Y, Sales past 5Y, Change, Volume "performance" — Perf Week, Perf Month, Perf Quart, Perf Half, Perf Year, Perf YTD, Avg Volume, Rel Volume, Change, Volume order: Sort column — e.g. "name", "marketcap", "pe", "change", "volume", "dividendyield".

Inputs: view, order. Returns: result

compare_stocksA

Compare fundamental metrics across multiple stocks side-by-side. Uses Finviz current snapshot data (~15-20 min delayed). All values are point-in-time — for historical comparisons across years use compare_financials (SEC XBRL actuals) instead.

Args: tickers: Comma-separated tickers, e.g. "AAPL,MSFT,GOOGL" metrics: Optional comma-separated metric names to compare. If empty, uses default value-investing metrics: P/E, Forward P/E, P/B, P/FCF, PEG, ROE, ROA, Profit Margin, Oper. Margin, Debt/Eq, Current Ratio, Dividend %, EPS (ttm), EPS next Y, EPS past 5Y, Market Cap, Price

Inputs: tickers (required), metrics. Returns: result

get_analyst_ratingsB

Get analyst price targets and ratings for a stock from Finviz. Shows date, analyst firm, rating action, and price target (from/to). Useful for gauging sell-side sentiment and consensus target price.

Args: ticker: Stock ticker symbol. count: Number of recent ratings to return (default 10).

Inputs: ticker (required), count. Returns: result

get_annual_price_historyA

Get annual high, low, and average close prices for a stock. Returns one row per calendar year with the highest intraday price, lowest intraday price, and mean daily closing price.

Data source: Yahoo Finance (free, no API key). Prices are split-adjusted.

Args: ticker: Stock ticker symbol (e.g. "AAPL", "MSFT"). years: Number of years of history to fetch (default 11).

Inputs: ticker (required), years. Returns: result

get_earnings_newsA

Get earnings-related headlines for a stock from Finviz. Filters the full news feed to only headlines containing keywords: earnings, results, guidance, conference call, webcast, transcript. Use this for post-earnings analysis or when building an earnings update. For all news (not just earnings), use get_stock_news.

Args: ticker: Stock ticker symbol. count: Number of matching headlines to return (default 10).

Inputs: ticker (required), count. Returns: result

get_filing_textA

Fetch specific narrative sections from the most recent SEC filing. For 10-K and 10-Q filings, uses edgartools' structured TenK/TenQ objects to pull named items directly — no iXBRL overhead, no wasted character budget on table-of-contents boilerplate. For 20-F filings, uses edgartools markdown extraction from the primary filing HTML and slices by 20-F item headings. For other form types (8-K, etc.), falls back to full-text extraction.

Args: ticker: Stock ticker symbol. form_type: Form to fetch — "10-K", "10-Q", "8-K", etc. sections: Comma-separated list of items to retrieve. Default "Item 7,Item 1A" returns MD&A + Risk Factors for 10-K / 10-Q. For 20-F, useful sections include: "Item 3.D", "Item 4", "Item 5", "Item 18", plus aliases like "risk_factors", "business", "mda", "financial_statements". Supported formats: Full: "Item 1", "Item 1A", "Item 7", "Item 7A", "Item 8" Short: "1", "1A", "7", "7A" Aliases: "mda", "risk_factors", "business" Pass sections="" to get Item 7 + Item 1A (same as default). Use get_sec_filings first to confirm available items. max_chars_per_section: Max characters per section (default 8000). Each section is truncated independently.

Inputs: ticker (required), sections, form_type, max_chars_per_section. Returns: result

get_financial_historyA

Get historical financial data from SEC XBRL filings. Returns actual reported values — not estimates or scraped data.

Args: ticker: Stock ticker symbol. metric: XBRL concept name. Common value-investing metrics: "Revenues" — Total revenue "NetIncomeLoss" — Net income "GrossProfit" — Gross profit "OperatingIncomeLoss" — Operating income "EarningsPerShareBasic" — Basic EPS (use unit "USD/shares") "EarningsPerShareDiluted" — Diluted EPS (use unit "USD/shares") "Assets" — Total assets "Liabilities" — Total liabilities "StockholdersEquity" — Shareholder equity "CashAndCashEquivalentsAtCarryingValue" — Cash on hand "LongTermDebt" — Long-term debt "CommonStockSharesOutstanding" — Shares outstanding (unit "shares") "ResearchAndDevelopmentExpense" — R&D expense "SellingGeneralAndAdministrativeExpense" — SG&A expense "InterestExpense" — Interest expense "IncomeTaxExpenseBenefit" — Income tax expense "DepreciationDepletionAndAmortization" — D&A "CapitalExpenditure" — Capital expenditures "NetCashProvidedByUsedInOperatingActivities" — Operating cash flow "Goodwill" — Goodwill (balance sheet) "IntangibleAssetsNetExcludingGoodwill" — Intangible assets net of goodwill "WeightedAverageNumberOfDilutedSharesOutstanding" — Diluted shares (unit "shares") periods: Number of recent periods to show (default 8). period_type: Controls which filings are included: "annual" — Annual filings (10-K / 20-F / 40-F). Clean year-over-year series. RECOMMENDED for financial modeling. "quarterly" — 10-Q only. Clean quarter-over-quarter series, useful for recent trend analysis. "interim" — Interim filings (10-Q / 6-K). Includes foreign private issuer interim XBRL when present. May include both ~3-month and ~6-month periods. "all" — Annual + interim filings mixed (not recommended for modeling).

Inputs: ticker (required), metric, periods, period_type. Returns: result

get_financial_snapshotA

Get a complete financial snapshot from the latest SEC filing: income statement, balance sheet, and cash flow statement with multi-period comparison. Also includes quick-access metrics (revenue, net income, FCF, etc.).

This is the best starting point for company financial analysis. Returns actual XBRL-tagged data from SEC filings — not estimates. Powered by edgartools' Financials API.

Args: ticker: Stock ticker symbol.

Inputs: ticker (required). Returns: result

get_financial_ttmA

Get Trailing Twelve Months (TTM) value for one or more companies. Sums the four most recent quarterly filings for income statement / cash flow metrics, or returns the latest quarter for balance sheet items. Useful for up-to-date analysis without waiting for the next annual filing.

Args: tickers: Comma-separated ticker symbols, e.g. "AAPL,MSFT,GOOGL". metric: XBRL concept name. Income statement / cash flow metrics (summed over 4 quarters): "Revenues" — Total revenue "NetIncomeLoss" — Net income "GrossProfit" — Gross profit "OperatingIncomeLoss" — Operating income "ResearchAndDevelopmentExpense" — R&D expense "SellingGeneralAndAdministrativeExpense" — SG&A "InterestExpense" — Interest expense "IncomeTaxExpenseBenefit" — Income tax "DepreciationDepletionAndAmortization" — D&A "CapitalExpenditure" — CapEx "NetCashProvidedByUsedInOperatingActivities" — Operating FCF Balance sheet metrics (latest quarter, no summing): "Assets", "Liabilities", "StockholdersEquity", "CashAndCashEquivalentsAtCarryingValue", "LongTermDebt"

Inputs: tickers (required), metric. Returns: result

get_inputs_tab_dataA

Get a structured extraction package for the valuation workbook INPUTS tab.

This tool consolidates the key MCP data needed for the workbook into one response, covering:

  • current company snapshot fields

  • current EPS / forward EPS / PEG / forward PE

  • historical annual price data

  • historical per-share fundamentals

  • true TTM diluted EPS

Conventions:

  • Current EPS uses Finviz EPS (ttm)

  • Forward EPS uses Finviz EPS next Y

  • PEG basis defaults to industry

  • LTM EPS Diluted uses SEC TTM diluted EPS

  • JSON payload is omitted by default for readability; pass include_json=True to append the raw structured payload

Args: ticker: Stock ticker symbol. price_years: Number of years for annual price history. fundamentals_years: Number of annual periods for per-share fundamentals. peg_basis: Currently supports "industry" only.

Inputs: ticker (required), peg_basis, price_years, include_json, +1 more. Returns: result

get_insider_activityA

Get recent insider trading activity (buys/sells) from Finviz. Shows insider name, relationship to company, transaction type, date, share count, and dollar value. Useful for gauging management conviction. For SEC Form 3/4/5 filings with EDGAR links, use get_insider_filings.

Args: ticker: Stock ticker symbol.

Inputs: ticker (required). Returns: result

get_insider_filingsA

Get insider trading SEC filings (Form 3, 4, 5) with structured data. Returns filing dates, insider names, positions, trade details, and direct EDGAR links. Powered by edgartools' Form4 parser.

For a human-readable summary of recent buys/sells with dollar values, use get_insider_activity (Finviz) instead.

Args: ticker: Stock ticker symbol. max_results: Number of filings to return.

Inputs: ticker (required), max_results. Returns: result

get_per_share_fundamentalsA

Get historical per-share fundamentals from SEC XBRL filings. Returns annual series of key valuation inputs computed from actual reported values — replaces paid data services like SimFin.

Metrics returned per year:

  • Diluted Shares Outstanding (weighted average, millions)

  • Book Value per Share (Equity / Diluted Shares)

  • Tangible Book Value per Share ((Equity - Goodwill - Intangibles) / Shares)

  • Revenue per Share

  • Operating Cash Flow per Share

  • Diluted EPS (Net Income / Diluted Shares, split-adjusted)

  • Total Revenue (millions)

  • Operating Cash Flow (millions)

Args: ticker: Stock ticker symbol. periods: Number of annual periods (default 10, max ~10 years of data).

Inputs: ticker (required), periods. Returns: result

get_sec_filingsA

List recent SEC filings for a company with EDGAR links. Use this to find filing dates and document URLs before calling get_filing_text. Data source: SEC EDGAR via edgartools.

Args: ticker: Stock ticker symbol. form_type: Filter by form type. Common options: "10-K" — Annual report (full financials, risk factors, MD&A) "10-Q" — Quarterly report "8-K" — Current report (material events) "DEF 14A" — Proxy statement (executive comp, governance) "4" — Insider trading (Form 4) "S-1" — IPO registration "" — All forms (default) max_results: Number of filings to return (default 15).

Inputs: ticker (required), form_type, max_results. Returns: result

get_stock_fundamentalsA

Get comprehensive fundamental data for a stock from Finviz. Returns a current snapshot (~15-20 min delayed) covering valuation ratios, profitability metrics, balance sheet highlights, ownership, and technical indicators across 90+ fields.

Data source: Finviz (current snapshot). For historical time-series data use get_financial_history or get_financial_ttm.

Args: ticker: Stock ticker symbol (e.g. "AAPL", "BRK-B").

Inputs: ticker (required). Returns: result

get_stock_newsA

Get recent news headlines for a stock from Finviz. Returns headlines with source, timestamp, and URL. For earnings-specific headlines only, use get_earnings_news.

Args: ticker: Stock ticker symbol. count: Number of headlines to return (default 10).

Inputs: ticker (required), count. Returns: result

list_filter_optionsA

List all available Finviz screener filter categories and their codes. Call this whenever you need to look up a valid filter code before calling screen_stocks or screen_industry. Returns ~67 categories with valid code values (e.g. cap_largeover, fa_pe_u20, sec_technology).

Inputs: no named parameters. Returns: result

screen_from_urlA

Run a Finviz screener from a URL copied directly from finviz.com. Useful when the user has built a custom screen in the Finviz UI and wants to replicate it here without translating filter codes manually.

Args: url: Full Finviz screener URL, e.g. "https://finviz.com/screener.ashx?v=111&f=cap_largeover,fa_pe_u20"

Inputs: url (required). Returns: result

screen_industryA

Screen stocks within a specific industry using Finviz. Convenience wrapper around screen_stocks that pre-applies the ind_ filter. Useful for peer group analysis or sector deep-dives. Use list_filter_options to look up valid industry codes.

Args: industry: Finviz industry code, e.g.: "banksregional", "biotechnology", "semiconductors", "softwareinfrastructure", "oilgasep", "drugmanufacturers", "insurancelife", "medicaldevices", "reitsdiversified", "aerospacedefense", "automanufacturers"

    Use list_filter_options to see all available industries.
table: Metric view — "Valuation", "Financial", etc.
additional_filters: Extra Finviz filter codes (comma-separated).
max_results: Max stocks to return.

Inputs: industry (required), table, max_results, additional_filters. Returns: result

screen_stocksA

Screen stocks using Finviz filter codes. Primary tool for finding investment candidates. Uses Finviz current snapshot data (~15-20 min delayed). Returns a filtered list with the metric columns selected by the 'table' parameter. Use list_filter_options to discover all valid filter codes.

Args: filters: Comma-separated Finviz filter codes. VALUE INVESTING EXAMPLES: "cap_largeover,fa_pe_u20,fa_roe_o15" → Large cap, P/E < 20, ROE > 15% "fa_pb_u2,fa_curratio_o1.5,fa_debteq_u0.5" → P/B < 2, current ratio > 1.5, debt/equity < 0.5 "fa_div_o3,fa_payoutratio_u60,fa_roe_o15" → Dividend > 3%, payout < 60%, ROE > 15% "fa_pfcf_u15,fa_opermargin_o15,fa_epsyoy1_o10" → P/FCF < 15, op margin > 15%, EPS growth > 10%

    USE TOOL: list_filter_options TO SEE ALL FILTERS 
    
    COMMON FILTER PREFIXES:
      cap_     : Market cap (nano/micro/small/mid/large/mega)
      fa_pe    : P/E ratio (u = under, o = over)
      fa_fpe   : Forward P/E
      fa_peg   : PEG ratio
      fa_ps    : Price/Sales
      fa_pb    : Price/Book
      fa_pc    : Price/Cash
      fa_pfcf  : Price/Free Cash Flow
      fa_roe   : Return on equity
      fa_roa   : Return on assets
      fa_roi   : Return on investment
      fa_curratio  : Current ratio
      fa_quickratio: Quick ratio
      fa_debteq    : Debt/Equity
      fa_ltdebteq  : Long-term Debt/Equity
      fa_grossmargin : Gross margin
      fa_opermargin  : Operating margin
      fa_netmargin   : Net profit margin
      fa_div   : Dividend yield
      fa_epsyoy5     : EPS growth past 5 years
      fa_salesqoq    : Sales growth QoQ
      sec_     : Sector (technology, healthcare, etc.)
      ind_     : Industry
      sh_avgvol: Average volume
      ta_sma200: Price vs 200-day SMA

table: Data view that controls which columns are returned.
       Each view returns different metrics per stock:

       "Overview" — Company, Sector, Industry, Market Cap, P/E,
           Price, Change, Volume
       "Valuation" — Market Cap, P/E, Fwd P/E, PEG, P/S, P/B,
           P/C, P/FCF, EPS This Y, EPS Next Y, EPS Past 5Y,
           EPS Next 5Y, Sales Past 5Y, Price, Change, Volume
       "Financial" — Market Cap, Dividend, ROA, ROE, ROI,
           Curr R (Current Ratio), Quick R, LTDebt/Eq, Debt/Eq,
           Gross M, Oper M, Profit M, Earnings, Price, Change, Volume
       "Ownership" — Market Cap, Outstanding, Float, Insider Own,
           Insider Trans, Inst Own, Inst Trans, Float Short,
           Short Ratio, Avg Volume, Price, Change, Volume
       "Performance" — Perf Week, Perf Month, Perf Quart,
           Perf Half, Perf Year, Perf YTD, Volatility W,
           Volatility M, Recom, Avg Volume, Rel Volume,
           Price, Change, Volume
       "Technical" — Beta, ATR, SMA20, SMA50, SMA200,
           52W High, 52W Low, RSI, Price, Change, Volume

       Use "Valuation" for value metrics, "Financial" for margins/ROE.
order: Sort column. Prefix with '-' for descending.
       e.g. "-marketcap", "pe", "-dividendyield"
signal: Optional Finviz signal preset, e.g. "ta_topgainers".
max_results: Max stocks to return (default 30).

Returns: Formatted screening results with key metrics.

Inputs: filters (required), order, table, signal, +1 more. Returns: result

screen_value_stocksA

Quick value stock screener with sensible defaults. Convenience wrapper around screen_stocks — use that tool for full control over filters. Useful for fast idea generation.

Args: min_market_cap: Minimum market cap — "small", "mid", "large", "mega". Maps to: small=cap_smallover, mid=cap_midover, large=cap_largeover, mega=cap_mega max_pe: Max P/E — e.g. "u20" for under 20, "u15" for under 15. min_roe: Min ROE — e.g. "o10" for over 10%, "o15" for over 15%. max_debt_equity: Max debt/equity — e.g. "u1" for under 1, "u0.5". additional_filters: Extra raw filter codes (comma-separated). e.g. "fa_div_o2,sec_consumerdefensive"

Inputs: max_pe, min_roe, min_market_cap, max_debt_equity, +1 more. Returns: result

stock_vs_industryA

Get a stock's valuation and fundamentals relative to its industry. Compares the stock's metrics against industry aggregates across overview (P/E, PEG, Debt, Dividend), valuation (P/S, P/B, P/FCF, EPS growth), and performance (weekly through YTD returns). Shows absolute stock value, industry median, and delta for each metric. Data source: Finviz (current snapshot for both stock and industry).

Args: ticker: Stock ticker symbol (e.g. "AAPL", "BRK-B").

Inputs: ticker (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 24 tools

    Disambiguation4/5

    Tools are mostly distinct, with detailed cross-references preventing misselection. However, several clusters (screen_stocks vs screen_value_stocks vs screen_from_url vs screen_industry, and get_financial_history vs get_financial_ttm vs get_financial_snapshot vs get_stock_fundamentals) require careful reading to distinguish, so one or two pairs could be confused.

    Naming Consistency4/5

    The set follows a mostly consistent snake_case verb_noun pattern (screen_*, get_*, compare_*). Minor deviations like stock_vs_industry (noun_vs_noun) and screen_from_url (verb_preposition) break the pattern slightly, but overall the naming is predictable and readable.

    Tool Count4/5

    24 tools is on the heavier side but reasonable for a combined Finviz + SEC EDGAR server covering screening, fundamentals, filings, comparisons, insider data, news, and price history. Many tools are purposeful wrappers rather than redundant additions, though a few (screen_value_stocks, screen_from_url) could be considered optional conveniences.

    Completeness5/5

    The tool surface is remarkably complete for value-investing workflows: screening, industry/sector comparisons, SEC filing lookup and section extraction, historical/trailing financials, per-share metrics, insider activity, analyst ratings, news, and price history are all covered. There are no obvious dead ends; even niche needs like TTM calculation and workbook input assembly have dedicated tools.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.
      17
      51
      Python
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that exposes 16 free investment-research signals (insider trades, SEC filings, short data, and live quotes) to any MCP-compatible LLM.
      83 npm
      105
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.
      10
      75
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Comprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.
      26
      9 npm
      MIT