Skip to content
MCP server

FinanceQuery

Hosted MCP server giving AI agents stock quotes, filings, options and macro data

Answered our latest tool-list check 6 hours ago with 64 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Open source
Platforms
API, CLI, Self-hosted
Runs
Remotely
Version
3.4.0
Listing updated
1 day ago

Similar MCP servers

About FinanceQuery

FinanceQuery is an open-source MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

The README describes FinanceQuery's MCP server as a bridge between AI clients and finance-query's market data library. Once connected, an agent can pull live quotes, OHLCV charts, financial statements, options chains, dividend history and 42 technical indicators through named tools rather than scraping pages itself.

The tool set reaches beyond equities. It includes SEC EDGAR lookups for XBRL facts, filing history and full-text search, FRED economic series, US Treasury yield curves, CoinGecko crypto rankings, the CNN Fear & Greed Index and a set of news and RSS feeds. A risk tool reports VaR, Sharpe, Sortino and drawdown figures, and a backtesting tool runs a few prebuilt strategies when the server is built with that feature.

The hosted endpoint at finance-query.com/mcp needs no installation or API key, and the README lists setup steps for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Continue and Zed. Self-hosting over Docker or from source is also documented, in which case EDGAR and FRED features depend on the user supplying an email address and a free FRED key.

Install

Run in a terminal

claude mcp add --transport http finance-query https://finance-query.com/mcp

Add to Settings → Connectors → Add custom connector

https://finance-query.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "finance-query": {
      "url": "https://finance-query.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "finance-query": {
      "type": "http",
      "url": "https://finance-query.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "finance-query": {
      "serverUrl": "https://finance-query.com/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://finance-query.com/mcp

Enter a Name (for example "FinanceQuery"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "finance-query": {
      "type": "http",
      "url": "https://finance-query.com/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (64)

Read directly from the server.

All 64 tools say they're read-only.

From the server's own tool annotations; not verified by us.

get_analysisSays read-only
Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.
get_calendarSays read-only
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.
get_chartSays read-only
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).
get_commoditySays read-only
Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless).
get_company_profileSays read-only
Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization).
get_congressional_tradesSays read-only
Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise.
get_cryptoSays read-only
Get top cryptocurrency coins by market cap from CoinGecko (no API key required).
get_crypto_newsSays read-only
Get market-wide crypto news (currently FMP only, requires FMP_API_KEY).
get_dividendsSays read-only
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).
get_earnings_surprisesSays read-only
Get a stock's earnings-surprise history (actual vs. estimated EPS).
get_earnings_transcriptSays read-only
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_factsSays read-only
Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var.
get_edgar_searchSays read-only
Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var.
get_edgar_submissionsSays read-only
Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var.
get_etf_profileSays read-only
Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings).
get_executive_compensationSays read-only
Get disclosed executive compensation by year for a symbol.
get_fails_to_deliverSays read-only
Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise.
get_fear_and_greedSays read-only
Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100).
get_feedsSays read-only
Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.).
get_filing_sectionsSays read-only
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_financialsSays read-only
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_forexSays read-only
Get a currency pair's current exchange rate, provider-routed (Capability::FOREX).
get_forex_newsSays read-only
Get market-wide forex news (currently FMP only, requires FMP_API_KEY).
get_fred_seriesSays read-only
Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var.
get_futuresSays read-only
Get a futures contract's current quote, provider-routed (Yahoo, keyless).
get_grading_actionsSays read-only
Get provider-routed analyst upgrades and downgrades for a symbol.
get_holdersSays read-only
Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity.
get_index_constituent_changesSays read-only
Get additions and removals from an index's constituent list.
get_index_constituentsSays read-only
Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only).
get_indicatorsSays read-only
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.
get_indicesSays read-only
Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region.
get_industrySays read-only
Get comprehensive industry data (overview, performance, top companies) for a specific industry slug.
get_key_metrics_ttmSays read-only
Get trailing-twelve-month key metrics for a symbol.
get_market_calendarSays read-only
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_hoursSays read-only
Get current market hours and open/closed status for a region.
get_market_summarySays read-only
Get market overview with major indices and currencies for a region.
get_newsSays read-only
Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news.
get_optionsSays read-only
Get the options chain for a symbol. Provide an expiration timestamp to get a specific expiry, or omit for the nearest expiration.
get_press_releasesSays read-only
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_consensusSays read-only
Get a stock's consensus analyst price target (high/low/mean/median).
get_price_target_summarySays read-only
Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY).
get_protocol_tvlSays read-only
Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless).
get_protocol_tvl_historySays read-only
Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless).
get_quoteSays read-only
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.
get_rating_consensusSays read-only
Get a stock's consensus analyst rating rollup (strong buy/buy/hold/sell/strong sell counts and a headline consensus label).
get_ratios_ttmSays read-only
Get trailing-twelve-month financial ratios for a symbol.
get_recommendationsSays read-only
Get similar stock recommendations and analyst ratings for a symbol.
get_riskSays read-only
Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol.
get_risk_factorsSays read-only
Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.
get_sectorSays read-only
Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors.
get_sector_peSays read-only
Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless).
get_sector_performanceSays read-only
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_historySays read-only
Get sector performance per session, most recent first.
get_short_volumeSays read-only
Get daily FINRA short-sale volume for a symbol (keyless).
get_sparkSays read-only
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_splitsSays read-only
Get historical stock split history for a symbol.
get_symbol_detailsSays read-only
Get reference detail for one symbol (name, exchange, SIC code, employees, list date).
get_transcriptsSays read-only
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_auctionsSays read-only
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.
get_treasury_yieldsSays read-only
Get US Treasury yield curve data (1m through 30y) for a given year. No API key required.
get_trendingSays read-only
Get currently trending stock tickers for a region.
lookupSays read-only
Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency).
screenerSays read-only
Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks).
searchSays read-only
Search for stocks, ETFs, and companies by name or ticker symbol.

