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.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://finance-query.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"finance-query": {
"url": "https://finance-query.com/mcp"
}
}
}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/mcpEnter a Name (for example "FinanceQuery"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
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.
