FinanceQuery

● Active

io.github.Verdenroz/finance-query

Stock quotes, charts, financials, options, SEC filings, crypto and macro data. Hosted, no API key.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "finance-query": {
      "url": "https://finance-query.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http finance-query https://finance-query.com/mcp
VS Code
code --add-mcp '{"name":"finance-query","type":"http","url":"https://finance-query.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Finance
Version
3.4.0
Registry
active
Published
11/19/2026

Live check

checked Nov 19, 2026, 06:07 UTC
● Working213 msprotocol 2025-06-18v3.4.0tools

The endpoint answered the MCP handshake as "fq-mcp" and listed 64 tools. Answering since Nov 19, 2026.

Context cost ≈ 14k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 64 tools.

Tools (64)

  • get_analysis3 params

    Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.

    Show parameters
    • analysis_typestringrequiredAnalysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • symbolstringrequiredStock ticker symbol
  • get_calendar3 params

    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. Answers 'what's coming up for my portfolio?' in one call.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • rangestringrequiredForward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)
    • symbolsstringrequiredComma-separated list of ticker symbols (e.g., "AAPL,MSFT,TSLA")
  • get_chart8 params

    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 (interval/range only, no start/end).

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • endinteger | nullEnd date as Unix timestamp (seconds). Defaults to now when `start` is set.
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • intervalstringrequiredCandle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)
    • limitinteger | nullMaximum candles per page; omitted = curated default (25)
    • rangestringrequiredTime range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set.
    • startinteger | nullStart date as Unix timestamp (seconds). When provided, overrides `range`.
    • symbolsstringrequiredOne or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOG")
  • get_commodity2 params

    Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredCommodity symbol (e.g. "GCUSD" for gold, "CLUSD" for crude oil)
  • get_company_profile2 params

    Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredStock ticker symbol
  • get_congressional_trades4 params

    Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol
  • get_crypto5 params

    Get top cryptocurrency coins by market cap from CoinGecko (no API key required).

    Show parameters
    • countinteger | nullNumber of top coins to return (default: 50, max: 250)
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum coins per page; omitted = curated default (25)
    • vs_currencystring | nullQuote currency (default: usd)
  • get_crypto_news4 params

    Get market-wide crypto news (currently FMP only, requires FMP_API_KEY).

    Show parameters
    • countinteger | nullOverall cap on articles fetched (default: 20)
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • limitinteger | nullMaximum articles per page; omitted = curated default (25)
  • get_dividends5 params

    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 histories plus per-symbol errors (no analytics for batch).

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • limitinteger | nullMaximum dividend payments per page; omitted = curated default (25)
    • rangestringrequiredTime range: 1y|2y|5y|10y|max (default: max)
    • symbolsstringrequiredOne or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,KO,JNJ")
  • get_earnings_surprises2 params

    Get a stock's earnings-surprise history (actual vs. estimated EPS).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredStock ticker symbol
  • get_earnings_transcript4 params

    Get an earnings call transcript for a symbol. Provide quarter and year for a specific call, or omit both for the latest (Yahoo only).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • quarterstringrequiredFiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers with no "latest" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted
    • symbolstringrequiredStock ticker symbol
    • yearinteger | nullFiscal year. See `quarter`
  • get_edgar_facts6 params

    Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var.

    Show parameters
    • conceptsstring | nullComma-separated XBRL concept names to filter to (e.g. "Revenues,Assets"); omitted = curated defaults (headline financials)
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated GraphQL sub-fields to include per concept (e.g. "concept,dataPoints"); omitted = curated default set
    • limitinteger | nullMaximum data points per concept per page; omitted = curated default (25). Applied uniformly across every returned concept.
    • symbolstringrequiredStock ticker symbol (e.g., "AAPL", "MSFT", "TSLA")
    • taxonomystring | nullXBRL taxonomy (default: "us-gaap"); also try "ifrs-full" or "dei"
  • get_edgar_search6 params

    Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var.

    Show parameters
    • end_datestring | nullEnd date filter in YYYY-MM-DD format
    • formsstring | nullComma-separated form types to filter (e.g., "10-K,10-Q,8-K")
    • frominteger | nullPagination offset; omitted = 0 (first page)
    • querystringrequiredSearch query (keywords in filing text)
    • sizeinteger | nullPage size; omitted = 100, max 100
    • start_datestring | nullStart date filter in YYYY-MM-DD format
  • get_edgar_submissions4 params

    Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum filings per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol (e.g., "AAPL", "MSFT", "TSLA")
  • get_etf_profile2 params

    Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredETF ticker symbol
  • get_executive_compensation4 params

    Get disclosed executive compensation by year for a symbol.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol
  • get_fails_to_deliver4 params

    Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol
  • get_fear_and_greed1 param

    Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
  • get_feeds4 params

    Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.).

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • sourcesstring | nullComma-separated feed sources: federal-reserve|sec|marketwatch|cnbc|bloomberg|ft|nyt| guardian|investing|bea|ecb|cfpb|wsj|fortune|businesswire|coindesk|cointeleg
  • get_filing_sections4 params

    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.

    Show parameters
    • accession_numberstringrequiredSEC accession number, e.g. "0000320193-24-000123"
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • formstringrequiredWhich filing form to fetch sectioned text for: ten-k | eight-k
    • symbolstringrequiredStock ticker symbol
  • get_financials5 params

    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.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • frequencystringrequiredReporting frequency: annual | quarterly (default: annual)
    • metricsstring | nullComma-separated list of line-item metrics to filter to; omitted = all reported metrics
    • statementstringrequiredStatement type: income | balance | cashflow
    • symbolsstringrequiredOne or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOGL")
  • get_forex3 params

    Get a currency pair's current exchange rate, provider-routed (Capability::FOREX).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • fromstringrequiredBase currency code (e.g. "USD")
    • tostringrequiredQuote currency code (e.g. "EUR")
  • get_forex_news4 params

    Get market-wide forex news (currently FMP only, requires FMP_API_KEY).

    Show parameters
    • countinteger | nullOverall cap on articles fetched (default: 20)
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • limitinteger | nullMaximum articles per page; omitted = curated default (25)
  • get_fred_series5 params

    Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var.

    Show parameters
    • as_ofstring | nullVintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • idstringrequiredFRED series ID (e.g., "FEDFUNDS", "CPIAUCSL", "GDP", "UNRATE")
    • limitinteger | nullMaximum observations per page; omitted = curated default (25)
  • get_futures2 params

    Get a futures contract's current quote, provider-routed (Yahoo, keyless).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredFutures contract symbol (e.g. "ESM26" for E-mini S&P June 2026)
  • get_grading_actions4 params

    Get provider-routed analyst upgrades and downgrades for a symbol.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol
  • get_holders5 params

    Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • holder_typestringrequiredHolder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster
    • limitinteger | nullMaximum entries per page for holder types with a list (institutional, mutualfund, insider-transactions, insider-roster); omitted = curated default (25). No-op f
    • symbolstringrequiredStock ticker symbol
  • get_index_constituent_changes4 params

    Get additions and removals from an index's constituent list.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • symbolstringrequiredIndex symbol (e.g. ^GSPC)
  • get_index_constituents2 params

    Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredIndex symbol (e.g. "^GSPC" for the S&P 500; Wikipedia-backed, S&P 500 only)
  • get_indicators6 params

    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 plus per-symbol errors.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • intervalstringrequiredCandle interval: 1d|1wk|1mo (default: 1d)
    • limitinteger | nullMaximum symbols per page (only applies when multiple symbols given); omitted = curated default (25)
    • rangestringrequiredTime range: 1mo|3mo|6mo|1y|2y|5y (default: 1y)
    • symbolsstringrequiredOne or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOG")
  • get_indices2 params

    Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • regionstringrequiredRegion: americas|europe|asia-pacific|middle-east-africa|currencies (default: all)
  • get_industry3 params

    Get comprehensive industry data (overview, performance, top companies) for a specific industry slug.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • industrystringrequiredIndustry slug (e.g., semiconductors, biotechnology, banks-diversified)
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
  • get_key_metrics_ttm2 params

    Get trailing-twelve-month key metrics for a symbol.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default
    • symbolstringrequiredStock ticker symbol
  • get_market_calendar4 params

    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.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • fromstring | nullStart date (YYYY-MM-DD); ignored by market-holiday/market-status
    • kindstringrequiredWhich market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status
    • tostring | nullEnd date (YYYY-MM-DD); ignored by market-holiday/market-status
  • get_market_hours2 params

    Get current market hours and open/closed status for a region.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • regionstringrequiredRegion code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)
  • get_market_summary3 params

    Get market overview with major indices and currencies for a region.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • regionstringrequiredRegion code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)
  • get_news5 params

    Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • limitinteger | nullMaximum articles per page; omitted = curated default (25)
    • symbolstring | nullStock ticker symbol (optional; omit for general market news)
  • get_options5 params

    Get the options chain for a symbol. Provide an expiration timestamp to get a specific expiry, or omit for the nearest expiration.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page
    • expirationinteger | nullExpiration date as Unix timestamp in seconds (optional; defaults to nearest expiration)
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • limitinteger | nullMaximum contracts per side (calls/puts) per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol
  • get_press_releases3 params

    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.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum number of releases to return (default: 10)
    • symbolstringrequiredStock ticker symbol
  • get_price_target_consensus2 params

    Get a stock's consensus analyst price target (high/low/mean/median).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredStock ticker symbol
  • get_price_target_summary2 params

    Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default
    • symbolstringrequiredStock ticker symbol
  • get_protocol_tvl2 params

    Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • idstringrequiredCoinGecko coin id (e.g. aave)
  • get_protocol_tvl_history4 params

    Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless).

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • idstringrequiredCoinGecko coin id (e.g. aave)
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
  • get_quote5 params

    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 per-symbol errors.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • limitinteger | nullMaximum symbols per page; omitted = curated default (25)
    • symbolsstringrequiredComma-separated list of ticker symbols (e.g., "AAPL,MSFT,GOOG")
  • get_rating_consensus2 params

    Get a stock's consensus analyst rating rollup (strong buy/buy/hold/sell/strong sell counts and a headline consensus label).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredStock ticker symbol
  • get_ratios_ttm2 params

    Get trailing-twelve-month financial ratios for a symbol.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default
    • symbolstringrequiredStock ticker symbol
  • get_recommendations3 params

    Get similar stock recommendations and analyst ratings for a symbol.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum number of recommendations to return (default: 5)
    • symbolstringrequiredStock ticker symbol
  • get_risk5 params

    Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol.

    Show parameters
    • benchmarkstring | nullBenchmark symbol for beta calculation (e.g., "SPY")
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • intervalstringrequiredCandle interval: 1d|1wk (default: 1d)
    • rangestringrequiredTime range: 1y|2y|5y (default: 1y)
    • symbolstringrequiredStock ticker symbol
  • get_risk_factors2 params

    Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredStock ticker symbol
  • get_sector3 params

    Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • sectorstringrequiredSector slug: technology|financial-services|consumer-cyclical|communication-services| healthcare|industrials|consumer-defensive|energy|basic-materials|real-estat
  • get_sector_pe1 param

    Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
  • get_sector_performance1 param

    Get aggregate performance for every market sector, provider-routed (Yahoo screener fan-out, keyless). Distinct from get_sector (per-sector Yahoo-only shortcut).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
  • get_sector_performance_history2 params

    Get sector performance per session, most recent first.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullSessions to return; omitted = 30
  • get_short_volume4 params

    Get daily FINRA short-sale volume for a symbol (keyless).

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default
    • limitinteger | nullMaximum entries per page; omitted = curated default (25)
    • symbolstringrequiredStock ticker symbol
  • get_spark4 params

    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.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • intervalstringrequiredCandle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)
    • rangestringrequiredTime range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)
    • symbolsstringrequiredComma-separated list of ticker symbols (e.g., "AAPL,MSFT,GOOG")
  • get_splits3 params

    Get historical stock split history for a symbol.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • rangestringrequiredTime range: 1y|2y|5y|10y|max (default: max)
    • symbolstringrequiredStock ticker symbol
  • get_symbol_details2 params

    Get reference detail for one symbol (name, exchange, SIC code, employees, list date).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • symbolstringrequiredStock ticker symbol
  • get_transcripts6 params

    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.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • limitinteger | nullMaximum number of transcripts to return (default: all)
    • paragraph_cursorstring | nullOpaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page
    • paragraph_limitinteger | nullMaximum transcript paragraphs per page; omitted = curated default (25). A full call's `text` is returned as paginated paragraphs, not one giant blob
    • symbolstringrequiredStock ticker symbol
  • get_treasury_auctions9 params

    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 API key required.

    Show parameters
    • countinteger | nullTotal auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • fromstring | nullEarliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true
    • limitinteger | nullMaximum rows per page; omitted = curated default (25)
    • security_termstring | nullSecurity term filter as Treasury spells it (e.g. "13-Week"); ignored when `upcoming` is true
    • security_typestring | nullSecurity class filter ("Bill", "Note", "Bond"); ignored when `upcoming` is true
    • tostring | nullLatest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true
    • upcomingboolean | nullReturn the not-yet-held auction schedule instead of auction records
  • get_treasury_yields4 params

    Get US Treasury yield curve data (1m through 30y) for a given year. No API key required.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = all fields
    • limitinteger | nullMaximum rows per page; omitted = curated default (25)
    • yearinteger | nullYear to fetch yield curve data for (default: current year)
  • get_trending2 params

    Get currently trending stock tickers for a region.

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • regionstringrequiredRegion code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)
  • lookup5 params

    Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency).

    Show parameters
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • logoboolean | nullInclude logo URLs (requires an additional upstream API call); default: false
    • querystringrequiredSearch query (company name or ticker symbol)
    • query_typestringrequiredFilter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all)
  • screener3 params

    Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks).

    Show parameters
    • countinteger | nullNumber of results to return (default: 25, max: 250)
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • screener_typestringrequiredScreener type: most-actives | day-gainers | day-losers | growth-technology-stocks | undervalued-growth-stocks | undervalued-large-caps | aggressive-small-caps |
  • search5 params

    Search for stocks, ETFs, and companies by name or ticker symbol.

    Show parameters
    • cursorstring | nullOpaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
    • fieldsstring | nullComma-separated list of GraphQL field names to include; omitted = curated default set
    • langstring | nullTarget language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
    • limitinteger | nullMaximum quotes per page; omitted = curated default (25)
    • querystringrequiredSearch query string (company name or ticker symbol)

