Finviz + SEC EDGAR MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Finviz + SEC EDGAR MCP Server screen for value stocks with P/E under 15"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Full Finviz screener with 67+ filters: P/E, ROE, margins, debt ratios, etc. |
| Quick value screen with sensible defaults |
| Paste any finviz.com screener URL and run it |
| Discover all available filter codes |
| 90+ data points for any ticker |
| Side-by-side fundamental comparison |
| List recent SEC filings (10-K, 10-Q, 8-K, etc.) |
| Read clean text of SEC filings (iXBRL properly stripped) |
| Historical revenue, net income, EPS from XBRL data |
| Historical per-share valuation inputs from SEC XBRL filings |
| Full income statement, balance sheet & cash flow from latest filing |
| Trailing twelve months for one or more companies |
| Compare a metric across multiple companies for a given year |
| SEC Form 3/4/5 insider filings with structured trade data |
| Sector-level comparison |
| Industry aggregate comparison |
| Compare one stock against its industry aggregates |
| Filter within a specific industry |
| Analyst price targets and ratings |
| Insider buy/sell activity |
| Recent news headlines |
| Earnings-related and transcript-related headlines |
| Annual high, low, and average close price history from Yahoo Finance |
| 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 --versionIf 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-remoteStep 3: Configure Environment
Copy the example env file and add your email (required by the SEC for EDGAR API access):
cp .env.example .envEdit .env and set your contact email:
SEC_EMAIL=your-email@example.comStep 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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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.comLocal Remote Run
finviz-sec-mcp-remoteThis exposes:
/mcp/healthz
Render Deployment
This repo includes a starter render.yaml that:
deploys the web service from GitHub
runs
finviz-sec-mcp-remotehealth-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 toolscompare_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 YPEG basis defaults to industry
LTM EPS Diluted uses SEC TTM diluted EPS
JSON payload is omitted by default for readability; pass
include_json=Trueto 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_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
Scored across 24 tools
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.
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.
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.
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
Related MCP Connectors
Research-only MCP server: your AI as a quant research desk. 90 tools, no trades, no brokers.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
One MCP key: prices, fundamentals, SEC filings, insider/13F/congressional trades. 336 tools.
Financial data and research MCP for US/CN/JP equities: filings, statements, ownership, signals.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn 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.1751PythonMIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that exposes 16 free investment-research signals (insider trades, SEC filings, short data, and live quotes) to any MCP-compatible LLM.83 npm105MIT
- AlicenseAqualityDmaintenanceA comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.1075MIT
- AlicenseAqualityCmaintenanceComprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.269 npmMIT