stock-scanner-mcp
This server provides a comprehensive suite of tools for stock and crypto market analysis, spanning scanning, technicals, options, insider trades, forex, sentiment, and more.
Stock Market
Scan US stocks (NYSE, NASDAQ, AMEX) with custom filters (price, RSI, volume, market cap, etc.)
Get delayed quotes, pre/post-market data, and compare 2–5 stocks side-by-side
Technical indicators: RSI, MACD, Bollinger Bands, moving averages, pivot points across multiple timeframes
Top gainers, losers, highest-volume stocks, and volume breakouts (2x+ above 10-day average)
Real-time VIX, S&P 500, NASDAQ, Dow Jones indices and sector ETF performance (XLK, XLF, etc.)
Market breadth: advance/decline ratio, % above SMA 50/200, 52-week highs/lows
Cryptocurrency
Real-time crypto quotes, scanning with custom filters, and technical analysis
Top gaining pairs, trending coins (by 24h search popularity), and global market stats (market cap, BTC/ETH dominance)
Crypto Fear & Greed Index with historical values
Options
Full options chains with Greeks (Delta, Gamma, Theta, Vega)
Unusual options activity detection, max pain strike price, implied move from ATM straddle pricing
CBOE put/call ratio (equity, index, or total)
SEC Filings & Ownership
Search SEC EDGAR filings; retrieve 10-K, 10-Q, 8-K reports
Financial metrics from XBRL data (Revenue, Net Income, EPS, Assets, Liabilities)
Insider trades (Form 4), institutional holdings (13F), and activist investor activity (13D/13G)
Sentiment & Reddit
CNN Fear & Greed Index with 7 sub-indicators and historical trend
Reddit trending tickers, mention counts, and bullish/bearish/neutral sentiment analysis across r/wallstreetbets, r/stocks, r/investing, r/options
Forex
Latest and historical ECB exchange rates for 31 currencies (back to 1999)
Date-range rate history (up to 90 days) and currency conversion
Additional Data (API keys required)
FINNHUB_API_KEY: Real-time quotes, company news, earnings, analyst ratings, short interestALPHA_VANTAGE_API_KEY: Daily price history, fundamentals, earnings, dividend historyFRED_API_KEY: Economic calendar and macro indicators (CPI, GDP, fed funds rate)
Personalized Workspace (optional)
Save a trading profile, named watchlists, and per-symbol investment thesis notes
Get personalized market briefs and alerts based on saved theses and live market data
Pre-built Workflows
19 ready-made skills covering daily market routines, in-depth analysis, trading strategies, macro insights, and risk assessment
Provides access to the CNN Fear & Greed Index for market sentiment analysis.
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., "@stock-scanner-mcp what are the top gaining stocks today?"
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.
stock-scanner-mcp
A modular MCP server for Claude Code and Claude Desktop that provides real-time access to stock and crypto market data. Scan markets, check technicals, monitor insider trades, track earnings, analyze options flow, and optionally save your own watchlists and thesis notes from one server.
69 tools across 15 modules — 11 modules work with zero API keys, including an optional stateful Market Workspace.
Quick Start
Three steps to get the full experience: server config, trading skills, and workspace setup.
Step 1 — Add the server to your MCP config
Copy this complete config block into your config file:
Claude Code:
~/.claude.json(global) or.mcp.json(project-local)Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows)
{
"mcpServers": {
"stock-scanner": {
"command": "npx",
"args": ["-y", "stock-scanner-mcp", "--enable-workspace"],
"env": {
"FINNHUB_API_KEY": "your-key-here",
"ALPHA_VANTAGE_API_KEY": "your-key-here",
"FRED_API_KEY": "your-key-here"
}
}
}
}This gives you 49 tools immediately with no API keys. API keys are optional and free — they unlock 20 additional tools for real-time quotes, news, earnings, and economic data. See API Keys below for where to get them.
Minimal config — if you don't want workspace or API keys, use this instead:
{ "mcpServers": { "stock-scanner": { "command": "npx", "args": ["-y", "stock-scanner-mcp"] } } }This gives you 42 stateless tools with no local data storage.
Restart Claude Desktop after saving. Claude Code picks up the config automatically.
Claude Code shortcut — install as a plugin instead of Steps 1 and 2. If you use Claude Code, skip the manual config above and install everything with two commands:
/plugin marketplace add yyordanov-tradu/stock-scanner-mcp /plugin install stock-scanner@tradu-marketplaceRun
/reload-plugins, then/mcp— you should see thestock-scannerserver listed as connected. The first launch runsnpx -y stock-scanner-mcp, which downloads the package once (then it is cached). The plugin enables the workspace by default (data is stored in~/.stock-scanner-mcp) and passes the optional API keys (FINNHUB_API_KEY,ALPHA_VANTAGE_API_KEY,FRED_API_KEY) through from your environment; modules without a key are skipped automatically.The plugin already bundles the skills — do NOT run Step 2. All 19 skills ship with the plugin and load under the
stock-scanner:namespace, e.g./stock-scanner:analyze-stock AAPL,/stock-scanner:morning-briefing,/stock-scanner:setup-market-workspace. Running the Step 2 installer as well copies a second, unprefixed set into~/.claude/skills/, and the two collide — Step 2 is only for the manual (non-plugin) install. After installing, go straight to Step 3, using the namespaced command:/stock-scanner:setup-market-workspace.
Step 2 — Install the trading skills
Skip this step if you installed via the plugin above — the plugin already bundles these skills (as
stock-scanner:<name>). This step is only for the manual config in Step 1.
Run this command in your terminal:
npx -p stock-scanner-mcp stock-scanner-install-skillsThis installs 19 slash commands (like /morning-briefing, /analyze-stock AAPL, /setup-market-workspace) into ~/.claude/skills/ so they're available in every Claude Code session. See Trading Skills for the full list.
Step 3 — Set up your workspace
Run /setup-market-workspace in Claude Code. It asks three quick questions:
> /setup-market-workspace
Setting up your market workspace — I'll ask a few quick questions to get started...
1. What kind of trader or investor are you?
(e.g., options trader, swing trader, long-term investor, crypto-focused)
→ "I'm mostly a swing trader, also watch crypto"
2. Which names or assets should I save to your core watchlist?
(e.g., AAPL, MARA, BTC, Gold)
→ "MARA, HOOD, SOFI, BTC, ETH"
3. Do you want a daily or weekly market review?
→ "Daily"Once answered, it saves your profile and creates a core watchlist:
✓ Workspace saved
Profile swing trader | daily review
Watchlist core — MARA, HOOD, SOFI, BTC, ETHYou can also skip the skill and ask Claude directly: "Set up my workspace — I'm a swing trader, create a core watchlist with MARA, HOOD, BTC, daily reviews."
That's it. You now have 69 tools, 19 skills, and a personalized workspace. Try /workspace-morning-brief for your first tailored market scan.
Related MCP server: Trading MCP Server
What You Can Do
"What are the top gaining stocks today?"
"Show me technicals for AAPL on the hourly timeframe"
"Any insider trades for TSLA in the last 30 days?"
"What's the options chain for AAPL expiring next Friday?"
"What's the current fed funds rate and CPI trend?"
"Convert $10,000 USD to EUR"
"Set up a core watchlist with MARA, HOOD, and BTC"
"Give me a personalized morning brief for my saved watchlist"Highlights
Stock scanning — screen by price, RSI, volume, market cap with custom filters
Technical analysis — RSI, MACD, Bollinger Bands, moving averages, pivots across multiple timeframes
Options flow — chains with Greeks, unusual activity detection, max pain, implied move
Insider trades — parsed Form 4 transactions with buy/sell/grant details
Earnings & news — calendar, analyst ratings, company news, short interest
Crypto — real-time quotes, technicals, trending coins, market stats
Macro — CPI, GDP, fed funds rate, economic calendar, yield curve data
Forex — 31 currency pairs from ECB, conversion, historical rates
Sentiment — CNN Fear & Greed Index, Crypto Fear & Greed
Market Workspace — save a trading profile, named watchlists, and thesis notes for personalized workflows across sessions
Trading Skills
19 ready-made workflows that chain multiple tools into structured analysis. Each skill orchestrates 5-14 tools in parallel and outputs a verdict with direction, confidence, and key levels.
Category | Skills | What They Do |
Daily Routines |
| Pre-market scan, EOD recap, crypto overview |
Analysis |
| Deep dives and side-by-side comparisons |
Strategies |
| Swing trades, earnings options, smart money, income screen |
Macro |
| Economic indicators, Fed outlook, sector rotation |
Risk |
| Insider trades, institutional flow, pre-trade risk scorecard |
Workspace |
| Guided setup for saved profile/watchlist context and a personalized brief driven by your stored names |
Skills degrade gracefully when optional API keys are missing. Workspace skills require --enable-workspace in the server config.
npx -p stock-scanner-mcp stock-scanner-install-skills # all 19 skills
npx -p stock-scanner-mcp stock-scanner-install-skills --scope project # project only (.claude/skills/)
npx -p stock-scanner-mcp stock-scanner-install-skills --category macro # one category
npx -p stock-scanner-mcp stock-scanner-install-skills --category workspace # workspace skills only
npx -p stock-scanner-mcp stock-scanner-install-skills --list # list without installing
npx -p stock-scanner-mcp stock-scanner-install-skills --force # overwrite existingManual: git clone this repo and cp -r skills/*/ ~/.claude/skills/
See skills/README.md for the full catalog.
Market Workspace
The Market Workspace is an optional stateful layer that remembers your trading context across sessions — your trading style, named watchlists, and investment thesis notes per symbol. Skills like /workspace-morning-brief use this context to deliver personalized market scans instead of generic ones.
What you can do with it
/workspace-morning-brief— personalized pre-market scan that reads your profile and watchlist, checks earnings, news, and price action for your names, and highlights what matters todayAdd more watchlists — ask Claude: "Create a watchlist called 'earnings' with AAPL, MSFT, GOOG"
Track investment theses — save your reasoning per ticker so the system monitors it for you (see below)
Update anytime — "Add NVDA to my core watchlist" or "Change my review cadence to weekly"
Thesis Tracking
Save your investment reasoning per ticker — direction, key levels, catalysts, and timeframe — so the system can monitor it across sessions.
Save a thesis:
"My thesis on NIO: bullish above $6.35, that confirms the uptrend. Below it the setup is invalid."Claude saves the structured thesis:
Field | Value |
Direction | Bullish above $6.35 |
Bear case | Below $6.35 uptrend is invalidated |
Catalyst | Technical breakout at $6.35 |
Timeframe | Swing |
How it works in practice: When you run /workspace-morning-brief, the brief cross-references your saved theses against live price action:
NIO drops to $6.10 → "NIO broke below your $6.35 thesis floor — re-evaluate."
NIO rallies to $7.20 → "NIO holding above your $6.35 level — uptrend thesis intact."
Without a thesis, the brief just reports a price change. With a thesis, it tells you whether the move matters to your plan.
Each thesis supports five fields: summary, bullCase, bearCase, catalyst, and timeframe. You can save up to 200 theses per workspace.
Configuration reference
Option | Default | Description |
| off | Activate the 7 workspace tools |
|
| Directory for |
|
| Default exchange for ticker resolution |
Data is stored locally in workspace.json — no cloud sync, no external calls. If you omit --enable-workspace, the server stays fully stateless and writes no local data.
For the full list of workspace tools, see the tool reference below.
Documentation
Installation & Setup — Getting the MCP server running in Claude Code or Cursor
Trading Skills — Ready-made workflows for professional analysis
Sidecar HTTP API — REST endpoints for non-MCP clients
Docker Deployment — Running in containers with workspace persistence
FAQ & Troubleshooting — Common issues and solutions
Modules
Module | Tools | API Key | Description |
tradingview | 10 | None | US stock scanner with quotes, technicals, sectors, indices, and screening |
tradingview-crypto | 4 | None | Crypto pair scanner with technicals and screening |
sec-edgar | 6 | None | SEC filings, insider trades, institutional holdings, ownership |
coingecko | 3 | None | Crypto market data, trending coins, global stats |
options | 5 | None | Options chains, Greeks, unusual activity, max pain, implied move |
options-cboe | 1 | None | CBOE put/call ratio sentiment indicator |
sentiment | 2 | None | CNN Fear & Greed Index, Crypto Fear & Greed Index |
frankfurter | 5 | None | Forex exchange rates — 31 currencies from ECB (daily reference rates) |
4 | None | Reddit trending tickers, mention tracking, sentiment, and batch watchlist scan from r/wallstreetbets, r/stocks, r/investing, r/options | |
market-breadth | 1 | None | Market breadth metrics (advance/decline ratio, SMA 50/200, 52-week highs/lows) |
unified-market | 3 | None | Smart provider routing for quotes, profiles, and technicals across Finnhub, Alpha Vantage, and TradingView |
workspace | 7 | None | Optional stateful profile, watchlists, and thesis tracking for personalized workflows ( |
finnhub | 9 |
| Quotes, news, earnings, analyst ratings, short interest |
alpha-vantage | 5 |
| Quotes, daily prices, fundamentals, earnings, dividends |
fred | 4 |
| Economic calendar, indicators (CPI, GDP, rates), historical data |
Modules auto-enable when their API key is set. No-key modules are always enabled, except workspace, which requires --enable-workspace.
For a complete list of every tool with descriptions, see the Full Tool Reference below.
Full Tool Reference (69 tools)
TradingView — Stock Scanning (no API key)
Tool | Description |
| Scan US stocks with custom filters (price, RSI, volume, etc.) |
| Side-by-side comparison of 2-5 stocks |
| 15-min delayed quotes for stock tickers (includes pre/post-market) |
| Technical indicators (RSI, MACD, moving averages, pivots) |
| Today's top gaining stocks by % change |
| Today's top losing stocks by % change |
| Highest volume stocks today |
| Real-time VIX, S&P 500, NASDAQ, Dow Jones |
| S&P 500 sector ETF performance (weekly, monthly, YTD) |
| Stocks with unusual volume (2x+ their 10-day average) |
TradingView — Crypto (no API key)
Tool | Description |
| Scan crypto pairs with custom filters across major exchanges |
| Real-time crypto pair quotes (e.g. BTCUSDT, ETHUSDT) |
| Technical analysis for crypto pairs (RSI, MACD, MAs, Bollinger) |
| Top gaining crypto pairs by % change |
SEC EDGAR — Filings & Ownership (no API key)
Tool | Description |
| Full-text search across all SEC filings |
| Recent official filings (10-K, 10-Q, 8-K) for a company |
| Financial metrics from XBRL data (Revenue, EPS, Net Income) |
| Insider buy/sell activity with parsed Form 4 transaction details |
| Institutional holdings (13F) by ticker or manager name |
| Major ownership changes — 13D/13G activist investor filings |
CoinGecko — Crypto Intelligence (no API key)
Tool | Description |
| Detailed crypto info by CoinGecko slug (e.g. 'bitcoin', 'solana') |
| Top 7 trending cryptos by search volume (last 24h) |
| Global crypto market cap, volume, BTC/ETH dominance |
Options — Chains, Greeks & Unusual Activity (no API key)
Tool | Description |
| Available expiration dates for a stock's options |
| Full options chain with Greeks for a given expiration |
| Unusual options activity — high volume/OI contracts |
| Max pain (strike where most options expire worthless) |
| Expected move from ATM straddle pricing |
Options CBOE — Put/Call Sentiment (no API key)
Tool | Description |
| CBOE equity/index/total put/call ratio for market sentiment |
Sentiment — Fear & Greed (no API key)
Tool | Description |
| CNN Fear & Greed Index — composite score (0-100) with 7 sub-indicators |
| Crypto Fear & Greed Index — daily score (0-100) with historical values |
Frankfurter — Forex Rates (no API key)
Tool | Description |
| Latest ECB exchange rates for 31 currencies |
| Exchange rates for a specific past date |
| Daily rate history for a date range (max 90 days) |
| Convert an amount between two currencies |
| List all supported currency codes |
Reddit — Trending Tickers & Sentiment (no API key)
Tool | Description |
| Trending stock tickers from Reddit by mention frequency across r/wallstreetbets, r/stocks, r/investing, r/options |
| Mention count and top posts for a specific ticker across Reddit investing subreddits |
| Keyword-based sentiment analysis (bullish/bearish/neutral) for a ticker from Reddit discussions |
| Batch Reddit scan for a list of tickers in one pass (combined OR query, ceil(N/20)×4 requests) — per-ticker mentions, sentiment, top post, and a hot flag (≥5 mentions) |
Market Breadth — Breadth Indicators (no API key)
Tool | Description |
| Get market breadth statistics for US equities: advance/decline ratio, SMA 50/200 percent above, and 52-week new highs/lows |
Unified Market — Smart Routing (no API key)
Tool | Description |
| Get current price, change, volume, and day high/low for a given symbol. Automatically routes to the best available data provider. |
| Get general company metrics, exchange, description, and capitalization. Automatically routes to the best available data provider. |
| Get common technical indicators (RSI, moving averages, etc.) for a given symbol. |
Workspace — Personalized Context (optional, no API key)
Enabled only when you start the server with --enable-workspace.
Tool | Description |
| Read the saved trading profile and workspace defaults |
| Save or update trading style, asset focus, and review cadence |
| List all saved watchlists and their resolved instruments |
| Create a named empty watchlist such as |
| Replace a watchlist's saved symbols with resolved, deduplicated instruments |
| Read a thesis for a symbol using a stable hit/miss JSON shape |
| Save or update a thesis note for a symbol |
Finnhub — News, Earnings & Macro (requires FINNHUB_API_KEY)
Tool | Description |
| Real-time stock quote |
| Company info (industry, market cap, IPO date, website) |
| Comparable companies in the same industry |
| Exchange open/closed status and current session |
| Latest market news (general, forex, crypto, merger) |
| Company-specific news by ticker and date range |
| Upcoming and historical earnings reports |
| Analyst consensus and rating history |
| Short interest, short ratio, and key financial metrics |
Alpha Vantage — Fundamentals & History (requires ALPHA_VANTAGE_API_KEY)
Tool | Description |
| Real-time stock quote (price, change, volume) |
| Daily OHLCV price history (up to 100 days) |
| Company fundamentals (PE, market cap, sector, analyst target) |
| Historical EPS actual vs estimate by quarter |
| Historical dividend payments and dates |
FRED — US Economic Data (requires FRED_API_KEY)
Tool | Description |
| Upcoming high-impact economic releases (FOMC, CPI, NFP, GDP) |
| Latest value for any indicator (CPI, fed funds, unemployment, etc.) |
| Historical values with unit transforms (YoY %, change, level) |
| Discover FRED series IDs by keyword |
Configuration
CLI Options
npx -y stock-scanner-mcp --modules tradingview,sec-edgar # Enable specific modules only
npx -y stock-scanner-mcp --default-exchange NYSE # Set default exchange
npx -y stock-scanner-mcp --enable-workspace # Turn on local workspace tools
npx -y stock-scanner-mcp --enable-workspace --data-dir /tmp/market-workspace # Custom data directory
npx -y stock-scanner-mcp --help # Show all optionsAPI Keys (optional)
All three keys are free — no credit card required:
Key | Get it from | What it unlocks |
| Real-time quotes, company news, earnings calendar, analyst ratings, short interest (9 tools) | |
| Daily price history, company fundamentals, earnings & dividend history (5 tools) | |
| Economic calendar, CPI/GDP/fed funds indicators, historical data (4 tools) |
Add them to the env block in your MCP config (see Quick Start).
Use with other MCP clients
Any MCP client that supports stdio servers can run this package. Use the same JSON config from Quick Start. If your client does not expose npx, install the package first and point the client at the installed binary instead.
HTTP Sidecar
An optional HTTP server exposing all tools as REST endpoints for non-MCP integrations (GPT Actions, chat UIs, LLM pipelines). It includes an OpenAPI 3.1 specification for automated tool discovery.
npx stock-scanner-sidecar # Start on port 3200
npx stock-scanner-sidecar --port 8080 # Custom port
# Optional: Enable the stateful Market Workspace via HTTP
npx stock-scanner-sidecar --enable-workspace --data-dir ./my-data
# Access the OpenAPI spec
curl http://localhost:3200/openapi.jsonSee Sidecar HTTP API for endpoint details.
69 tools exposed as REST routes, including /market/quote, /options/chain, /workspace/profile, and more.
Rate Limits
API | Free Tier Limit | Cache TTL |
TradingView | No documented limit | — |
SEC EDGAR | 10 req/sec | 5 min |
CoinGecko | ~30 calls/min | 1 min |
Yahoo Finance (Options) | No documented limit | 5 min |
CBOE | No documented limit | 30 min |
Finnhub | 30 calls/sec | 5 min |
Alpha Vantage | 5 calls/min, 25/day | 1 min |
FRED | No hard limit | 30 min |
Frankfurter (ECB) | No limit | 1 hour |
All modules use in-memory TTL caching to minimize API calls.
Development
npm install && npm run build && npm test
npm run lint # TypeScript type checking
npm run validate-tools # Tool description quality check
npm run validate-doc-tools # Skill/command tool reference checkCredibility Artifacts
src/
├── index.ts # MCP server entry + prompt definitions
├── config.ts # CLI arg parsing
├── registry.ts # Module auto-discovery and filtering
├── modules/
│ ├── tradingview/ # 10 tools — stock scanning, quotes, technicals, sectors, indices
│ ├── tradingview-crypto/ # 4 tools — crypto scanning and technicals
│ ├── sec-edgar/ # 6 tools — filings, insider trades, holdings
│ ├── coingecko/ # 3 tools — crypto market data
│ ├── options/ # 5 tools — options chains, Greeks, unusual activity, implied move
│ ├── options-cboe/ # 1 tool — CBOE put/call ratio sentiment
│ ├── workspace/ # 7 tools — stateful profile, watchlists, thesis notes
│ ├── finnhub/ # 9 tools — quotes, news, earnings, analyst ratings, short interest
│ ├── alpha-vantage/ # 5 tools — quotes, fundamentals, dividends
│ ├── fred/ # 4 tools — economic calendar, indicators, historical data
│ ├── sentiment/ # 2 tools — Fear & Greed indexes (market + crypto)
│ ├── frankfurter/ # 5 tools — forex exchange rates (ECB, 31 currencies)
│ ├── reddit/ # 4 tools — trending tickers, mentions, sentiment, watchlist scan from Reddit
│ └── unified-market/ # 3 tools — smart provider routing for quotes/profiles/technicals
├── sidecar/
│ ├── index.ts # HTTP sidecar entry point (port 3200)
│ ├── routes.ts # Declarative URL routing table
│ └── server.ts # Dynamic HTTP request handler
└── shared/
├── http.ts # HTTP client with timeouts and key sanitization
├── cache.ts # In-memory TTL cache
├── types.ts # ToolDefinition, ToolResult, helpers
├── resolver.ts # Ticker/exchange resolution
└── utils.ts # withMetadata error wrapperLicense
MIT
Available Tools
39 toolscoingecko_coinARead-only
Get detailed cryptocurrency info from CoinGecko. Use slug IDs (e.g. 'bitcoin', 'ethereum', 'solana'), NOT ticker symbols.
Inputs: coinId (required).
coingecko_globalARead-only
Get global cryptocurrency market statistics: total market cap, 24h volume, BTC/ETH dominance.
Inputs: no named parameters.
coingecko_trendingARead-only
Get trending cryptocurrencies on CoinGecko (top 7 by search popularity in last 24h).
Inputs: no named parameters.
crypto_quoteARead-only
Get real-time quotes for specific crypto pairs. Supports 'BTCUSDT' (defaults to BINANCE) or 'BINANCE:BTCUSDT'.
Inputs: symbols (required).
crypto_scanBRead-only
Scan cryptocurrency pairs using TradingView filters. Returns price, volume, and technical indicators.
Inputs: filters, major_only, columns, timeframe, +1 more.
crypto_technicalsARead-only
Get technical analysis for crypto pairs. Supports 'BTCUSDT' or 'BINANCE:BTCUSDT'.
Inputs: symbols (required), timeframe.
crypto_top_gainersARead-only
Get top gaining cryptocurrency pairs by percentage change. Defaults to major exchanges and volume > $10k.
Inputs: exchange, limit.
edgar_company_factsARead-only
Retrieve high-fidelity financial metrics (Revenue, Net Income, EPS, Assets, Liabilities) directly from SEC XBRL data. This is more reliable than extracting numbers from text filings.
Inputs: ticker (required).
edgar_company_filingsARead-only
Retrieve the most recent official filings for a specific company. Use this to find a company's latest 10-K (annual), 10-Q (quarterly), or 8-K (current events) reports.
Inputs: ticker (required), forms, limit.
edgar_insider_tradesARead-only
Monitor legal stock trades made by company executives and directors (Forms 3, 4, 5). Returns detailed transaction data including insider names, titles, buy/sell type, share amounts, and prices.
Inputs: ticker (required), limit.
edgar_institutional_holdingsARead-only
Track 'big money' moves by searching Form 13F filings. Use to find what hedge funds and institutional managers (e.g. 'Berkshire Hathaway') are holding or what firms own a specific ticker.
Inputs: query (required), limit.
edgar_ownership_filingsARead-only
Monitor significant changes in company ownership (5%+ stakes). Use 13D and 13G filings to identify activist investors (e.g. Carl Icahn, Ryan Cohen) entering or exiting a stock.
Inputs: ticker (required), limit.
edgar_searchARead-only
Search SEC EDGAR filings by keyword. Best for finding mentions of specific trends, technologies, or events across all companies. Returns metadata including accession numbers, form types, and direct sec.gov links.
Inputs: query (required), dateRange, forms, tickers, +1 more.
frankfurter_convertARead-only
Convert an amount between two currencies at the latest ECB daily reference rate. Updated once per business day — not suitable for intraday trading rates. Useful for cross-border stock valuation and currency exposure calculations.
Inputs: amount (required), from (required), to (required).
frankfurter_currenciesARead-only
List all 31 currencies supported by the Frankfurter API with their full names. Use to look up valid currency codes before calling other frankfurter tools.
Inputs: no named parameters.
frankfurter_historicalARead-only
Get ECB forex exchange rates for a specific past date. Daily reference rates, not real-time trading rates. If the date is a weekend or holiday, returns the previous business day's rates. Data available from 1999-01-04 (Euro inception).
Inputs: date (required), base, symbols.
frankfurter_latestARead-only
Get latest forex exchange rates from the European Central Bank. Returns daily reference rates for 31 major currencies. Updated once per business day at ~16:00 CET. These are reference rates, not real-time trading rates.
Inputs: base, symbols.
frankfurter_timeseriesARead-only
Get daily ECB forex rate history for a date range (max 90 days). Daily reference rates, not real-time. Use for currency trend analysis. Only business days included (weekends/holidays omitted). Requires symbols filter to control response size.
Inputs: start_date (required), symbols (required), end_date, base.
options_chainARead-only
Get the full option chain (calls and puts) with calculated Greeks (Delta, Gamma, Theta, Vega). Use options_expirations first to find valid dates. If expiration is omitted, uses nearest date. By default, returns strikes within ±20% of current price to save tokens. Use strike_min/strike_max for custom range, or all_strikes=true for everything.
Inputs: symbol (required), expiration, side, limit, +3 more.
options_expirationsARead-only
Get all available option expiration dates for a stock ticker. Call this first to discover valid dates, then pass one to options_chain or options_max_pain.
Inputs: symbol (required).
options_implied_moveARead-only
Calculate the expected move implied by options pricing (ATM straddle). Essential for earnings plays — shows how much the market expects the stock to move. Compare implied vs historical moves to assess if premium is cheap or expensive.
Inputs: symbol (required), expiration.
options_max_painARead-only
Calculate the max pain strike price — where cumulative option open interest expires worthless. This level often acts as a support/resistance zone near expiration.
Inputs: symbol (required), expiration.
options_put_call_ratioARead-only
Get historical put/call ratio from CBOE (market-wide sentiment indicator). Ratio > 1.0 = more puts (bearish sentiment), < 0.7 = more calls (bullish/complacent). Types: 'total' (all options), 'equity' (stock options only), 'index' (index options only).
Inputs: type, days.
options_unusual_activityARead-only
Find options contracts with unusually high volume relative to open interest (a common 'smart money' signal). Scans the nearest expiration and flags contracts where volume/OI exceeds a threshold.
Inputs: symbol (required), volume_oi_ratio, min_volume, side.
reddit_mentionsARead-only
Get mention count and top posts for a specific stock ticker across Reddit. Searches r/wallstreetbets, r/stocks, r/investing, and r/options. Returns total mentions, per-subreddit breakdown, and top 10 posts by score. Use this to check how much retail attention a ticker is getting.
Inputs: symbol (required), period.
reddit_sentimentARead-only
Get sentiment analysis for a stock ticker from Reddit discussions. Searches r/wallstreetbets, r/stocks, r/investing, and r/options, then scores each post using keyword matching (bullish terms like 'moon', 'calls', 'breakout' vs bearish terms like 'crash', 'puts', 'dump'). Returns bullish/bearish/neutral counts, average sentiment score, and sample posts. Limitation: keyword-based scoring, not NLP — sarcasm and context may be missed.
Inputs: symbol (required), limit.
reddit_trendingARead-only
Get trending stock tickers from Reddit based on mention frequency. Scans r/wallstreetbets, r/stocks, r/investing, and r/options for posts mentioning tickers. Returns tickers sorted by mention count with per-subreddit breakdown. Limitation: uses keyword extraction (cashtags + uppercase words), not NLP — some false positives possible. Best for gauging retail buzz, not precise sentiment.
Inputs: subreddits, limit.
sentiment_crypto_fear_greedARead-only
Get the Crypto Fear & Greed Index from Alternative.me. Returns a score (0-100) with rating (extreme fear/fear/neutral/greed/extreme greed). Based on Bitcoin volatility, market volume, social media, surveys, dominance, and trends. Use this alongside coingecko tools for crypto market context.
Inputs: no named parameters.
sentiment_fear_greedARead-only
Get the CNN Fear & Greed Index for the US stock market. Returns a composite score (0-100) with rating (extreme fear/fear/neutral/greed/extreme greed) and 7 sub-indicators: S&P 500 momentum, stock price strength (52w highs vs lows), stock price breadth (McClellan), put/call ratio, VIX, junk bond demand, safe haven demand. Also includes previous close, 1-week, 1-month, and 1-year scores for trend context. Use this to gauge overall market sentiment before analyzing individual stocks.
Inputs: no named parameters.
tradingview_compare_stocksARead-only
Returns price, change, market cap, P/E, EPS, revenue, dividend yield, RSI, and analyst recommendation rating (-1 sell to +1 buy) for 2-5 stocks. Revenue growth rate and analyst price targets are not available.
Inputs: tickers (required).
tradingview_market_indicesARead-only
Get real-time values for major market indices: VIX (volatility), S&P 500, NASDAQ Composite, and Dow Jones. Essential for gauging broad market conditions, risk sentiment, and options pricing context.
Inputs: no named parameters.
tradingview_quoteARead-only
Get a 15-minute delayed quote for one or more stock tickers (e.g. 'AAPL' or 'NASDAQ:AAPL'). Returns price, change, volume, market cap, and pre-market/after-hours data when available. Data is delayed ~15 minutes during market hours — use finnhub_quote for real-time prices if available. If a ticker returns empty results, retry with the correct exchange prefix (e.g. 'NYSE:CDE', 'AMEX:XYZ').
Inputs: tickers (required).
tradingview_scanARead-only
Scan US stocks with custom filters (price > X, RSI < 30, etc.). Returns up to limit rows with the requested columns.
Inputs: exchange, filters, columns, timeframe, +1 more.
tradingview_sector_performanceARead-only
Get performance of S&P 500 sector ETFs (XLK, XLF, XLE, XLV, XLI, XLP, XLU, XLY, XLC, XLRE, XLB). Shows which sectors are leading or lagging today. Essential for sector rotation analysis.
Inputs: no named parameters.
tradingview_technicalsARead-only
Get technical indicators (RSI, MACD, moving averages, pivot points, etc.) for one or more stock tickers. If a ticker returns empty results, retry with the correct exchange prefix (e.g. 'NYSE:CDE', 'AMEX:XYZ').
Inputs: tickers (required), timeframe.
tradingview_top_gainersARead-only
Get today's top gaining stocks by percentage change on a given exchange. Defaults to major US exchanges (NYSE, NASDAQ, AMEX) with market cap > $100M. OTC penny stocks excluded by default.
Inputs: exchange, include_otc, limit.
tradingview_top_losersARead-only
Get today's top losing stocks by percentage change on a given exchange. Defaults to major US exchanges (NYSE, NASDAQ, AMEX) with market cap > $100M. OTC penny stocks excluded by default.
Inputs: exchange, include_otc, limit.
tradingview_top_volumeARead-only
Get stocks with the highest trading volume today. Defaults to major US exchanges.
Inputs: exchange, include_otc, limit.
tradingview_volume_breakoutARead-only
Find stocks with unusual volume (current volume significantly above average). Defaults to major exchanges.
Inputs: exchange, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 39 tools
Tools are grouped by clear prefixes (coingecko_, crypto_, edgar_, frankfurter_, options_, reddit_, sentiment_, tradingview_) and each group has distinct purposes. However, slight overlap exists between crypto and stock sentiment tools (sentiment_crypto_fear_greed vs sentiment_fear_greed) and between quote tools (crypto_quote vs coingecko_coin) which may cause minor confusion.
All tool names follow a consistent snake_case pattern with a descriptive prefix and noun (e.g., coingecko_coin, edgar_company_facts, options_chain, reddit_mentions). No mixing of conventions, making it easy for an agent to predict tool names.
With 39 tools, the server is on the higher end of the acceptable range. The breadth of domains (crypto, stocks, options, forex, SEC filings, Reddit, sentiment) justifies many tools, but some may be redundant (e.g., multiple crypto price tools), slightly bloating the count.
The tool set covers an extensive range of financial research needs: crypto data, stock quotes/scans/technicals, options analysis, forex rates, SEC filings, Reddit sentiment, and market sentiment indices. It provides a complete toolkit for investment analysis with few obvious gaps.
Maintenance
Related MCP Connectors
Production MCP server for US equity and options intelligence: real-time IV radar, Monte Carlo simulation, options pressure, strategy backtesting, AI prediction, pre-trade risk analysis, and automated stock research reports.
Graded stock setups, options flow, and multi-window trend research over a hosted OAuth MCP endpoint.
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceReal-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.-
- 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
- FlicenseNot gradedqualityCmaintenanceA remote Model Context Protocol (MCP) server for real-time cryptocurrency and stock market analysis. Provides AI-powered market intelligence tools with 9 theory-based analysis engines, multi-chain DEX discovery, and enterprise features.-