# FinanceQuery

> FinanceQuery is an open-source MCP server for finance and payments. Hosted MCP server giving AI agents stock quotes, filings, options and macro data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Self-hosted, Web, VS Code
- **Website:** https://finance-query.com
- **Repository:** https://github.com/verdenroz/finance-query/tree/HEAD/finance-query-mcp
- **MCP Registry name:** io.github.Verdenroz/finance-query
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [financial data](https://ai-powered.com/categories/financial-data)
- **Listing updated:** 2026-11-19

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://finance-query.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "finance-query": {
      "url": "https://finance-query.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

All 64 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `get_analysis` (says read-only): Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.
- `get_calendar` (says 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_chart` (says 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_commodity` (says read-only): Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless).
- `get_company_profile` (says read-only): Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization).
- `get_congressional_trades` (says read-only): Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise.
- `get_crypto` (says read-only): Get top cryptocurrency coins by market cap from CoinGecko (no API key required).
- `get_crypto_news` (says read-only): Get market-wide crypto news (currently FMP only, requires FMP_API_KEY).
- `get_dividends` (says 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_surprises` (says read-only): Get a stock's earnings-surprise history (actual vs. estimated EPS).
- `get_earnings_transcript` (says 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_facts` (says read-only): Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var.
- `get_edgar_search` (says read-only): Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var.
- `get_edgar_submissions` (says read-only): Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var.
- `get_etf_profile` (says read-only): Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings).
- `get_executive_compensation` (says read-only): Get disclosed executive compensation by year for a symbol.
- `get_fails_to_deliver` (says read-only): Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise.
- `get_fear_and_greed` (says read-only): Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100).
- `get_feeds` (says read-only): Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.).
- `get_filing_sections` (says 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_financials` (says 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_forex` (says read-only): Get a currency pair's current exchange rate, provider-routed (Capability::FOREX).
- `get_forex_news` (says read-only): Get market-wide forex news (currently FMP only, requires FMP_API_KEY).
- `get_fred_series` (says read-only): Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var.
- `get_futures` (says read-only): Get a futures contract's current quote, provider-routed (Yahoo, keyless).
- `get_grading_actions` (says read-only): Get provider-routed analyst upgrades and downgrades for a symbol.
- `get_holders` (says read-only): Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity.
- `get_index_constituent_changes` (says read-only): Get additions and removals from an index's constituent list.
- `get_index_constituents` (says read-only): Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only).
- `get_indicators` (says 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_indices` (says read-only): Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region.
- `get_industry` (says read-only): Get comprehensive industry data (overview, performance, top companies) for a specific industry slug.
- `get_key_metrics_ttm` (says read-only): Get trailing-twelve-month key metrics for a symbol.
- `get_market_calendar` (says 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_hours` (says read-only): Get current market hours and open/closed status for a region.
- `get_market_summary` (says read-only): Get market overview with major indices and currencies for a region.
- `get_news` (says read-only): Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news.
- `get_options` (says 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_releases` (says 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_consensus` (says read-only): Get a stock's consensus analyst price target (high/low/mean/median).
- `get_price_target_summary` (says read-only): Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY).
- `get_protocol_tvl` (says read-only): Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless).
- `get_protocol_tvl_history` (says read-only): Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless).
- `get_quote` (says 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_consensus` (says 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_ttm` (says read-only): Get trailing-twelve-month financial ratios for a symbol.
- `get_recommendations` (says read-only): Get similar stock recommendations and analyst ratings for a symbol.
- `get_risk` (says read-only): Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol.
- `get_risk_factors` (says read-only): Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.
- `get_sector` (says read-only): Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors.
- `get_sector_pe` (says read-only): Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless).
- `get_sector_performance` (says 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_history` (says read-only): Get sector performance per session, most recent first.
- `get_short_volume` (says read-only): Get daily FINRA short-sale volume for a symbol (keyless).
- `get_spark` (says 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_splits` (says read-only): Get historical stock split history for a symbol.
- `get_symbol_details` (says read-only): Get reference detail for one symbol (name, exchange, SIC code, employees, list date).
- `get_transcripts` (says 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_auctions` (says 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_yields` (says read-only): Get US Treasury yield curve data (1m through 30y) for a given year. No API key required.
- `get_trending` (says read-only): Get currently trending stock tickers for a region.
- `lookup` (says read-only): Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency).
- `screener` (says read-only): Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks).
- `search` (says read-only): Search for stocks, ETFs, and companies by name or ticker symbol.

## 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.

## Alternatives

- [Finance: Stock, ETF & Crypto Data](https://ai-powered.com/mcp/finance-stock-etf-and-crypto-data): Finance: Stock, ETF & Crypto Data is a paid MCP server for finance and payments.
- [Finance & Filings Data](https://ai-powered.com/mcp/finance-and-filings-data): Finance & Filings Data is a freemium MCP server for finance and payments.
- [Market Pi-Rates](https://ai-powered.com/mcp/market-pi-rates): Market Pi-Rates is a freemium MCP server for finance and payments.
- [SEC EDGAR (sec-api.dev)](https://ai-powered.com/mcp/sec-edgar-sec-api-dev): SEC EDGAR (sec-api.dev) is a freemium MCP server for legal and government.
- [US Company Financials (SEC XBRL) MCP](https://ai-powered.com/mcp/us-company-financials-sec-xbrl-mcp): US Company Financials (SEC XBRL) MCP is a freemium MCP server for finance and payments.
- [Real-Time Market Quotes, News & Social Sentiment MCP](https://ai-powered.com/mcp/real-time-market-quotes-news-and-social-sentiment-mcp): Real-Time Market Quotes, News & Social Sentiment MCP is a freemium MCP server for finance and payments.
- [Finance Fintech Mcp](https://ai-powered.com/mcp/finance-fintech-mcp): Finance Fintech Mcp is a freemium MCP server for finance and payments.
- [stocks-llm](https://ai-powered.com/mcp/stocks-llm): stocks-llm is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/financequery
