FilingSpy Mcp Tools List

{"result":{"tools":[{"name":"list_investors","title":"List investors","description":"List the tracked superinvestors with primaryStyle (nullable) and an optional investor_style primary-style metadata filter, available on every plan, plus their latest portfolio period, total value, and position count. Also returns high-level stats for the latest substantially complete consensus quarter (75% coverage, same fallback as consensus), with nextPeriod {period, investorsFiled} when later filings have started. Returns byte-bounded investor pages (default 50, maximum 100 requested rows); follow nextOffset with identical arguments. Use this to see who is being tracked or for dashboard-level questions. A fund family is listed once, as its firm, with `fundCount` and `funds` naming the individual fund slugs you can drill into; the firm's 13F and each fund's N-PORT are separate SEC lenses on the same manager and must never be added together.","inputSchema":{"type":"object","properties":{"investor_style":{"type":"string","enum":["value","quality","growth","activist","macro","special"],"description":"Optional primary-style metadata filter; available on every plan."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."},"offset":{"type":"integer","minimum":0,"description":"Default 0; follow nextOffset with the same arguments."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum rows requested; byte-bounded pages may contain fewer. Follow nextOffset."}},"required":[]},"annotations":{"title":"List investors","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_investor_holdings","title":"Get investor holdings","description":"Get an investor's portfolio holdings for a specific period. Returns positions with shares, value, portfolio weight %, ticker, and security details. If period is omitted, returns the latest available period. Supports sorting and limiting results. Follow nextOffset as offset with the same filters to continue.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"slug":{"type":"string","description":"Investor slug, CIK digits (leading zeros accepted), or exact case-insensitive investor/manager name, including its lowercase hyphenated slugified form (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted); aliases must identify exactly one investor","minLength":1,"maxLength":200},"period":{"type":"string","description":"Reporting period like '2024Q4' or '2024-12'. Omit for latest."},"sortBy":{"type":"string","enum":["value","shares","name"],"description":"Sort order for holdings. Default: 'value' (largest positions first)."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Return only top N positions. Omit to get up to 30 positions."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["slug"]},"annotations":{"title":"Get investor holdings","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_investor_activity","title":"Get investor activity","description":"Get an investor's buy/sell activity for a specific period. Shows new positions, increases, decreases, and exits with split-adjusted share changes and percentages. Repeat adjustment_note when present. Can filter by change type. Returns byte-bounded pages (default 20, maximum 100 requested rows); follow nextOffset with identical slug/period/filters.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Investor slug, CIK digits (leading zeros accepted), or unique exact case-insensitive investor/manager name, including its lowercase hyphenated slugified form (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted)","minLength":1,"maxLength":200},"period":{"type":"string","description":"Reporting period like '2024Q4'. Omit for latest."},"changeType":{"type":"string","enum":["NEW","INCREASED","DECREASED","SOLD"],"description":"Filter to only show a specific type of activity."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."},"offset":{"type":"integer","minimum":0,"description":"Default 0; follow nextOffset with the same arguments."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum rows requested; byte-bounded pages may contain fewer. Follow nextOffset."}},"required":["slug"]},"annotations":{"title":"Get investor activity","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_investor_periods","title":"Get investor periods","description":"Get all available reporting periods for an investor, ordered most recent first. Unique whole-word abbreviations such as pershing-square and tiger-global are accepted; unknown or ambiguous identifiers return candidates.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Investor slug, CIK digits (leading zeros accepted), or unique exact case-insensitive investor/manager name, including its lowercase hyphenated slugified form (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted)","minLength":1,"maxLength":200},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["slug"]},"annotations":{"title":"Get investor periods","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_security_detail","title":"Get security detail","description":"Get detailed information about a security (stock/bond) including current owners among tracked investors with their share counts and values, quarterly ownership history (owner count and total shares over time), and recent buy/sell activity across all investors. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"tickerOrCusip":{"type":"string","description":"Stock ticker (e.g. 'AAPL', 'GOOGL'), CUSIP or stable security ID (s-123)"},"period":{"type":"string","description":"Reporting period. Omit for latest."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["tickerOrCusip"]},"annotations":{"title":"Get security detail","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_market_overview","title":"Get market overview","description":"Get a market-wide overview of recent activity among tracked investors. View 'by_security' shows the most actively traded stocks (buyer/seller counts and names). View 'by_investor' shows the latest trading activity grouped by investor with their top position changes. Repeat adjustment_note when present. Follow nextOffset as offset with the same filters to continue.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"view":{"type":"string","enum":["by_security","by_investor"],"description":"How to group the data. 'by_security' for trending stocks, 'by_investor' for recent activity per investor. Default: 'by_security'."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Number of results to return (default 10, maximum 50)"},"period":{"type":"string","description":"Reporting period like '2024Q4'. Omit for latest."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":[]},"annotations":{"title":"Get market overview","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"screen_stock_consensus","title":"Screen stock consensus","description":"Screen stocks by material quarterly activity among tracked investors. Default ranking is the weighted score (2*NEW + INCREASED - DECREASED - 2*SOLD), reversed for side sell. Use sortBy: \"buyers\" to answer which stocks did the most funds buy/add; sellers ranks fund sellers and net_value ranks net estimated dollars in the side direction. sortBy is available on every plan, including free and anonymous/demo. Counts and dollar figures are recalculated from only the requested investor styles. Valid investor_style keys: value, quality, growth, activist, macro, special. Follow nextOffset as offset with the same filters to continue.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"period":{"type":"string","description":"Reporting period like '2026Q2'. Omit for the latest substantially complete quarter."},"side":{"type":"string","enum":["buy","sell"],"description":"Default: buy."},"sortBy":{"type":"string","enum":["score","buyers","sellers","net_value"],"description":"Default: score. Available on every plan; preserves plan row caps."},"min_investors":{"type":"integer","minimum":1,"maximum":10},"investor_style":{"type":"array","items":{"type":"string","enum":["value","quality","growth","activist","macro","special"]},"uniqueItems":true,"description":"Optional primary investor styles to include (OR semantics)."},"limit":{"type":"integer","minimum":1,"maximum":20},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":[]},"annotations":{"title":"Screen stock consensus","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search","title":"Search","description":"Search for investors by name, manager, slug, fund ticker or alias (at least two characters), and securities by ticker/issuer name. One-character security queries are supported; investor matching is explicitly skipped. Returns investor matches with their latest period, portfolio value, and their role — 'firm' (files a 13F for a fund family), 'fund' (one N-PORT series, with parentSlug naming its firm) or 'investor' (standalone). A person or firm name selects the firm; a fund name or ticker selects that fund. Security matches carry the current owner count among tracked investors. Use this to find the correct slug or ticker before looking up details. Follow nextOffset as offset with the same filters to continue.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"query":{"type":"string","description":"Search query (e.g. 'Buffett', 'AAPL', 'Apple')"},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["query"]},"annotations":{"title":"Search","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_position_history","title":"Get position history","description":"Track how a specific investor's position in a security has changed over time. Returns a chronological timeline of shares, value, effective share delta/percentage, activity type (NEW, INCREASED, DECREASED, SOLD, UNCHANGED), and adjustment_note for each reporting period. Returns byte-bounded history pages (default 20, maximum 100 requested rows); follow nextOffset. Use this for questions like 'How has Buffett's AAPL position changed over the years?' Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Investor slug, CIK digits (leading zeros accepted), or unique exact case-insensitive investor/manager name, including its lowercase hyphenated slugified form (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted)","minLength":1,"maxLength":200},"tickerOrCusip":{"type":"string","description":"Stock ticker (e.g. 'AAPL') or CUSIP identifier"},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."},"offset":{"type":"integer","minimum":0,"description":"Default 0; follow nextOffset with the same arguments."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum rows requested; byte-bounded pages may contain fewer. Follow nextOffset."}},"required":["slug","tickerOrCusip"]},"annotations":{"title":"Get position history","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"compare_investors","title":"Compare investors","description":"Compare 2–6 investors in one common or requested period. Returns portfolio totals, a shared holdings matrix with split-adjusted quarter changes, pairwise overlaps, and unique top holdings. Missing investors and capped results are labelled. For one security across managers, use get_security_holders; resolve_company resolves company identifiers. Follow nextOffset as offset with the same filters to continue.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"slugs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"minItems":2,"maxItems":6,"description":"Investor slugs, CIK digits (leading zeros accepted), or unique exact case-insensitive investor/manager names, including their lowercase hyphenated slugified forms (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted)"},"slug1":{"type":"string","description":"Deprecated first investor slug/CIK/unique name (use slugs)"},"slug2":{"type":"string","description":"Deprecated second investor slug/CIK/unique name (use slugs)"},"period":{"type":"string","pattern":"^[0-9]{4}(Q[1-4]|-(0[1-9]|1[0-2]))$","description":"Reporting quarter or month; omit for latest common quarter"},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["slugs"]},"annotations":{"title":"Compare investors","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_security_holders","title":"Get security holders","description":"Show tracked investors holding a security, their filing-reported value, portfolio weight, period-end shares, split-adjusted quarter action, and first-seen period. Includes portfolioWeightPct (percent of selected long-stock book; derivatives/shorts excluded), portfolioRank (1 = largest stock position; securityId breaks value ties; exits rank null), holdersAtPeriodEnd and exitedThisPeriod counts. totalCount counts matching rows including exits before paging; population counts and totals precede changeType filtering. Optional changeType filters admitted actions before paging on every plan; this is a per-security row filter, not a screener filter. Includes exits and totals across the family aggregate universe. Optionally restrict to investor slugs and a reporting period. Use resolve_company to resolve company identifiers. Follow nextOffset as offset with the same filters to continue. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"ticker":{"type":"string","minLength":1,"maxLength":100,"description":"Ticker, CUSIP, or s-123 security identifier"},"period":{"type":"string","pattern":"^[0-9]{4}(Q[1-4]|-(0[1-9]|1[0-2]))$","description":"Reporting quarter or month; omit for the newest 75%-covered consensus quarter"},"changeType":{"type":"string","enum":["NEW","INCREASED","DECREASED","SOLD"],"description":"Optional admitted quarter-action row filter, on every plan; applied before paging."},"slugs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"pattern":"\\S"},"minItems":1,"maxItems":12,"description":"Restrict to investor slugs, CIK digits (leading zeros accepted), or unique exact case-insensitive investor/manager names, including their lowercase hyphenated slugified forms (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted) (up to 12); family aggregate representatives only"},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum returned investors (default 25)"},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["ticker"]},"annotations":{"title":"Get security holders","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_investor_summary","title":"Get investor summary","description":"Get a lightweight portfolio summary for an investor: stock total value, stock position count, top 5 holdings, and concentration metrics (top 5 and top 10 as % of total). Derivative positions (PUT/CALL options, note principal) come back in a separate labelled `derivatives` block whose values are 13F reported values (usually the underlying's notional for options) — never add them to totalValue and never derive a combined weight. Use this for quick overview questions instead of fetching all holdings.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Investor slug, CIK digits (leading zeros accepted), or unique exact case-insensitive investor/manager name, including its lowercase hyphenated slugified form (punctuation dropped; terminal legal suffix optional; unique whole-word prefixes/subsequences such as pershing-square accepted)","minLength":1,"maxLength":200},"period":{"type":"string","description":"Reporting period. Omit for latest."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["slug"]},"annotations":{"title":"Get investor summary","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"resolve_company","title":"Resolve company","description":"Resolve a company name or ticker to candidate companies with filings/financials. Returns ticker, name, CIK, and whether each has financial data and filing text. Use this FIRST when the user names another company (e.g. 'Microsoft', 'compare with MSFT') to get the ticker before calling the other filing/financials tools. Follow nextOffset as offset with the same filters to continue.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default 0. Repeat with nextOffset and identical filters to continue."},"query":{"type":"string","maxLength":200,"description":"Company name or ticker (e.g. 'Microsoft', 'MSFT', 'Apple')"},"includeInactive":{"type":"boolean","description":"Also return companies with no SEC CIK (delisted shells, 13F-only issuers). Default false."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["query"]},"annotations":{"title":"Resolve company","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_company_filings","title":"List company filings","description":"List company filings newest filing date first, with accession, items, AI headline, hasSummary, hasText, hasStatements and EDGAR sourceLink. Default: 10-K/10-Q/20-F, 8-K/6-K and DEF 14A, including amendments. Optional formTypes filters exact SEC forms; other forms (e.g. 424B4, S-1, S-3) are listed only when requested. Full text covers periodic 10-K/10-Q/20-F; 8-K/6-K have AI summaries and DEF 14A has proxy extractions, when available. Other forms are listed only. Follow nextOffset; reporting period and filing date differ. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"formTypes":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":40},"description":"Exact SEC forms, e.g. [\"8-K\"], [\"DEF 14A\"], [\"10-K\",\"10-Q\"]. Include amendments explicitly, e.g. \"8-K/A\". Omit for periodic + events + proxy."},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":30},"ticker":{"type":"string","description":"Stock ticker, CUSIP or stable security ID (s-123)"},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["ticker"]},"annotations":{"title":"List company filings","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_filing_summary","title":"Get filing summary","description":"Get an 8-K/6-K AI event summary (items, headline, bullets, EDGAR sourceLink), a DEF 14A proxy extraction (CEO/NEO compensation, say-on-pay and other available topics), or a periodic 10-K/10-Q/20-F summary. Supply an accession from list_company_filings for events/proxies. Other forms are listed only. Full text is available only for periodic filings, via read_filing_section. Periodic response: a filing-level summary (headline, tl;dr, highlights, changes vs prior, watch items) plus each section's headline, bullet points, and its (part, sectionId) address. Does NOT include the raw section text — use read_filing_section for that. Omit accession to get the latest periodic filing. Use this to answer or expand on a summary the user is reading, and to discover section ids (part, sectionId) before reading raw text. Before a single-company valuation conclusion, select the newest 10-Q accession from list_company_filings; state unavailable coverage. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"ticker":{"type":"string","description":"Stock ticker, CUSIP or stable security ID (s-123)"},"accession":{"type":"string","description":"Filing accession number (from list_company_filings). Omit for the latest periodic filing; provide an accession for an event or proxy."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["ticker"]},"annotations":{"title":"Get filing summary","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"read_filing_section","title":"Read filing section","description":"Read the raw text of one filing section (e.g. MD&A, Risk Factors). This is the grounding tool: use it to verify or quote what a filing actually says before making a factual claim about its language. Use the (accession, part, sectionId) from get_filing_summary or search_filing_text. Common sectionId aliases such as 3, Item 3, and Item 7A are accepted; missing sections return availableSections for that accession. Pages contain about 12,000 characters. Follow nextOffset as offset with the same address and omit find to read on. Optional literal find locates a paragraph at or after offset; found:false explicitly means no occurrence at or after offset and returns the ordinary page plus up to eight suggestions (matching headings/short lines with character offsets). Offsets index stored text characters. Before downgrading a claim absent from structured notes, read the relevant Risk Factors and MD&A here and name the section read; absence from notes is not absence from the filing. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"ticker":{"type":"string","description":"Stock ticker, CUSIP or stable security ID (s-123)"},"accession":{"type":"string","description":"Filing accession number"},"part":{"type":"string","description":"SEC Part the section belongs to ('I'..'IV')"},"sectionId":{"type":"string","description":"Section id, or alias such as 3, Item 3, 1A or Item 7A; discover ids with get_filing_summary"},"offset":{"type":"integer","minimum":0,"description":"Character offset; default 0. Pass nextOffset to continue."},"find":{"type":"string","minLength":1,"description":"Literal case-insensitive phrase; starts at its paragraph, searching at or after offset. Omit when continuing. If the phrase is not found, suggestions list matching headings/short lines and character offsets."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["ticker","accession","part","sectionId"]},"annotations":{"title":"Read filing section","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search_filing_text","title":"Search filing text","description":"Full-text keyword search over a company's filing sections. Returns ranked matches with separate highlighted snippets[] passages and the (accessionNumber, part, sectionId) to read. Compatibility snippet separates passages with [Separate passage]; never treat them as adjacent text. Use read_filing_section find with a literal snippet phrase (without highlight tags) to locate it. Follow nextOffset as offset with identical query/accession for more matches. Use this to locate where a topic or phrase is discussed in the filings when you don't already know the section. Keyword-based, so use concrete terms from the filing; for numeric values use get_company_financials instead. Optionally scope to one filing by accession. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates.","inputSchema":{"type":"object","properties":{"ticker":{"type":"string","description":"Stock ticker, CUSIP or stable security ID (s-123)"},"offset":{"type":"integer","minimum":0,"description":"Match offset; default 0. Follow nextOffset."},"query":{"type":"string","description":"Keywords to search for (e.g. 'supply chain', 'goodwill impairment')"},"accession":{"type":"string","description":"Limit the search to one filing. Omit to search all of the company's filings."},"resultPath":{"type":"string","description":"Nested overflow recovery: use the exact resultContinuations call returned by this tool (JSON pointer)."},"resultOffset":{"type":"integer","minimum":0,"description":"Offset within resultPath; copy from resultContinuations. Keep the original request arguments."}},"required":["ticker","query"]},"annotations":{"title":"Search filing text","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_company_financials","title":"Get company financials","description":"Get reported financial metrics (revenue, pretax income, income tax expense, interest expense (deposit/funding cost for banks), share-based compensation, R&D, SG&A, derived EBIT, margins, EPS, cash flow, balance-sheet items, etc.) from XBRL filings, by period. Use this for standardized metrics; use read_statement for other reported table values. Never state a figure from memory or infer it from a summary. Returns annual, quarterly or explicitly requested TTM data with definitions, units, currency, missing reasons, derivation and source links. Filter with 'metrics' to keep the answer focused; use 'periodType' and 'limit' to control how many periods come back. For valuation, check quarterly rows after the annual basis and compare the newest quarter year over year; identify the fiscal-year or trailing-quarter basis and price date of every ratio. Company identifiers accept verified share-class variants (BRK-B, BRK/B, BRK B, brk.b → BRK.B); normalized inputs echo resolvedTicker. Unknown identifiers return a repairable error with up to five resolve_company candidates. Metric aliases: cash_and_equivalents/cash_equivalents→cash, total_revenue/sales→revenue, net_profit→net_income, capital_expenditures→capex, fcf→free_cash_flow, eps→eps_diluted, buybacks→share_repurchases. Aliases echo resolvedMetrics. Unavailable balance-sheet metrics point to list_statements query balance, then read_statement.","inputSchema":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"from":{"type":"string","description":"Earliest period end, YYYY-MM-DD"},"to":{"type":"string","description":"Latest period end, YYYY-MM-DD"},"ticker":{"type":"string","description":"Stock ticker, C

# --- truncated at 32 KB (51 KB total) ---
# Full source: https://artifacts.apis.io/filingspy-com/examples/filingspy-com-mcp-tools-list.json