# FinanceQuery (remote · finance-query.com)

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

- Trust score: 72/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `finance-query.com`: 72/100 (this document), [markdown](https://verifymcp.io/servers/verdenroz-finance-query/finance-query.md), [page](https://verifymcp.io/servers/verdenroz-finance-query/finance-query)

## Channel facts

- Endpoint: `https://finance-query.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `3.4.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 77/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 7918 tokens (~123/item across 64 items; 64 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 64 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 64 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the FinanceQuery MCP server?

FinanceQuery is a hosted endpoint at https://finance-query.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http verdenroz-finance-query 'https://finance-query.com/mcp'
```

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.verdenroz-finance-query]
url = "https://finance-query.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "verdenroz-finance-query": {
      "type": "remote",
      "url": "https://finance-query.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add verdenroz-finance-query --url 'https://finance-query.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  verdenroz-finance-query:
    url: "https://finance-query.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "verdenroz-finance-query": {
      "Transport": "http",
      "Url": "https://finance-query.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add verdenroz-finance-query -t streamable-http -u 'https://finance-query.com/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 72, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-19 (score 71)

First indexed and scored.

## MCP tools (64)

### `get_analysis` (~91 tokens)

Analyst Data

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

Input parameters:

- `analysis_type` (string, required): Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `symbol` (string, required): Stock ticker symbol

### `get_calendar` (~166 tokens)

Upcoming Events for Symbols

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.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `range` (string, required): Forward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)
- `symbols` (string, required): Comma-separated list of ticker symbols (e.g., "AAPL,MSFT,TSLA")

### `get_chart` (~310 tokens)

Price Chart (OHLCV)

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `end` (integer|null): End date as Unix timestamp (seconds). Defaults to now when `start` is set.
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `interval` (string, required): Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)
- `limit` (integer|null): Maximum candles per page; omitted = curated default (25)
- `range` (string, required): Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set.
- `start` (integer|null): Start date as Unix timestamp (seconds). When provided, overrides `range`.
- `symbols` (string, required): One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOG")

### `get_commodity` (~86 tokens)

Commodity Quote

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Commodity symbol (e.g. "GCUSD" for gold, "CLUSD" for crude oil)

### `get_company_profile` (~71 tokens)

Company Profile

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Stock ticker symbol

### `get_congressional_trades` (~118 tokens)

Congressional Trades

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol

### `get_crypto` (~134 tokens)

Top Cryptocurrencies

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

Input parameters:

- `count` (integer|null): Number of top coins to return (default: 50, max: 250)
- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum coins per page; omitted = curated default (25)
- `vs_currency` (string|null): Quote currency (default: usd)

### `get_crypto_news` (~115 tokens)

Crypto News

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

Input parameters:

- `count` (integer|null): Overall cap on articles fetched (default: 20)
- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `limit` (integer|null): Maximum articles per page; omitted = curated default (25)

### `get_dividends` (~193 tokens)

Dividend History

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `limit` (integer|null): Maximum dividend payments per page; omitted = curated default (25)
- `range` (string, required): Time range: 1y|2y|5y|10y|max (default: max)
- `symbols` (string, required): One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,KO,JNJ")

### `get_earnings_surprises` (~61 tokens)

Earnings Surprises

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Stock ticker symbol

### `get_earnings_transcript` (~135 tokens)

Earnings Call 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).

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `quarter` (string, required): Fiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers with no "latest" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted
- `symbol` (string, required): Stock ticker symbol
- `year` (integer|null): Fiscal year. See `quarter`

### `get_edgar_facts` (~221 tokens)

SEC EDGAR XBRL Facts

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

Input parameters:

- `concepts` (string|null): Comma-separated XBRL concept names to filter to (e.g. "Revenues,Assets"); omitted = curated defaults (headline financials)
- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated GraphQL sub-fields to include per concept (e.g. "concept,dataPoints"); omitted = curated default set
- `limit` (integer|null): Maximum data points per concept per page; omitted = curated default (25). Applied uniformly across every returned concept.
- `symbol` (string, required): Stock ticker symbol (e.g., "AAPL", "MSFT", "TSLA")
- `taxonomy` (string|null): XBRL taxonomy (default: "us-gaap"); also try "ifrs-full" or "dei"

### `get_edgar_search` (~146 tokens)

SEC EDGAR Full-Text Search

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

Input parameters:

- `end_date` (string|null): End date filter in YYYY-MM-DD format
- `forms` (string|null): Comma-separated form types to filter (e.g., "10-K,10-Q,8-K")
- `from` (integer|null): Pagination offset; omitted = 0 (first page)
- `query` (string, required): Search query (keywords in filing text)
- `size` (integer|null): Page size; omitted = 100, max 100
- `start_date` (string|null): Start date filter in YYYY-MM-DD format

### `get_edgar_submissions` (~133 tokens)

SEC EDGAR Filing History

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum filings per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol (e.g., "AAPL", "MSFT", "TSLA")

### `get_etf_profile` (~67 tokens)

ETF Profile and Holdings

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): ETF ticker symbol

### `get_executive_compensation` (~102 tokens)

Executive Compensation

Get disclosed executive compensation by year for a symbol.

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol

### `get_fails_to_deliver` (~119 tokens)

Fails-to-Deliver Records

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol

### `get_fear_and_greed` (~60 tokens)

Fear & Greed Index

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set

### `get_feeds` (~223 tokens)

Financial News Feeds

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `sources` (string|null): Comma-separated feed sources: federal-reserve|sec|marketwatch|cnbc|bloomberg|ft|nyt| guardian|investing|bea|ecb|cfpb|wsj|fortune|businesswire|coindesk|cointelegraph| techcrunch|hackernews|oilprice|ca…

### `get_filing_sections` (~126 tokens)

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

Input parameters:

- `accession_number` (string, required): SEC accession number, e.g. "0000320193-24-000123"
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `form` (string, required): Which filing form to fetch sectioned text for: ten-k | eight-k
- `symbol` (string, required): Stock ticker symbol

### `get_financials` (~164 tokens)

Financial Statements

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.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `frequency` (string, required): Reporting frequency: annual | quarterly (default: annual)
- `metrics` (string|null): Comma-separated list of line-item metrics to filter to; omitted = all reported metrics
- `statement` (string, required): Statement type: income | balance | cashflow
- `symbols` (string, required): One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOGL")

### `get_forex` (~83 tokens)

Exchange Rate

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `from` (string, required): Base currency code (e.g. "USD")
- `to` (string, required): Quote currency code (e.g. "EUR")

### `get_forex_news` (~116 tokens)

Forex News

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

Input parameters:

- `count` (integer|null): Overall cap on articles fetched (default: 20)
- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `limit` (integer|null): Maximum articles per page; omitted = curated default (25)

### `get_fred_series` (~177 tokens)

FRED Economic Series

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

Input parameters:

- `as_of` (string|null): Vintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest
- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `id` (string, required): FRED series ID (e.g., "FEDFUNDS", "CPIAUCSL", "GDP", "UNRATE")
- `limit` (integer|null): Maximum observations per page; omitted = curated default (25)

### `get_futures` (~78 tokens)

Futures Quote

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Futures contract symbol (e.g. "ESM26" for E-mini S&P June 2026)

### `get_grading_actions` (~104 tokens)

Analyst Upgrades and Downgrades

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol

### `get_holders` (~173 tokens)

Ownership and Insider Activity

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `holder_type` (string, required): Holder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster
- `limit` (integer|null): Maximum entries per page for holder types with a list (institutional, mutualfund, insider-transactions, insider-roster); omitted = curated default (25). No-op for major/insider-purchases (no list).
- `symbol` (string, required): Stock ticker symbol

### `get_index_constituent_changes` (~111 tokens)

Index Constituent Changes

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `symbol` (string, required): Index symbol (e.g. ^GSPC)

### `get_index_constituents` (~88 tokens)

Index Constituents

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Index symbol (e.g. "^GSPC" for the S&P 500; Wikipedia-backed, S&P 500 only)

### `get_indicators` (~236 tokens)

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `interval` (string, required): Candle interval: 1d|1wk|1mo (default: 1d)
- `limit` (integer|null): Maximum symbols per page (only applies when multiple symbols given); omitted = curated default (25)
- `range` (string, required): Time range: 1mo|3mo|6mo|1y|2y|5y (default: 1y)
- `symbols` (string, required): One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOG")

### `get_indices` (~86 tokens)

World Market Indices

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `region` (string, required): Region: americas|europe|asia-pacific|middle-east-africa|currencies (default: all)

### `get_industry` (~112 tokens)

Industry Overview

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `industry` (string, required): Industry slug (e.g., semiconductors, biotechnology, banks-diversified)
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation

### `get_key_metrics_ttm` (~56 tokens)

Key Metrics (TTM)

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default
- `symbol` (string, required): Stock ticker symbol

### `get_market_calendar` (~156 tokens)

Market-Wide Event 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.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `from` (string|null): Start date (YYYY-MM-DD); ignored by market-holiday/market-status
- `kind` (string, required): Which market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status
- `to` (string|null): End date (YYYY-MM-DD); ignored by market-holiday/market-status

### `get_market_hours` (~83 tokens)

Market Hours

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `region` (string, required): Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)

### `get_market_summary` (~120 tokens)

Market Summary

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `region` (string, required): Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)

### `get_news` (~157 tokens)

Stock and Market News

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `limit` (integer|null): Maximum articles per page; omitted = curated default (25)
- `symbol` (string|null): Stock ticker symbol (optional; omit for general market news)

### `get_options` (~153 tokens)

Options Chain

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page
- `expiration` (integer|null): Expiration date as Unix timestamp in seconds (optional; defaults to nearest expiration)
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `limit` (integer|null): Maximum contracts per side (calls/puts) per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol

### `get_press_releases` (~99 tokens)

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum number of releases to return (default: 10)
- `symbol` (string, required): Stock ticker symbol

### `get_price_target_consensus` (~62 tokens)

Price Target Consensus

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Stock ticker symbol

### `get_price_target_summary` (~64 tokens)

Price Target Summary

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default
- `symbol` (string, required): Stock ticker symbol

### `get_protocol_tvl` (~74 tokens)

DeFi Protocol TVL

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `id` (string, required): CoinGecko coin id (e.g. aave)

### `get_protocol_tvl_history` (~120 tokens)

DeFi Protocol TVL History

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `id` (string, required): CoinGecko coin id (e.g. aave)
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)

### `get_quote` (~197 tokens)

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `limit` (integer|null): Maximum symbols per page; omitted = curated default (25)
- `symbols` (string, required): Comma-separated list of ticker symbols (e.g., "AAPL,MSFT,GOOG")

### `get_rating_consensus` (~72 tokens)

Analyst Rating Consensus

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Stock ticker symbol

### `get_ratios_ttm` (~56 tokens)

Financial Ratios (TTM)

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default
- `symbol` (string, required): Stock ticker symbol

### `get_recommendations` (~74 tokens)

Similar Stocks

Get similar stock recommendations and analyst ratings for a symbol.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum number of recommendations to return (default: 5)
- `symbol` (string, required): Stock ticker symbol

### `get_risk` (~142 tokens)

Risk Analytics

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

Input parameters:

- `benchmark` (string|null): Benchmark symbol for beta calculation (e.g., "SPY")
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `interval` (string, required): Candle interval: 1d|1wk (default: 1d)
- `range` (string, required): Time range: 1y|2y|5y (default: 1y)
- `symbol` (string, required): Stock ticker symbol

### `get_risk_factors` (~72 tokens)

Filing Risk Factors

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Stock ticker symbol

### `get_sector` (~138 tokens)

Sector Overview

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `sector` (string, required): Sector slug: technology|financial-services|consumer-cyclical|communication-services| healthcare|industrials|consumer-defensive|energy|basic-materials|real-estate|utilities

### `get_sector_pe` (~56 tokens)

Sector P/E Ratios

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields

### `get_sector_performance` (~67 tokens)

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields

### `get_sector_performance_history` (~61 tokens)

Sector Performance History

Get sector performance per session, most recent first.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Sessions to return; omitted = 30

### `get_short_volume` (~103 tokens)

Short-Sale Volume

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default
- `limit` (integer|null): Maximum entries per page; omitted = curated default (25)
- `symbol` (string, required): Stock ticker symbol

### `get_spark` (~183 tokens)

Price Sparklines

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.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `interval` (string, required): Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)
- `range` (string, required): Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)
- `symbols` (string, required): Comma-separated list of ticker symbols (e.g., "AAPL,MSFT,GOOG")

### `get_splits` (~80 tokens)

Stock Split History

Get historical stock split history for a symbol.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `range` (string, required): Time range: 1y|2y|5y|10y|max (default: max)
- `symbol` (string, required): Stock ticker symbol

### `get_symbol_details` (~62 tokens)

Symbol Reference Details

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `symbol` (string, required): Stock ticker symbol

### `get_transcripts` (~210 tokens)

Earnings Call 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.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `limit` (integer|null): Maximum number of transcripts to return (default: all)
- `paragraph_cursor` (string|null): Opaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page
- `paragraph_limit` (integer|null): Maximum transcript paragraphs per page; omitted = curated default (25). A full call's `text` is returned as paginated paragraphs, not one giant blob
- `symbol` (string, required): Stock ticker symbol

### `get_treasury_auctions` (~303 tokens)

Treasury Auction Results

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.

Input parameters:

- `count` (integer|null): Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them
- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `from` (string|null): Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true
- `limit` (integer|null): Maximum rows per page; omitted = curated default (25)
- `security_term` (string|null): Security term filter as Treasury spells it (e.g. "13-Week"); ignored when `upcoming` is true
- `security_type` (string|null): Security class filter ("Bill", "Note", "Bond"); ignored when `upcoming` is true
- `to` (string|null): Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true
- `upcoming` (boolean|null): Return the not-yet-held auction schedule instead of auction records

### `get_treasury_yields` (~126 tokens)

Treasury Yield Curve

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = all fields
- `limit` (integer|null): Maximum rows per page; omitted = curated default (25)
- `year` (integer|null): Year to fetch yield curve data for (default: current year)

### `get_trending` (~81 tokens)

Trending Tickers

Get currently trending stock tickers for a region.

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `region` (string, required): Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)

### `lookup` (~162 tokens)

Ticker Lookup by Type

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

Input parameters:

- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `logo` (boolean|null): Include logo URLs (requires an additional upstream API call); default: false
- `query` (string, required): Search query (company name or ticker symbol)
- `query_type` (string, required): Filter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all)

### `screener` (~179 tokens)

Stock Screener

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

Input parameters:

- `count` (integer|null): Number of results to return (default: 25, max: 250)
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `screener_type` (string, required): Screener type: most-actives | day-gainers | day-losers | growth-technology-stocks | undervalued-growth-stocks | undervalued-large-caps | aggressive-small-caps | small-cap-gainers | most-shorted-stock…

### `search` (~145 tokens)

Symbol Search

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

Input parameters:

- `cursor` (string|null): Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page
- `fields` (string|null): Comma-separated list of GraphQL field names to include; omitted = curated default set
- `lang` (string|null): Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation
- `limit` (integer|null): Maximum quotes per page; omitted = curated default (25)
- `query` (string, required): Search query string (company name or ticker symbol)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/verdenroz-finance-query/finance-query#diagnostics

## Score history

- 2026-11-21: 72
- 2026-11-20: 72
- 2026-11-19: 71

## Common questions

### What is the FinanceQuery MCP server?

FinanceQuery is an MCP server listed in the public MCP registry as io.github.Verdenroz/finance-query. Stock quotes, charts, financials, options, SEC filings, crypto and macro data. Hosted, no API key. This page covers its hosted endpoint (https://finance-query.com/mcp).

### Is the FinanceQuery MCP server safe to use?

FinanceQuery scores 72 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the FinanceQuery MCP server expose?

FinanceQuery exposes 64 tools: get_analysis, get_calendar, get_chart, get_commodity, get_company_profile, and 59 more. Their descriptions and schemas cost roughly 7,918 tokens of context every time the server is loaded.

### Does the FinanceQuery MCP server require authentication?

No. We connected to FinanceQuery without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the FinanceQuery MCP server still maintained?

FinanceQuery is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the FinanceQuery MCP server?

VerifyMCP ran 13 checks on FinanceQuery, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://finance-query.com/mcp
- Repository: https://github.com/Verdenroz/finance-query
- Website: https://finance-query.com/
- Changelog RSS feed: https://verifymcp.io/servers/verdenroz-finance-query/finance-query.xml
- Changelog JSON feed: https://verifymcp.io/servers/verdenroz-finance-query/finance-query/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/verdenroz-finance-query/finance-query.json
- HTML version of this page: https://verifymcp.io/servers/verdenroz-finance-query/finance-query