Checked by Serverdex with a plain initialize + tools/list call to finance-query.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 19, 2026
Stars
51
Forks
13
Last push
Nov 19, 2026
License
MIT

Rustalternative-databacktestingfinancemarket-datapythonruststock-datatechnical-analysis

From the README

Finance Query Rust library, CLI, and HTTP server for querying financial data. Hosted API Free hosted version at finance-query.com: What's in This Repository • Library (finance-query) - Core logic • Server (finance-query-server) - HTTP REST API, WebSocket, and GraphQL server • MCP Server (finance-query-mcp) - 36 MCP tools for AI agents (Claude, Cursor, Windsurf, etc.) • Derive Macros (finance-query-derive) - Procedural macros for Polars DataFrame integration Quick Start Library Add to your Cargo.toml: Single symbol: Batch operations: SEC EDGAR filings: CLI fq (the command-line tool) lives in its own repository: Verdenroz/fq-cli. Quick examples: See Verdenroz/fq-cli for full documentation. Server Run the server locally (requires Rust): Or run the full stack with Docker Compose: The v2 server provides REST endpoints at /v2/* and WebSocket streaming at /v2/stream. Documentation Package guides: • CLI - Command-line tool with examples, installation, and features • Server - REST API, WebSocket, and GraphQL server setup and endpoints • MCP Server - AI agent integration (36 tools, hosted at finance-query.com/mcp) • Derive Macros - Procedural macros for Polars DataFrame support Full documentation at verdenroz.github.io/finance-query: • Library Getting Started • Ticker API - Single symbol operations • Tickers API - Batch operations • EDGAR API - SEC filings • Finance Module - Market-wide data • REST API Reference • WebSocket API • GraphQL API Reference • MCP Tools Reference…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://finance-query.com/mcp

