Tool Reference

Search FINRA BrokerCheck for registered individual brokers and financial representatives by name. Returns CRD number, current firm, registration status, and whether the individual has any disclosures on record. Use GetBrokerCheckDetail to fetch the full profile once you have a CRD.

{
  "tool": "SearchBrokerCheck",
  "params": {
    "name": "Peter Chieco",
    "state": "NY",
    "question_asked": "Find broker Peter Chieco in New York"
  }
}

Search FINRA BrokerCheck for broker-dealer firms by name. Returns firm CRD, registration status, city, state, and disclosure flag. Useful for finding firm CRDs before calling GetBrokerCheckDetail.

{
  "tool": "SearchBrokerCheckFirm",
  "params": {
    "name": "Raymond James",
    "question_asked": "Find Raymond James broker-dealer CRD"
  }
}

Retrieve the full FINRA BrokerCheck profile for one individual using their CRD number. Returns complete employment history, exam qualifications, licenses held, and all disclosure details.

{
  "tool": "GetBrokerCheckDetail",
  "params": {
    "crd": "2144241",
    "question_asked": "Full BrokerCheck profile for CRD 2144241"
  }
}

Search the SEC Investment Adviser Public Disclosure (IAPD) database for registered investment advisor (RIA) firms by name. Returns firm CRD, AUM, employee count, state, and office city. Use for RIA firms; use SearchBrokerCheckFirm for broker-dealers.

{
  "tool": "SearchIAPDFirm",
  "params": {
    "name": "Fidelity Investments",
    "question_asked": "Find Fidelity RIA firm CRD and AUM"
  }
}

Retrieve the full Form ADV filing detail for one RIA firm by CRD number. Returns all Form ADV Part 1 fields: client types, advisory activities, fee arrangements, custody information, office locations, and affiliated entities.

{
  "tool": "GetIAPDFirmDetail",
  "params": {
    "crd": "106288",
    "question_asked": "Full Form ADV for Vanguard RIA"
  }
}

Search SEC IAPD for individual investment advisor representatives (IARs) by name. Returns CRD number, current employer, registration states, and exam history. For broker/dealer individuals use SearchBrokerCheck instead.

{
  "tool": "SearchIAPDIndividual",
  "params": {
    "name": "Anthony Feeney",
    "state": "MA",
    "question_asked": "Find IAR Anthony Feeney in Massachusetts"
  }
}

Retrieve the full SEC IAPD profile for one individual investment advisor representative using their CRD number. Returns complete registration history, exam qualifications, employment history, and any disclosures.

{
  "tool": "GetIAPDIndividualDetail",
  "params": {
    "crd": "6753609",
    "question_asked": "Full IAPD profile for CRD 6753609"
  }
}

Search SEC EDGAR for 13F-HR institutional holdings filings by institution name. Any institution managing >$100M in US equities must file quarterly — this reveals fund strategies and equity positions. Feed the returned CIK + accession number into Get13FHoldings for the full position table.

{
  "tool": "SearchEdgar13F",
  "params": {
    "query": "Bridgewater Associates",
    "start_date": "2024-07-01",
    "end_date": "2024-09-30",
    "question_asked": "Find Bridgewater's Q3 2024 13F filing"
  }
}

Retrieve all SEC filings for a company or institution using its CIK (Central Index Key). Returns every filing on record: form type, date, accession number, and description.

{
  "tool": "GetEdgarCompanyFilings",
  "params": {
    "cik": "1350694",
    "question_asked": "All SEC filings for Bridgewater Associates"
  }
}

Retrieve US Census ACS income and wealth proxy data for a ZIP code or state. Returns median household income, median home value, total households, and count/share of households earning $100k+. Useful for scoring advisor territories.

{
  "tool": "GetTerritoryWealthProfile",
  "params": {
    "zip_code": "10022",
    "question_asked": "Wealth profile for ZIP 10022 (Upper East Side)"
  }
}

Search for a Yahoo Finance ticker symbol by company name, fund name, or keyword. Use this when you have a name but need the ticker.

