FinanceQuery

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

Should I use this

Quality & Safety

A
Description quality
95%
Schema completeness
98%
Naming quality
99%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~13,476Tokens (tool definitions)
~1.7 KBTypical response size
Significant attention impact (10.53% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

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

Remote endpoints

https://finance-query.com/mcpstreamable-http

What it can do

Tool inventory

Tools (64)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_analysis(analysis_type, fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "analysis_type": {
      "description": "Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "analysis_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_calendar(fields, range, 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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "range": {
      "description": "Forward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)",
      "type": "string"
    },
    "symbols": {
      "description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,TSLA\")",
      "type": "string"
    }
  },
  "required": [
    "symbols",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_chart(cursor, end, fields, interval, limit, ...)

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 Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "end": {
      "description": "End date as Unix timestamp (seconds). Defaults to now when `start` is set.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "interval": {
      "description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum candles per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "range": {
      "description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set.",
      "type": "string"
    },
    "start": {
      "description": "Start date as Unix timestamp (seconds). When provided, overrides `range`.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    },
    "symbols": {
      "description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")",
      "type": "string"
    }
  },
  "required": [
    "symbols",
    "interval",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_commodity(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Commodity symbol (e.g. \"GCUSD\" for gold, \"CLUSD\" for crude oil)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_company_profile(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_congressional_trades(cursor, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_crypto(count, cursor, fields, limit, vs_currency)

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

Input Schema

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Number of top coins to return (default: 50, max: 250)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum coins per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "vs_currency": {
      "description": "Quote currency (default: usd)",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_crypto_news(count, cursor, fields, limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Overall cap on articles fetched (default: 20)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum articles per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_dividends(cursor, fields, limit, range, symbols)

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 Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum dividend payments per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "range": {
      "description": "Time range: 1y|2y|5y|10y|max (default: max)",
      "type": "string"
    },
    "symbols": {
      "description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,KO,JNJ\")",
      "type": "string"
    }
  },
  "required": [
    "symbols",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_earnings_surprises(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_earnings_transcript(fields, quarter, symbol, year)

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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "quarter": {
      "description": "Fiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers\nwith no \"latest\" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted",
      "type": "string"
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    },
    "year": {
      "description": "Fiscal year. See `quarter`",
      "format": "int32",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "quarter"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_edgar_facts(concepts, cursor, fields, limit, symbol, ...)

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

Input Schema

{
  "type": "object",
  "properties": {
    "concepts": {
      "description": "Comma-separated XBRL concept names to filter to (e.g. \"Revenues,Assets\");\nomitted = curated defaults (headline financials)",
      "type": [
        "string",
        "null"
      ]
    },
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated GraphQL sub-fields to include per concept (e.g. \"concept,dataPoints\");\nomitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum data points per concept per page; omitted = curated default (25).\nApplied uniformly across every returned concept.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")",
      "type": "string"
    },
    "taxonomy": {
      "description": "XBRL taxonomy (default: \"us-gaap\"); also try \"ifrs-full\" or \"dei\"",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_edgar_search(end_date, forms, from, query, size, ...)

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

Input Schema

{
  "type": "object",
  "properties": {
    "end_date": {
      "description": "End date filter in YYYY-MM-DD format",
      "type": [
        "string",
        "null"
      ]
    },
    "forms": {
      "description": "Comma-separated form types to filter (e.g., \"10-K,10-Q,8-K\")",
      "type": [
        "string",
        "null"
      ]
    },
    "from": {
      "description": "Pagination offset; omitted = 0 (first page)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "query": {
      "description": "Search query (keywords in filing text)",
      "type": "string"
    },
    "size": {
      "description": "Page size; omitted = 100, max 100",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "start_date": {
      "description": "Start date filter in YYYY-MM-DD format",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_edgar_submissions(cursor, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum filings per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_etf_profile(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "ETF ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_executive_compensation(cursor, fields, limit, symbol)

Get disclosed executive compensation by year for a symbol.

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_fails_to_deliver(cursor, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_fear_and_greed(fields)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_feeds(cursor, fields, limit, sources)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "sources": {
      "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)",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_filing_sections(accession_number, fields, form, symbol)

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 Schema

{
  "type": "object",
  "properties": {
    "accession_number": {
      "description": "SEC accession number, e.g. \"0000320193-24-000123\"",
      "type": "string"
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "form": {
      "description": "Which filing form to fetch sectioned text for: ten-k | eight-k",
      "type": "string"
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "accession_number",
    "form"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_financials(fields, frequency, metrics, statement, symbols)

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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "frequency": {
      "description": "Reporting frequency: annual | quarterly (default: annual)",
      "type": "string"
    },
    "metrics": {
      "description": "Comma-separated list of line-item metrics to filter to; omitted = all reported metrics",
      "type": [
        "string",
        "null"
      ]
    },
    "statement": {
      "description": "Statement type: income | balance | cashflow",
      "type": "string"
    },
    "symbols": {
      "description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOGL\")",
      "type": "string"
    }
  },
  "required": [
    "symbols",
    "statement",
    "frequency"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_forex(fields, from, to)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "from": {
      "description": "Base currency code (e.g. \"USD\")",
      "type": "string"
    },
    "to": {
      "description": "Quote currency code (e.g. \"EUR\")",
      "type": "string"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_forex_news(count, cursor, fields, limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Overall cap on articles fetched (default: 20)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum articles per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_fred_series(as_of, cursor, fields, id, limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Vintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest",
      "type": [
        "string",
        "null"
      ]
    },
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "id": {
      "description": "FRED series ID (e.g., \"FEDFUNDS\", \"CPIAUCSL\", \"GDP\", \"UNRATE\")",
      "type": "string"
    },
    "limit": {
      "description": "Maximum observations per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_futures(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Futures contract symbol (e.g. \"ESM26\" for E-mini S&P June 2026)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_grading_actions(cursor, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_holders(cursor, fields, holder_type, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "holder_type": {
      "description": "Holder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster",
      "type": "string"
    },
    "limit": {
      "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).",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "holder_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_index_constituent_changes(cursor, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Index symbol (e.g. ^GSPC)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_index_constituents(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Index symbol (e.g. \"^GSPC\" for the S&P 500; Wikipedia-backed, S&P 500 only)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_indicators(cursor, fields, interval, limit, range, ...)

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 Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "interval": {
      "description": "Candle interval: 1d|1wk|1mo (default: 1d)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum symbols per page (only applies when multiple symbols given); omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "range": {
      "description": "Time range: 1mo|3mo|6mo|1y|2y|5y (default: 1y)",
      "type": "string"
    },
    "symbols": {
      "description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")",
      "type": "string"
    }
  },
  "required": [
    "symbols",
    "interval",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_indices(fields, region)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "region": {
      "description": "Region: americas|europe|asia-pacific|middle-east-africa|currencies (default: all)",
      "type": "string"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_industry(fields, industry, lang)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "industry": {
      "description": "Industry slug (e.g., semiconductors, biotechnology, banks-diversified)",
      "type": "string"
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "industry"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_key_metrics_ttm(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_market_calendar(fields, from, kind, to)

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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "from": {
      "description": "Start date (YYYY-MM-DD); ignored by market-holiday/market-status",
      "type": [
        "string",
        "null"
      ]
    },
    "kind": {
      "description": "Which market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status",
      "type": "string"
    },
    "to": {
      "description": "End date (YYYY-MM-DD); ignored by market-holiday/market-status",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "kind"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_market_hours(fields, region)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "region": {
      "description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)",
      "type": "string"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_market_summary(fields, lang, region)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "region": {
      "description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)",
      "type": "string"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_news(cursor, fields, lang, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum articles per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol (optional; omit for general market news)",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_options(cursor, expiration, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "expiration": {
      "description": "Expiration date as Unix timestamp in seconds (optional; defaults to nearest expiration)",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum contracts per side (calls/puts) per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_press_releases(fields, limit, symbol)

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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum number of releases to return (default: 10)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_price_target_consensus(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_price_target_summary(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_protocol_tvl(fields, id)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "id": {
      "description": "CoinGecko coin id (e.g. aave)",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_protocol_tvl_history(cursor, fields, id, limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "id": {
      "description": "CoinGecko coin id (e.g. aave)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_quote(cursor, fields, lang, limit, symbols)

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 Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum symbols per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbols": {
      "description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")",
      "type": "string"
    }
  },
  "required": [
    "symbols"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_rating_consensus(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_ratios_ttm(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_recommendations(fields, limit, symbol)

Get similar stock recommendations and analyst ratings for a symbol.

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum number of recommendations to return (default: 5)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_risk(benchmark, fields, interval, range, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "benchmark": {
      "description": "Benchmark symbol for beta calculation (e.g., \"SPY\")",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "interval": {
      "description": "Candle interval: 1d|1wk (default: 1d)",
      "type": "string"
    },
    "range": {
      "description": "Time range: 1y|2y|5y (default: 1y)",
      "type": "string"
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "interval",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_risk_factors(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_sector(fields, lang, sector)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "sector": {
      "description": "Sector slug: technology|financial-services|consumer-cyclical|communication-services|\nhealthcare|industrials|consumer-defensive|energy|basic-materials|real-estate|utilities",
      "type": "string"
    }
  },
  "required": [
    "sector"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_sector_pe(fields)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_sector_performance(fields)

Get aggregate performance for every market sector, provider-routed (Yahoo screener fan-out, keyless). Distinct from get_sector (per-sector Yahoo-only shortcut).

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_sector_performance_history(fields, limit)

Get sector performance per session, most recent first.

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Sessions to return; omitted = 30",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_short_volume(cursor, fields, limit, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum entries per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_spark(fields, interval, range, symbols)

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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "interval": {
      "description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)",
      "type": "string"
    },
    "range": {
      "description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)",
      "type": "string"
    },
    "symbols": {
      "description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")",
      "type": "string"
    }
  },
  "required": [
    "symbols",
    "interval",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_splits(fields, range, symbol)

Get historical stock split history for a symbol.

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "range": {
      "description": "Time range: 1y|2y|5y|10y|max (default: max)",
      "type": "string"
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_symbol_details(fields, symbol)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_transcripts(fields, lang, limit, paragraph_cursor, paragraph_limit, ...)

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 Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum number of transcripts to return (default: all)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "paragraph_cursor": {
      "description": "Opaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "paragraph_limit": {
      "description": "Maximum transcript paragraphs per page; omitted = curated default (25). A\nfull call's `text` is returned as paginated paragraphs, not one giant blob",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "symbol": {
      "description": "Stock ticker symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_treasury_auctions(count, cursor, fields, from, limit, ...)

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 Schema

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "from": {
      "description": "Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum rows per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "security_term": {
      "description": "Security term filter as Treasury spells it (e.g. \"13-Week\"); ignored when `upcoming` is true",
      "type": [
        "string",
        "null"
      ]
    },
    "security_type": {
      "description": "Security class filter (\"Bill\", \"Note\", \"Bond\"); ignored when `upcoming` is true",
      "type": [
        "string",
        "null"
      ]
    },
    "to": {
      "description": "Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true",
      "type": [
        "string",
        "null"
      ]
    },
    "upcoming": {
      "description": "Return the not-yet-held auction schedule instead of auction records",
      "type": [
        "boolean",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_treasury_yields(cursor, fields, limit, year)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum rows per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "year": {
      "description": "Year to fetch yield curve data for (default: current year)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_trending(fields, region)

Get currently trending stock tickers for a region.

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "region": {
      "description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)",
      "type": "string"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢lookup(fields, lang, logo, query, query_type)

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

Input Schema

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "logo": {
      "description": "Include logo URLs (requires an additional upstream API call); default: false",
      "type": [
        "boolean",
        "null"
      ]
    },
    "query": {
      "description": "Search query (company name or ticker symbol)",
      "type": "string"
    },
    "query_type": {
      "description": "Filter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all)",
      "type": "string"
    }
  },
  "required": [
    "query",
    "query_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢screener(count, fields, screener_type)

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

Input Schema

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Number of results to return (default: 25, max: 250)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "screener_type": {
      "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",
      "type": "string"
    }
  },
  "required": [
    "screener_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢search(cursor, fields, lang, limit, query)

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

Input Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
      "type": [
        "string",
        "null"
      ]
    },
    "fields": {
      "description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
      "type": [
        "string",
        "null"
      ]
    },
    "lang": {
      "description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
      "type": [
        "string",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum quotes per page; omitted = curated default (25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "query": {
      "description": "Search query string (company name or ticker symbol)",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded64 tools