Alternatives to FinanceQuery

Best Finance servers →

The most-starred Finance servers in the index, with their live-check result.

ServerStarsLast pushLive check
CCXT44,881Nov 2026Local / not checked
QR Rápido7,477Nov 2026Needs sign-in
Finance Toolkit5,522Nov 2026Needs sign-in
AKQuant2,607Nov 2026Local / not checked
com.stripe MCP2,072Nov 2026Needs sign-in

FinanceQuery: questions people ask

Is FinanceQuery a remote or a local MCP server?
According to its entry in the official MCP registry, FinanceQuery ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does FinanceQuery need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 19, 2026. Individual tools may still ask for a key when called.
Is FinanceQuery still maintained?
Active: the repository's last commit today. Last push Nov 19, 2026, 51 GitHub stars, MIT licence. Read from GitHub on Nov 19, 2026.
What tools does FinanceQuery expose?
64 tools as listed by the server itself during the live check, including get_analysis, get_calendar, get_chart, get_commodity, get_company_profile. The full list with parameters is in the Live check section above.
How do I add FinanceQuery to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Finance →

Add the badge to your site

Show visitors that FinanceQuery is listed here — it’s also the link we check for a free listing.

FinanceQuery — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-verdenroz-finance-query?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="FinanceQuery — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![FinanceQuery — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-verdenroz-finance-query?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.