{
  "tool": "LookupTicker",
  "params": {
    "query": "Vanguard Total Stock Market",
    "asset_type": "etf",
    "question_asked": "What is the ticker for Vanguard Total Stock Market ETF?"
  }
}

Fetch the full Yahoo Finance profile for a stock, ETF, mutual fund, crypto, or index. Returns name, sector, industry, market cap, P/E, 52-week range, beta, dividend yield, description, and 60+ metadata fields.

{
  "tool": "GetTickerInfo",
  "params": {
    "symbol": "NVDA",
    "question_asked": "Give me NVDA's sector, market cap, and P/E ratio"
  }
}

Fetch OHLCV price history for one ticker. Supports daily, weekly, monthly, or intraday bars over any period.

{
  "tool": "GetPriceHistory",
  "params": {
    "symbol": "SPY",
    "period": "6mo",
    "interval": "1d",
    "question_asked": "SPY daily price history for the last 6 months"
  }
}

Fetch OHLCV price history for multiple tickers in a single call. Returns a flattened table with columns like AAPL_Close, SPY_Volume, etc.

{
  "tool": "GetMultiTickerHistory",
  "params": {
    "symbols": "SPY QQQ IWM",
    "period": "1y",
    "question_asked": "Compare SPY, QQQ and IWM performance over the last year"
  }
}

Fetch income statement, cash flow statement, or balance sheet for a stock. Returns up to 4 years annual or 4 quarters quarterly, transposed so each row is one reporting period.

{
  "tool": "GetFinancials",
  "params": {
    "symbol": "AAPL",
    "statement": "income",
    "freq": "yearly",
    "question_asked": "Apple annual revenue and net income for last 4 years"
  }
}

Fetch earnings history (EPS actual vs estimate, surprise %), upcoming earnings dates, and forward EPS estimates by quarter and fiscal year.

{
  "tool": "GetEarningsHistory",
  "params": {
    "symbol": "NVDA",
    "question_asked": "NVDA earnings history and next earnings date"
  }
}

Fetch analyst buy/sell/hold consensus, price targets (low, high, mean, median), and the full history of upgrades/downgrades with firm name, fromGrade, toGrade, and action.

{
  "tool": "GetAnalystRatings",
  "params": {
    "symbol": "TSLA",
    "question_asked": "What is the Wall Street consensus on Tesla and the price target?"
  }
}

Fetch ownership data: top institutional holders, mutual fund holders, and recent insider transactions (buys/sells by executives).

{
  "tool": "GetHolders",
  "params": {
    "symbol": "AAPL",
    "holder_type": "institutional",
    "question_asked": "Who are the top institutional holders of Apple stock?"
  }
}

Fetch the full history of cash dividends, stock splits, and combined corporate actions. Returns date, amount/ratio for each event.

{
  "tool": "GetDividendsAndSplits",
  "params": {
    "symbol": "KO",
    "period": "10y",
    "question_asked": "Coca-Cola dividend history for the last 10 years"
  }
}

List all available options expiry dates for a ticker. Call this before GetOptionsChain to get a valid expiry date.

{
  "tool": "GetOptionsExpirations",
  "params": {
    "symbol": "SPY",
    "question_asked": "What options expiry dates are available for SPY?"
  }
}

Fetch the full options chain (calls and puts) for one expiry date. Returns strike, bid, ask, last price, implied volatility, open interest, and volume for every contract.

{
  "tool": "GetOptionsChain",
  "params": {
    "symbol": "AAPL",
    "expiry_date": "2025-06-20",
    "question_asked": "Show me the AAPL options chain for June 2025 expiry"
  }
}

Fetch ETF or mutual fund specific data: top holdings with weight %, sector allocations, expense ratio, bond credit quality, and equity style characteristics. ETFs and mutual funds only — use GetTickerInfo for stocks.

{
  "tool": "GetFundProfile",
  "params": {
    "symbol": "QQQ",
    "section": "holdings",
    "question_asked": "What are the top holdings in QQQ?"
  }
}

Search SEC EDGAR for mutual fund and ETF filers by investment category or keyword. Returns entity name and CIK. Feed CIKs into GetFundFees.

{
  "tool": "SearchFundsByCategory",
  "params": {
    "keywords": "commodity",
    "fund_type": "etf",
    "max_results": 50,
    "question_asked": "Find all commodity ETFs to compare expense ratios"
  }
}

Retrieve expense ratios and fee breakdown for a mutual fund or ETF using its SEC CIK. Reads structured XBRL data filed with prospectuses. Returns net/gross expense ratio, management fee, 12b-1 fee, and other expenses. All values expressed as percentages (e.g. 0.03 = 0.03%).

{
  "tool": "GetFundFees",
  "params": {
    "cik": "1289419",
    "question_asked": "What is the expense ratio for this commodity ETF?"
  }
}

Fetch and parse the complete equity holdings table from a specific SEC 13F-HR filing. Returns one row per position with CUSIP, market value, shares, and voting authority. Obtain cik + accession_no from SearchEdgar13F first.

{
  "tool": "Get13FHoldings",
  "params": {
    "cik": "1350694",
    "accession_no": "0001350694-24-000012",
    "min_value_thousands": 1000,
    "sort_by": "value_desc",
    "limit": 20,
    "question_asked": "Top 20 Bridgewater positions in Q2 2024 worth at least $1M"
  }
}

Search the Federal Reserve Bank of St. Louis FRED database for economic data series by keyword. Returns series ID, title, frequency, units, and date range. Use to find the right series ID before calling GetFredSeriesData.

{
  "tool": "SearchFredSeries",
  "params": {
    "query": "federal funds rate",
    "question_asked": "Find the FRED series for the federal funds rate"
  }
}

Fetch time-series observation data from FRED for a specific economic series. Returns date + value pairs with metadata. Use SearchFredSeries first if you don't know the series ID.

{
  "tool": "GetFredSeriesData",
  "params": {
    "series_id": "DGS10",
    "observation_start": "2020-01-01",
    "frequency": "m",
    "limit": 60,
    "question_asked": "10-year treasury yield monthly since 2020"
  }
}

Map financial instrument identifiers between different ID systems (ticker ↔ FIGI ↔ ISIN ↔ CUSIP) using Bloomberg's OpenFIGI service. Useful for normalizing IDs across EDGAR, Yahoo Finance, and other sources.

{
  "tool": "MapInstrumentIds",
  "params": {
    "mappings": [
      { "idType": "TICKER", "idValue": "AAPL", "exchCode": "US" },
      { "idType": "ID_ISIN", "idValue": "US5949181045" }
    ],
    "question_asked": "Convert AAPL ticker to ISIN and convert Microsoft ISIN to ticker"
  }
}

Search Bloomberg OpenFIGI for financial instruments by name or keyword. Returns FIGI, ticker, exchange, and security type for each match. Use when you know the company name but not the ticker or FIGI.

{
  "tool": "SearchFigiInstruments",
  "params": {
    "query": "NVIDIA",
    "security_type": "Common Stock",
    "exchange_code": "US",
    "question_asked": "Find NVIDIA FIGI and ticker information"
  }
}

Search the Global Legal Entity Identifier Foundation (GLEIF) database for LEIs by entity name. Returns the 20-character LEI code, legal name, registration status, legal address, and jurisdiction. Covers 2M+ entities across 200+ jurisdictions.

{
  "tool": "SearchLEI",
  "params": {
    "name": "Vanguard Group",
    "country": "US",
    "question_asked": "Find the LEI for Vanguard Group"
  }
}

Retrieve the full GLEIF LEI record for one entity using its 20-character LEI code. Returns legal name, registration status, legal and headquarters address, managing LOU, and renewal dates.

{
  "tool": "GetLEIDetail",
  "params": {
    "lei": "549300BFL5DRQJHBSZ57",
    "question_asked": "Full LEI detail for Vanguard Group"
  }
}

Return Kitces Research advisor practice benchmark data for independent and RIA-affiliated financial advisors. Covers median and top-quartile metrics across revenue, fees, technology, staffing, and client metrics. Data is embedded as curated static reference — no external call is made.

{
  "tool": "GetAdvisorBenchmarks",
  "params": {
    "category": "fees",
    "question_asked": "What are typical AUM fee schedules for independent RIAs?"
  }
}