What it does

Live quotes and charts
Retrieves current quotes, batch quotes, historical OHLCV candles and lightweight sparklines for symbols.
Fundamentals and analyst data
Provides income statements, balance sheets, cash flow, holder breakdowns and analyst ratings and estimates.
Technical indicators
Computes 42 indicators such as SMA, EMA, RSI, MACD, Bollinger Bands and Ichimoku for a symbol.
SEC EDGAR access
Exposes XBRL company facts, filing history and full-text search across SEC filings.
Macro and rates data
Offers FRED time series and the US Treasury yield curve from one-month to thirty-year maturities.
Hosted without an API key
The hosted instance at finance-query.com/mcp is preconfigured, so clients connect with a URL alone.

Good for

  • Asking an AI assistant to compare fundamentals and analyst ratings across several tickers
  • Pulling SEC filings or XBRL figures while researching a public company
  • Checking the Treasury yield curve or FRED series alongside equity data
  • Running a quick risk summary such as VaR and drawdown on a holding
  • Building a research agent that combines prices, news and macro indicators

Pricing

Open source

Open-source server; a hosted instance is available with no fee stated in the content.

Prices change. Check finance-query.com before you buy.

FinanceQuery FAQ

Do I need an API key to use the hosted server?

No. The README says the hosted instance at finance-query.com/mcp runs with the EDGAR and FRED keys preconfigured, so you only add the URL to your client.

Which AI clients are supported?

The README lists Claude Code, Claude Desktop, Cursor, Windsurf, VS Code with GitHub Copilot, Continue and Zed, and says it works with other MCP-compatible agents.

Which tools need extra configuration when self-hosting?

According to the README, the get_edgar_* tools need a contact email set as EDGAR_EMAIL, and get_fred_series needs a FRED_API_KEY. get_treasury_yields is keyless.

Can I run it locally instead of using the hosted version?

Yes. The README documents stdio and HTTP transports, a Docker image, and building from source with cargo.

Is FinanceQuery free?

Yes. FinanceQuery is open source, so you can use and self-host it for free.

How do I add FinanceQuery to Claude Code?

Run this command in your terminal: claude mcp add --transport http finance-query https://finance-query.com/mcp

What are the best alternatives to FinanceQuery?

The closest alternatives to FinanceQuery are Finance: Stock, ETF & Crypto Data, Finance & Filings Data, Market Pi-Rates, SEC EDGAR (sec-api.dev) and US Company Financials (SEC XBRL) MCP.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 20 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers