FinanceQuery
io.github.Verdenroz/finance-query · v3.4.0 · MCP 2026-07-28
Stock quotes, charts, financials, options, SEC filings, crypto and macro data. Hosted, no API key.
Reachability
reachable
checked 2026-11-21 05:33 UTC
Registry status active
Tools pinned 64
0d955bc4e17b
Tools last changed
unchanged since first capture 2026-11-19
Repo last push 2026-11-19
as of 2026-11-21
GitHub stars 51
as of 2026-11-21
Provenance
Registry namespace io.github.Verdenroz
(GitHub-account verified by the official registry)
Repository
github.com/verdenroz/finance-query
Website
https://finance-query.com
Remote endpoints
https://finance-query.com/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-19 05:30 | first capture | 64 tools pinned |
Pinned tool definitions (64)
| Tool | Description |
|---|---|
| get_analysis | Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history. |
| get_calendar | Get a time-sorted calendar of upcoming financial events (earnings with estimates, ex-dividend and dividend-payment dates, options expirations, and — when FRED is configured — market-wide economic releases) across multiple symbols.... |
| get_chart | Get historical OHLCV candlestick chart data for one or more stock symbols (comma-separated). A single symbol supports start/end absolute timestamps and returns one chart; multiple symbols return a batch of charts plus per-symbol errors... |
| get_commodity | Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless). |
| get_company_profile | Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization). |
| get_congressional_trades | Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise. |
| get_crypto | Get top cryptocurrency coins by market cap from CoinGecko (no API key required). |
| get_crypto_news | Get market-wide crypto news (currently FMP only, requires FMP_API_KEY). |
| get_dividends | Get dividend history for one or more dividend-paying stocks (comma-separated symbols). A single symbol returns paginated dividend history plus analytics (CAGR, average payment, payout count); multiple symbols return a batch of dividend... |
| get_earnings_surprises | Get a stock's earnings-surprise history (actual vs. estimated EPS). |
| get_earnings_transcript | Get an earnings call transcript for a symbol. Provide quarter and year for a specific call, or omit both for the latest (Yahoo only). |
| get_edgar_facts | Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var. |
| get_edgar_search | Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var. |
| get_edgar_submissions | Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var. |
| get_etf_profile | Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings). |
| get_executive_compensation | Get disclosed executive compensation by year for a symbol. |
| get_fails_to_deliver | Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise. |
| get_fear_and_greed | Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100). |
| get_feeds | Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.). |
| get_filing_sections | Get sectioned text of one SEC filing by accession number (10-K or 8-K). Routes through EDGAR (best-effort HTML extraction) or Polygon when configured. |
| get_financials | Get income statement, balance sheet, or cash flow statement for one or more stock symbols (comma-separated). A single symbol returns one statement; multiple symbols return a batch plus per-symbol errors. |
| get_forex | Get a currency pair's current exchange rate, provider-routed (Capability::FOREX). |
| get_forex_news | Get market-wide forex news (currently FMP only, requires FMP_API_KEY). |
| get_fred_series | Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var. |
| get_futures | Get a futures contract's current quote, provider-routed (Yahoo, keyless). |
| get_grading_actions | Get provider-routed analyst upgrades and downgrades for a symbol. |
| get_holders | Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity. |
| get_index_constituent_changes | Get additions and removals from an index's constituent list. |
| get_index_constituents | Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only). |
| get_indicators | Get all 42 technical analysis indicators (SMA, EMA, RSI, MACD, Bollinger Bands, Ichimoku, etc.) for one or more stock symbols (comma-separated). A single symbol returns one indicators object; multiple symbols return a paginated batch... |
| get_indices | Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region. |
| get_industry | Get comprehensive industry data (overview, performance, top companies) for a specific industry slug. |
| get_key_metrics_ttm | Get trailing-twelve-month key metrics for a symbol. |
| get_market_calendar | Get a market-wide event calendar over a date range: earnings, IPOs, dividends, splits, economic releases, market holidays, or live exchange open/closed status. Unlike get_calendar (per-symbol), this spans the whole market. |
| get_market_hours | Get current market hours and open/closed status for a region. |
| get_market_summary | Get market overview with major indices and currencies for a region. |
| get_news | Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news. |
| get_options | Get the options chain for a symbol. Provide an expiration timestamp to get a specific expiry, or omit for the nearest expiration. |
| get_press_releases | Get a company's own press releases, distinct from get_news (press coverage). Routes through EDGAR 8-K exhibits, falling back to FMP/Alpha Vantage when configured. |
| get_price_target_consensus | Get a stock's consensus analyst price target (high/low/mean/median). |
| get_price_target_summary | Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY). |
| get_protocol_tvl | Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless). |
| get_protocol_tvl_history | Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless). |
| get_quote | Get current quote and company data (price, market cap, PE ratio, 52-week range, etc.) for one or more stock symbols (comma-separated). A single symbol returns one quote object; multiple symbols return a paginated batch of quotes plus... |
| get_rating_consensus | Get a stock's consensus analyst rating rollup (strong buy/buy/hold/sell/strong sell counts and a headline consensus label). |
| get_ratios_ttm | Get trailing-twelve-month financial ratios for a symbol. |
| get_recommendations | Get similar stock recommendations and analyst ratings for a symbol. |
| get_risk | Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol. |
| get_risk_factors | Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured. |
| get_sector | Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors. |
| get_sector_pe | Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless). |
| get_sector_performance | Get aggregate performance for every market sector, provider-routed (Yahoo screener fan-out, keyless). Distinct from get_sector (per-sector Yahoo-only shortcut). |
| get_sector_performance_history | Get sector performance per session, most recent first. |
| get_short_volume | Get daily FINRA short-sale volume for a symbol (keyless). |
| get_spark | Get lightweight close-price sparklines for multiple symbols. Faster and smaller than get_charts — use when you only need price direction/trend across many symbols. |
| get_splits | Get historical stock split history for a symbol. |
| get_symbol_details | Get reference detail for one symbol (name, exchange, SIC code, employees, list date). |
| get_transcripts | Get earnings call transcripts for a company. Returns paragraph-by-paragraph text (speaker, timestamp, text), paginated via paragraph_limit/paragraph_cursor since a full call can be tens of thousands of tokens. |
| get_treasury_auctions | Get US Treasury securities auction results (bid-to-cover ratio, high yield or discount rate, and the primary-dealer/direct/indirect bidder split), newest first. Set upcoming=true for the announced schedule of auctions not yet held. No... |
| get_treasury_yields | Get US Treasury yield curve data (1m through 30y) for a given year. No API key required. |
| get_trending | Get currently trending stock tickers for a region. |
| lookup | Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency). |
| screener | Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks). |
| search | Search for stocks, ETFs, and companies by name or ticker symbol. |
Get alerted when this changes.
Email the moment io.github.Verdenroz/finance-query drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.Verdenroz/finance-query)
Maintain this server? Add the badge to your README. It links your users to this live status page.