FinanceQuery MCP
An open-source MCP server providing 36 tools for AI agents to query financial data, including stock quotes, historical data, technical indicators, SEC filings, and crypto data via a hosted API.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://finance-query.com/mcpWhat its tools do
64 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (64)
get_analysisget_calendarget_chartget_commodityget_company_profileget_congressional_tradesget_cryptoget_crypto_newsget_dividendsget_earnings_surprisesget_earnings_transcriptget_edgar_factsget_edgar_searchget_edgar_submissionsget_etf_profileget_executive_compensationget_fails_to_deliverget_fear_and_greedget_feedsget_filing_sectionsget_financialsget_forexget_forex_newsget_fred_seriesget_futuresget_grading_actionsget_holdersget_index_constituent_changesget_index_constituentsget_indicatorsget_indicesget_industryget_key_metrics_ttmget_market_calendarget_market_hoursget_market_summaryget_newsget_optionsget_press_releasesget_price_target_consensusget_price_target_summaryget_protocol_tvlget_protocol_tvl_historyget_quoteget_rating_consensusget_ratios_ttmget_recommendationsget_riskget_risk_factorsget_sectorget_sector_peget_sector_performanceget_sector_performance_historyget_short_volumeget_sparkget_splitsget_symbol_detailsget_transcriptsget_treasury_auctionsget_treasury_yieldsget_trendinglookupscreenersearch
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Retrieve real-time stock quotes and historical price data
- Access technical indicators and market data for backtesting
- Query SEC EDGAR filings and financial statements
- Fetch crypto and macroeconomic data for AI agents
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- fq-mcp 3.4.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 64 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Tools
64 advertised
get_analysis — Analyst Data
Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"analysis_type"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"analysis_type": {
"type": "string",
"description": "Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history"
}
}
}{
"title": "Analyst Data",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_calendar — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Forward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbols": {
"type": "string",
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,TSLA\")"
}
}
}{
"title": "Upcoming Events for Symbols",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_chart — 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).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"interval",
"range"
],
"properties": {
"end": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "End date as Unix timestamp (seconds). Defaults to now when `start` is set."
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum candles per page; omitted = curated default (25)"
},
"range": {
"type": "string",
"description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set."
},
"start": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Start date as Unix timestamp (seconds). When provided, overrides `range`."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")"
},
"interval": {
"type": "string",
"description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)"
}
}
}{
"title": "Price Chart (OHLCV)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_commodity — Commodity Quote
Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Commodity symbol (e.g. \"GCUSD\" for gold, \"CLUSD\" for crude oil)"
}
}
}{
"title": "Commodity Quote",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_company_profile — Company Profile
Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Company Profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_congressional_trades — Congressional Trades
Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Congressional Trades",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_crypto — Top Cryptocurrencies
Get top cryptocurrency coins by market cap from CoinGecko (no API key required).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Number of top coins to return (default: 50, max: 250)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum coins per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"vs_currency": {
"type": [
"string",
"null"
],
"description": "Quote currency (default: usd)"
}
}
}{
"title": "Top Cryptocurrencies",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_crypto_news — Crypto News
Get market-wide crypto news (currently FMP only, requires FMP_API_KEY).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Overall cap on articles fetched (default: 20)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum articles per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}{
"title": "Crypto News",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_dividends — 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).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"range"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum dividend payments per page; omitted = curated default (25)"
},
"range": {
"type": "string",
"description": "Time range: 1y|2y|5y|10y|max (default: max)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,KO,JNJ\")"
}
}
}{
"title": "Dividend History",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_earnings_surprises — Earnings Surprises
Get a stock's earnings-surprise history (actual vs. estimated EPS).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Earnings Surprises",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_earnings_transcript — 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).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"quarter"
],
"properties": {
"year": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Fiscal year. See `quarter`"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"quarter": {
"type": "string",
"description": "Fiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers\nwith no \"latest\" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted"
}
}
}{
"title": "Earnings Call Transcript",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_edgar_facts — SEC EDGAR XBRL Facts
Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum data points per concept per page; omitted = curated default (25).\nApplied uniformly across every returned concept."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated GraphQL sub-fields to include per concept (e.g. \"concept,dataPoints\");\nomitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")"
},
"concepts": {
"type": [
"string",
"null"
],
"description": "Comma-separated XBRL concept names to filter to (e.g. \"Revenues,Assets\");\nomitted = curated defaults (headline financials)"
},
"taxonomy": {
"type": [
"string",
"null"
],
"description": "XBRL taxonomy (default: \"us-gaap\"); also try \"ifrs-full\" or \"dei\""
}
}
}{
"title": "SEC EDGAR XBRL Facts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_edgar_search — SEC EDGAR Full-Text Search
Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"from": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Pagination offset; omitted = 0 (first page)"
},
"size": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Page size; omitted = 100, max 100"
},
"forms": {
"type": [
"string",
"null"
],
"description": "Comma-separated form types to filter (e.g., \"10-K,10-Q,8-K\")"
},
"query": {
"type": "string",
"description": "Search query (keywords in filing text)"
},
"end_date": {
"type": [
"string",
"null"
],
"description": "End date filter in YYYY-MM-DD format"
},
"start_date": {
"type": [
"string",
"null"
],
"description": "Start date filter in YYYY-MM-DD format"
}
}
}{
"title": "SEC EDGAR Full-Text Search",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_edgar_submissions — SEC EDGAR Filing History
Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum filings per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")"
}
}
}{
"title": "SEC EDGAR Filing History",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_etf_profile — ETF Profile and Holdings
Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "ETF ticker symbol"
}
}
}{
"title": "ETF Profile and Holdings",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_executive_compensation — Executive Compensation
Get disclosed executive compensation by year for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Executive Compensation",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_fails_to_deliver — Fails-to-Deliver Records
Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Fails-to-Deliver Records",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_fear_and_greed — Fear & Greed Index
Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}{
"title": "Fear & Greed Index",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_feeds — Financial News Feeds
Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"sources": {
"type": [
"string",
"null"
],
"description": "Comma-separated feed sources: federal-reserve|sec|marketwatch|cnbc|bloomberg|ft|nyt|\nguardian|investing|bea|ecb|cfpb|wsj|fortune|businesswire|coindesk|cointelegraph|\ntechcrunch|hackernews|oilprice|calculatedrisk|scmp|nikkei|boe|venturebeat|yc|\neconomist|financialpost|ftlex|ritholtz\n(default: marketwatch, bloomberg, wsj, fortune)"
}
}
}{
"title": "Financial News Feeds",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_filing_sections — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"accession_number",
"form"
],
"properties": {
"form": {
"type": "string",
"description": "Which filing form to fetch sectioned text for: ten-k | eight-k"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"accession_number": {
"type": "string",
"description": "SEC accession number, e.g. \"0000320193-24-000123\""
}
}
}{
"title": "SEC Filing Sections",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_financials — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"statement",
"frequency"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"metrics": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of line-item metrics to filter to; omitted = all reported metrics"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOGL\")"
},
"frequency": {
"type": "string",
"description": "Reporting frequency: annual | quarterly (default: annual)"
},
"statement": {
"type": "string",
"description": "Statement type: income | balance | cashflow"
}
}
}{
"title": "Financial Statements",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_forex — Exchange Rate
Get a currency pair's current exchange rate, provider-routed (Capability::FOREX).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Quote currency code (e.g. \"EUR\")"
},
"from": {
"type": "string",
"description": "Base currency code (e.g. \"USD\")"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "Exchange Rate",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_forex_news — Forex News
Get market-wide forex news (currently FMP only, requires FMP_API_KEY).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Overall cap on articles fetched (default: 20)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum articles per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}{
"title": "Forex News",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_fred_series — FRED Economic Series
Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "FRED series ID (e.g., \"FEDFUNDS\", \"CPIAUCSL\", \"GDP\", \"UNRATE\")"
},
"as_of": {
"type": [
"string",
"null"
],
"description": "Vintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum observations per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "FRED Economic Series",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_futures — Futures Quote
Get a futures contract's current quote, provider-routed (Yahoo, keyless).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Futures contract symbol (e.g. \"ESM26\" for E-mini S&P June 2026)"
}
}
}{
"title": "Futures Quote",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_grading_actions — Analyst Upgrades and Downgrades
Get provider-routed analyst upgrades and downgrades for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Analyst Upgrades and Downgrades",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_holders — Ownership and Insider Activity
Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"holder_type"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page for holder types with a list (institutional,\nmutualfund, insider-transactions, insider-roster); omitted = curated\ndefault (25). No-op for major/insider-purchases (no list)."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"holder_type": {
"type": "string",
"description": "Holder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster"
}
}
}{
"title": "Ownership and Insider Activity",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_index_constituent_changes — Index Constituent Changes
Get additions and removals from an index's constituent list.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Index symbol (e.g. ^GSPC)"
}
}
}{
"title": "Index Constituent Changes",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_index_constituents — Index Constituents
Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Index symbol (e.g. \"^GSPC\" for the S&P 500; Wikipedia-backed, S&P 500 only)"
}
}
}{
"title": "Index Constituents",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_indicators — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"interval",
"range"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum symbols per page (only applies when multiple symbols given); omitted = curated default (25)"
},
"range": {
"type": "string",
"description": "Time range: 1mo|3mo|6mo|1y|2y|5y (default: 1y)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")"
},
"interval": {
"type": "string",
"description": "Candle interval: 1d|1wk|1mo (default: 1d)"
}
}
}{
"title": "Technical Indicators",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_indices — World Market Indices
Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"region": {
"type": "string",
"description": "Region: americas|europe|asia-pacific|middle-east-africa|currencies (default: all)"
}
}
}{
"title": "World Market Indices",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_industry — Industry Overview
Get comprehensive industry data (overview, performance, top companies) for a specific industry slug.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"industry"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"industry": {
"type": "string",
"description": "Industry slug (e.g., semiconductors, biotechnology, banks-diversified)"
}
}
}{
"title": "Industry Overview",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_key_metrics_ttm — Key Metrics (TTM)
Get trailing-twelve-month key metrics for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Key Metrics (TTM)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_market_calendar — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"description": "End date (YYYY-MM-DD); ignored by market-holiday/market-status"
},
"from": {
"type": [
"string",
"null"
],
"description": "Start date (YYYY-MM-DD); ignored by market-holiday/market-status"
},
"kind": {
"type": "string",
"description": "Which market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "Market-Wide Event Calendar",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_market_hours — Market Hours
Get current market hours and open/closed status for a region.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"region": {
"type": "string",
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)"
}
}
}{
"title": "Market Hours",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_market_summary — Market Summary
Get market overview with major indices and currencies for a region.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"region": {
"type": "string",
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)"
}
}
}{
"title": "Market Summary",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_news — Stock and Market News
Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum articles per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": [
"string",
"null"
],
"description": "Stock ticker symbol (optional; omit for general market news)"
}
}
}{
"title": "Stock and Market News",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_options — Options Chain
Get the options chain for a symbol. Provide an expiration timestamp to get a specific expiry, or omit for the nearest expiration.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum contracts per side (calls/puts) per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"expiration": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Expiration date as Unix timestamp in seconds (optional; defaults to nearest expiration)"
}
}
}{
"title": "Options Chain",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_press_releases — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum number of releases to return (default: 10)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Company Press Releases",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_price_target_consensus — Price Target Consensus
Get a stock's consensus analyst price target (high/low/mean/median).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Price Target Consensus",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_price_target_summary — Price Target Summary
Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Price Target Summary",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_protocol_tvl — DeFi Protocol TVL
Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "CoinGecko coin id (e.g. aave)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "DeFi Protocol TVL",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_protocol_tvl_history — DeFi Protocol TVL History
Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "CoinGecko coin id (e.g. aave)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "DeFi Protocol TVL History",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_quote — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum symbols per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")"
}
}
}{
"title": "Stock Quote",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_rating_consensus — Analyst Rating Consensus
Get a stock's consensus analyst rating rollup (strong buy/buy/hold/sell/strong sell counts and a headline consensus label).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Analyst Rating Consensus",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_ratios_ttm — Financial Ratios (TTM)
Get trailing-twelve-month financial ratios for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Financial Ratios (TTM)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_recommendations — Similar Stocks
Get similar stock recommendations and analyst ratings for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum number of recommendations to return (default: 5)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Similar Stocks",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_risk — Risk Analytics
Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"interval",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Time range: 1y|2y|5y (default: 1y)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"interval": {
"type": "string",
"description": "Candle interval: 1d|1wk (default: 1d)"
},
"benchmark": {
"type": [
"string",
"null"
],
"description": "Benchmark symbol for beta calculation (e.g., \"SPY\")"
}
}
}{
"title": "Risk Analytics",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_risk_factors — Filing Risk Factors
Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Filing Risk Factors",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sector — Sector Overview
Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sector"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"sector": {
"type": "string",
"description": "Sector slug: technology|financial-services|consumer-cyclical|communication-services|\nhealthcare|industrials|consumer-defensive|energy|basic-materials|real-estate|utilities"
}
}
}{
"title": "Sector Overview",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sector_pe — Sector P/E Ratios
Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "Sector P/E Ratios",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sector_performance — 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).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "Sector Performance",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sector_performance_history — Sector Performance History
Get sector performance per session, most recent first.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Sessions to return; omitted = 30"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "Sector Performance History",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_short_volume — Short-Sale Volume
Get daily FINRA short-sale volume for a symbol (keyless).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Short-Sale Volume",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_spark — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"interval",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")"
},
"interval": {
"type": "string",
"description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)"
}
}
}{
"title": "Price Sparklines",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_splits — Stock Split History
Get historical stock split history for a symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Time range: 1y|2y|5y|10y|max (default: max)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Stock Split History",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_symbol_details — Symbol Reference Details
Get reference detail for one symbol (name, exchange, SIC code, employees, list date).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}{
"title": "Symbol Reference Details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_transcripts — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum number of transcripts to return (default: all)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"paragraph_limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum transcript paragraphs per page; omitted = curated default (25). A\nfull call's `text` is returned as paginated paragraphs, not one giant blob"
},
"paragraph_cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page"
}
}
}{
"title": "Earnings Call Transcripts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_treasury_auctions — 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.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": [
"string",
"null"
],
"description": "Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true"
},
"from": {
"type": [
"string",
"null"
],
"description": "Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true"
},
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum rows per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"upcoming": {
"type": [
"boolean",
"null"
],
"description": "Return the not-yet-held auction schedule instead of auction records"
},
"security_term": {
"type": [
"string",
"null"
],
"description": "Security term filter as Treasury spells it (e.g. \"13-Week\"); ignored when `upcoming` is true"
},
"security_type": {
"type": [
"string",
"null"
],
"description": "Security class filter (\"Bill\", \"Note\", \"Bond\"); ignored when `upcoming` is true"
}
}
}{
"title": "Treasury Auction Results",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_treasury_yields — Treasury Yield Curve
Get US Treasury yield curve data (1m through 30y) for a given year. No API key required.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"year": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Year to fetch yield curve data for (default: current year)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum rows per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}{
"title": "Treasury Yield Curve",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_trending — Trending Tickers
Get currently trending stock tickers for a region.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"region": {
"type": "string",
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)"
}
}
}{
"title": "Trending Tickers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup — Ticker Lookup by Type
Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"query_type"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"logo": {
"type": [
"boolean",
"null"
],
"description": "Include logo URLs (requires an additional upstream API call); default: false"
},
"query": {
"type": "string",
"description": "Search query (company name or ticker symbol)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"query_type": {
"type": "string",
"description": "Filter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all)"
}
}
}{
"title": "Ticker Lookup by Type",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}screener — Stock Screener
Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks).
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"screener_type"
],
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Number of results to return (default: 25, max: 250)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"screener_type": {
"type": "string",
"description": "Screener type: most-actives | day-gainers | day-losers | growth-technology-stocks |\nundervalued-growth-stocks | undervalued-large-caps | aggressive-small-caps |\nsmall-cap-gainers | most-shorted-stocks | high-yield-bond | top-mutual-funds |\nconservative-foreign-funds | portfolio-anchors | solid-large-growth-funds |\nsolid-midcap-growth-funds"
}
}
}{
"title": "Stock Screener",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search — Symbol Search
Search for stocks, ETFs, and companies by name or ticker symbol.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum quotes per page; omitted = curated default (25)"
},
"query": {
"type": "string",
"description": "Search query string (company name or ticker symbol)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}{
"title": "Symbol Search",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-19: 2 of 2 checks answered
- 2026-11-20: 3 of 3 checks answered
- 2026-11-21: 4 of 4 checks answered
- 2026-11-22: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 675 ms
- 95th percentile latency
- 675 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 675 ms · metadata changed · 64 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http financequery-mcp https://finance-query.com/mcpCodex
codex mcp add financequery-mcp --url https://finance-query.com/mcpCursor
{
"mcpServers": {
"financequery-mcp": {
"url": "https://finance-query.com/mcp"
}
}
}Cline
{
"mcpServers": {
"financequery-mcp": {
"type": "streamableHttp",
"url": "https://finance-query.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"financequery-mcp": {
"type": "http",
"url": "https://finance-query.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http financequery-mcp https://finance-query.com/mcpClaude Desktop
https://finance-query.com/mcpWindsurf
{
"mcpServers": {
"financequery-mcp": {
"serverUrl": "https://finance-query.com/mcp"
}
}
}Let your agent find its tools
Find servers like FinanceQuery MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.