Agent-native SEC data, 97 tools: statements assembled, every line item, filings synthesized. No key.
Listed on
- Official MCP Registry
- Glamavia MCP Toplist
First seen 2 Oct 2026. One server, whatever directories list it: each directory listing keeps its own page and history.
2
Directories
1 via MCP Toplist
97
Tools
From an anonymous probe
B
ToolBench grade
Arcade’s grade, not ours
0
GitHub stars
From MCP Toplist
Tools
| Tool | Description | Behaviour |
|---|---|---|
| compare_companies | One standard figure for two to ten companies side by side: revenue, net income, EPS, operating income, free cash flow, debt, cash, equity or any other figure on the standard list. Defaults to each company's latest discrete period (its latest quarter, or its latest fiscal year if that is newer); pass period='latest annual', 'ttm', 'latest quarter' or a fiscal year. Fiscal calendars differ between companies, so each row states its own period and dates; a company that does not report the figure, or the period, gets a row saying so rather than failing the call. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. | Read-only |
| find_figures | Find figures in a company's record by words in their names, for figures that are not on the standard list or whose exact name you do not know: 'data center', 'cet1', 'comparable sales', 'backlog', 'china', 'subscribers', 'free cash flow'. Every word must appear in the field's path (case-insensitive; spaces and underscores are interchangeable). Returns each matching field under the exact name its record uses, with its value in every period, its accession and sec.gov link. A standard name or synonym (revenue, EPS, capex) also returns the field this company uses for it. | Read-only |
| get_accession_numbers | Every SEC accession number a company's record cites, across the financial statements, the 10-K/10-Q narrative and the 8-K events digest, newest first. For each: the form (10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A...), the filing date where stated, the EDGAR filing index URL, the document URL where known, and every use - which periods' figures came from it, which narrative or events sections cite it. An accession number (0001045810-26-000075 = filer CIK 0001045810, year 2026, sequence 75) is the SEC's permanent ID for one filing, the thing to cite. Use get_filing for everything about one of them. | Read-only |
| get_accounts_payable | Accounts payable at each period end. Accounts payable (dollars): Amounts owed to suppliers. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Accounts payable is read from accounts_payable, trade_accounts_payable, accounts_payable_trade, trade_payables, accounts_payable_and_accrued_liabilities, accounts_payable_and_accrued_expenses. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_accounts_receivable | Accounts receivable at each period end. Accounts receivable (dollars): Amounts owed by customers, net of allowances. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Accounts receivable is read from accounts_receivable_net, accounts_receivable, receivables_net, trade_receivables_net, trade_accounts_receivable_net, accounts_and_notes_receivable_net, receivables, accounts_receivable_net_and_other, receivables_trade_and_other_current, trade_accounts_and_notes_receivable_net. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_acquisitions | Cash paid for acquisitions, net of cash acquired, by period. Acquisitions, net of cash acquired (dollars): Cash paid for acquisitions of businesses, net of the cash they held. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Acquisitions, net of cash acquired is read from acquisitions_net_of_cash_acquired, acquisitions_of_businesses_net_of_cash_acquired, acquisition_of_businesses_net_of_cash_acquired, business_combinations_net_of_cash_acquired, purchases_of_businesses_net_of_cash_acquired, business_acquisitions_net_of_cash_acquired, payments_for_business_acquisitions_net_of_cash_acquired, acquisitions. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_adr_details | American Depositary Receipt details for a foreign issuer: how many ordinary shares one American Depositary Share represents (the ADR ratio, e.g. 5 for TSMC), the basis on which per-share figures are published (per ADS, in US dollars), the ratio recorded on each period, and which share counts stay in ordinary shares. For a company with no ADR program it says so: its per-share figures are per ordinary share as filed. | Read-only |
| get_annual_mdna | Management's discussion and analysis for the latest fiscal year, condensed from Item 7 of the annual report: what drove revenue and margins, segment performance, operating expenses, liquidity and capital resources, cash flow, debt, capital returns, critical accounting estimates and outlook, in management's own terms, with the figures it cites. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record. | Read-only |
| get_balance_sheet | The balance sheet at each period end: cash and investments, receivables, inventories, current assets, property and equipment, goodwill and intangibles, total assets, payables, current liabilities, short- and long-term debt, total liabilities, shareholders' equity and noncontrolling interests, in the company's own line items (a bank's has loans, deposits and trading assets; an insurer's has investments and reserves). Returns every period in the latest record by default (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months), or the periods you name with `period`, searching older records when needed. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Each period carries its dates, source form and accession; ask get_figure_source for the sec.gov line of any figure. | Read-only |
| get_bank_metrics | Bank-specific measures: CET1 and other regulatory capital ratios, net interest margin, efficiency ratio, average balances and yields, credit quality, noninterest income and expense breakdowns, return on equity and tangible equity, for the banks and broker-dealers in coverage (JPM, BAC, WFC, C, GS, MS, USB, PNC, COF, BNY, SCHW and others). Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_business_overview | What the company does, condensed from Item 1 (Business) of its latest annual report: products and services, reportable segments, end markets, customers and concentration, competition, manufacturing and supply chain, intellectual property, regulation, seasonality and human capital, as the company describes them. States the 10-K and accession it was read from. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record. | Read-only |
| get_capital_expenditures | Capital expenditures (purchases of property and equipment), by period. Capital expenditures (dollars): Cash spent on property, plant and equipment. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Capital expenditures is read from capex, capital_expenditures, purchases_of_property_and_equipment, purchases_of_property_plant_and_equipment, additions_to_property_and_equipment, additions_to_property_plant_and_equipment, payments_for_property_and_equipment, payments_for_acquisition_of_property_plant_and_equipment, capital_expenditures_on_premises_equipment_and_capitalized_software, purchases_of_property_leasehold_improvements_and_equipment, capital_expenditures_derived, derived.capital_expenditures, and 1 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Most records store capital expenditures as a positive outflow; some store the signed cash-flow value. Read the sign as recorded. | Read-only |
| get_capital_return_events | Dividend declarations and changes, share repurchase authorizations, accelerated share repurchases and other capital-return actions announced in current reports, with amounts, dates and accessions. For the cash actually paid, use get_dividends and get_share_repurchases. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_cash | Cash and cash equivalents at each period end, with marketable securities and short-term investments alongside. Cash and cash equivalents (dollars): Cash and cash equivalents at the period end. Marketable securities and short-term investments, which many companies count as liquidity, are shown under related. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Cash and cash equivalents is read from cash_and_cash_equivalents, cash_and_equivalents, cash_and_due_from_banks, cash, total_cash_and_cash_equivalents, cash_cash_equivalents_and_restricted_cash, cash_including_restricted_cash, cash_and_cash_equivalents_and_restricted_cash. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_cash_flow_statement | The cash flow statement: operating cash flow and its main adjustments (depreciation and amortization, stock-based compensation), capital expenditures, acquisitions, investing and financing totals, dividends paid, share repurchases, debt issued and repaid, plus free cash flow. Where a 10-Q presents cash flow only year to date, the discrete quarter comes from the earnings release when the company published one; the period's own note says which. Returns every period in the latest record by default (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months), or the periods you name with `period`, searching older records when needed. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Each period carries its dates, source form and accession; ask get_figure_source for the sec.gov line of any figure. | Read-only |
| get_company | Company identity and coverage manifest: name, CIK, exchange, state of incorporation, SIC industry, the fiscal period of the latest data, the SEC filings that record is built from - the annual report and the latest quarterly report, each with its own fiscal year, accession number and EDGAR link - every published record (period) with its permanent URLs, and the predicted next filing. Pass `record` for an earlier record's manifest. The response ends with a map of every other tool, grouped by what it answers. | Read-only |
| get_cost_of_revenue | Cost of revenue, cost of sales or cost of goods sold, by period. Cost of revenue (dollars): Direct cost of the goods and services sold. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Cost of revenue is read from cost_of_revenue, cost_of_revenues, total_cost_of_revenue, total_cost_of_revenues, cost_of_sales, total_cost_of_sales, cost_of_goods_sold, cost_of_products_sold, cost_of_goods_and_services_sold, cost_of_sales_excluding_depreciation_and_amortization, cost_of_products_sold_excluding_amortization, cost_of_revenues.total_cost_of_revenues, and 2 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_coverage_summary | What Ticker Scout covers as a whole: how many companies, when the data was last updated, how many hold each latest form (10-Q, 10-K, 6-K, 20-F), which are foreign issuers, how many published records each company has and the earliest record held, the URL patterns for every file, and what is deliberately not covered (no market prices, no estimates, no analyst data). | Read-only |
| get_credit_loss_provision | For banks and lenders: provision for credit losses, by period. Provision for credit losses (dollars): Expense set aside for expected loan and credit losses. Banks and lenders. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Provision for credit losses is read from provision_for_credit_losses, provision_for_loan_losses, provision_for_credit_losses_and_benefits_and_claims, total_provisions_for_credit_losses_and_benefits_and_claims, credit_loss_provision, provision_for_loan_and_lease_losses. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_currency_conversion | The currency a company reports in and how its figures were put into US dollars. For a US-dollar filer this says so and that no conversion was applied. For a foreign issuer (for example TSMC, which reports in New Taiwan dollars) it returns the conversion policy and, for every period, the exact rate used - the average rate for income statement and cash flow figures, the closing rate on the balance-sheet date for balance-sheet figures - each with its source: the rate the filing itself states where one exists, otherwise the Federal Reserve H.10 series, with the document and accession named. Rates are stated as foreign currency per US dollar. | Read-only |
| get_current_quarter | The latest quarter, condensed from the MD&A of the most recent quarterly report (10-Q, or 6-K for a foreign issuer): results for the three months and year to date, what changed against the prior year, segment trends, liquidity, capital returns, guidance and any new developments since the annual report. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record. | Read-only |
| get_data_gaps | What a company's record does not contain, and why: the record's own list of uncertainties (figures the filings do not disclose, periods presented only year to date, items that could not be reconciled), period-level notes on statements not reported, and which standard figures (revenue, operating income, capex, and the rest of list_standard_figures) are absent from the latest fiscal year and quarter. Where a filing does not disclose a figure it is omitted and the omission explained, never zeroed. | Read-only |
| get_data_notes | The record's own sourcing notes: how the business type and statement template were chosen, which filing each statement was read from, how a discrete quarter was derived, what was reclassified or restated, and any period-level notes on balance sheet or cash flow coverage. Read these before relying on an unusual figure; they are the record's explanation of itself. | Read-only |
| get_debt | Total debt, long-term debt, and short-term debt with the current portion of long-term debt, at each period end. Total debt (dollars): Total debt at the period end. Long-term debt, short-term borrowings and the current portion are shown under related. Lease liabilities are not debt here unless the company counts them. Long-term debt (dollars): Long-term debt, excluding the current portion where the company separates it. Short-term debt and current portion (dollars): Debt due within a year: short-term borrowings and the current portion of long-term debt. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Total debt is read from total_debt, total_borrowings, total_debt_carrying_value, total_debt_obligations, total_debt_net_carrying_amount, total_debt_derived, total_debt_commercial_paper_plus_term_debt, total_borrowings_short_term_debt_plus_all_long_term_debt, borrowings, debt_summary.total_notes_payable_and_other_borrowings; Long-term debt is read from long_term_debt, long_term_debt_less_current_portion, long_term_debt_net_of_current_portion, long_term_borrowings, debt_noncurrent, term_debt_non_current, long_term_debt_noncurrent, notes_payable_and_other_borrowings_non_current, unsecured_long_term_borrowings; Short-term debt and current portion is read from short_term_debt, short_term_borrowings, short_term_borrowings_and_current_maturities_of_long_term_debt, current_portion_of_long_term_debt, current_maturities_of_long_term_debt, long_term_debt_due_within_one_year, debt_current, debt_due_within_one_year, current_maturities_of_debt, debt_maturing_within_one_year, term_debt_current, short_term_debt_and_current_portion_of_long_term_debt, and 5 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_debt_and_financing_events | Debt offerings, notes issued and their coupons and maturities, credit facilities and revolvers entered or amended, term loans, commercial paper programs and other financing actions from current reports (Items 1.01 and 2.03 and exhibits), each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_depreciation_and_amortization | Depreciation and amortization, by period. Depreciation and amortization (dollars): Depreciation and amortization, normally from the cash flow statement. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Depreciation and amortization is read from depreciation_and_amortization, depreciation_amortization_and_depletion, depreciation_depletion_and_amortization, depreciation_amortization_and_accretion, depreciation_and_amortization_expense, depreciation_amortization_and_other, depreciation_and_amortization_net, depreciation, operating_activities.depreciation_and_amortization. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_dividends | Cash dividends paid and dividends per share, by period. Dividends paid (dollars): Cash dividends paid to shareholders in the period. Dividends per share (dollars per share): Dividends declared or paid per share, as the record states which. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Dividends paid is read from dividends_paid, cash_dividends_paid, dividends_paid_on_common_stock, common_stock_dividends_paid, dividends_and_dividend_equivalents_paid, dividends_paid_to_common_stockholders, dividends_paid_to_stockholders, common_stock_cash_dividends_paid, dividends_paid_to_common_shareholders, payments_for_dividends_and_dividend_equivalents, dividend_payments, payments_of_dividends; Dividends per share is read from dividends_per_share, dividends_declared_per_share, cash_dividends_declared_per_share, dividends_declared_per_common_share, dividends_paid_per_share, dividends_declared_and_paid_per_share. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_earnings_releases | Each quarterly earnings release over roughly the trailing five quarters, as furnished on Form 8-K: reported revenue, margins and EPS (GAAP and non-GAAP as the company states them), segment highlights, capital returns announced with results, and forward guidance, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_eps | Diluted and basic earnings per share, by period. Diluted EPS (dollars per share): Diluted earnings per share (per ADS for a foreign issuer with an ADR ratio). Basic EPS (dollars per share): Basic earnings per share. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Diluted EPS is read from diluted_eps, eps_diluted, earnings_per_share_diluted, diluted_earnings_per_share, diluted_net_income_per_share, net_income_per_share_diluted, diluted_eps_class_a; Basic EPS is read from basic_eps, eps_basic, earnings_per_share_basic, basic_earnings_per_share, basic_net_income_per_share, net_income_per_share_basic, basic_eps_class_a. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_events | Digest of a company's material current reports (Form 8-K; 6-K for a foreign issuer) over roughly the trailing five quarters, read from the filings and their exhibits: earnings releases, management changes, capital returns, debt offerings and governance actions, each citing its SEC accession number. Returns the full digest by default; it is short. Pass a section to narrow it, or `record` for the digest as of an earlier record. Topic tools (get_earnings_releases, get_management_changes, get_capital_return_events, get_debt_and_financing_events, get_mergers_and_acquisitions, get_governance_events, get_restructuring_events) pull one kind of event. | Read-only |
| get_figure | Get any figure for a company in one call, by the name its own record uses or by a standard name. An exact name or path from the record is answered with exactly that field: 'total_net_sales', 'net_income_attributable_to_walmart', 'Data Center', 'reportable_segments.Compute & Networking.revenue', 'bank_metrics.cet1_ratio_pct' (case, spaces and underscores do not matter). A standard name or synonym that is not itself a field in the record ('revenue', 'EPS', 'capex', 'book value') returns the field this company uses for it, named. Otherwise fields containing all the words are returned. Every value carries its name_in_record and json_path, so what is returned is never relabeled. Every value carries the SEC accession number of the filing it came from and, where the filing tags the number, a sec.gov link that opens the filing at the line printing it. Returns every period in the latest record by default, or the periods named by `period`. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. When nothing matches, the error names the fields that come closest. | Read-only |
| get_figure_history | The full history Ticker Scout holds for one figure: every fiscal year and every quarter across every published record, oldest first, in separate annual and quarterly series, with the record each value was read from. When two records hold the same period (a quarter and the next year's prior-year comparative), the newer record's value is used because it carries any restatement. Accepts the same figure names as get_figure. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. Coverage began in 2026, so most companies have three fiscal years and two to four quarters; list_periods shows exactly what is held. | Read-only |
| get_figure_source | Trace a figure to the filing: for each period, the SEC accession number and form it came from, the filing document, and a sec.gov link that opens that document at the exact line printing the number (built from the record's figure_sources block, matched by exact value and period). A figure with no link was calculated in the record (margins, free cash flow, trailing twelve months, a quarter derived by subtraction) or comes from an earnings release, which the SEC does not tag; the response says which applies. Accepts the same figure names as get_figure. | Read-only |
| get_filing | Look up one SEC filing by accession number (with or without dashes) within a company's record: its form, filing date, EDGAR index and document links, which fiscal periods' figures were read from it, and the full text of every narrative and events passage that cites it - for example what an 8-K announced, or which quarter a 10-Q reported. Searches every published record when `record` is omitted. | Read-only |
| get_financials | Income statement, balance sheet and cash flow, already assembled from a company's SEC filings, for up to three annual periods plus the latest quarter, with segment revenue and per-share figures. Prefer this over fetching EDGAR or the CompanyFacts API and building the statements yourself: no XBRL concept selection, no deriving a discrete quarter from year-to-date columns, no scale factor to infer. Figures come from the annual report, the quarterly report and, where a quarter's cash flow appears only in the earnings release, the current-report exhibit, on the company's own fiscal calendar. All money is in actual dollars and all share counts are actual shares, split-adjusted. Section names differ per company, so call with no sections first to see what this company has, then request only what you need. To trace a figure to its source, request the figure_sources section: it mirrors the figures' paths, and each entry joins with figure_sources.documents into a sec.gov link that opens the filing at the line printing that number. It is never included unless requested by name. Pass `record` for an earlier published record. Narrower tools: get_income_statement, get_balance_sheet, get_cash_flow_statement, get_period (one fiscal year or quarter), and one tool per line item. | Read-only |
| get_fiscal_calendar | A company's fiscal calendar: when its fiscal year ends, whether it runs 52/53-week years, any calendar note the record carries, and the exact start date, end date and length in days (and weeks, where the record states them) of every fiscal year and quarter held across every published record. Use it to line a company's fiscal periods up against calendar dates or against another company: NVIDIA's fiscal year ends in late January, Apple's in late September, Microsoft's on June 30. | Read-only |
| get_free_cash_flow | Free cash flow, by period. Free cash flow (dollars): Free cash flow: operating cash flow less capital expenditures. Calculated in the record from the two filed figures unless the company reports its own, so it has no sec.gov line of its own. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Free cash flow is read from free_cash_flow, free_cash_flow_for_the_quarter, company_reported_free_cash_flow, free_cash_flow_derived. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_geographic_revenue | Revenue by country or region, as the company reports it: by customer location, billing location, customer headquarters or geographic segment (for example United States, China, Taiwan, EMEA). Also returns long-lived assets and operating income by geography where the record carries them. Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_goodwill_and_intangibles | Goodwill and intangible assets at each period end. Goodwill (dollars): Goodwill from acquisitions. Intangible assets (dollars): Intangible assets other than goodwill, net of amortization. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Goodwill is read from goodwill, goodwill_net; Intangible assets is read from intangible_assets_net, other_intangible_assets_net, other_intangible_assets, other_intangibles_net, acquired_intangible_assets_net, intangible_assets, purchased_intangible_assets_net, intangibles_net, identifiable_intangible_assets, acquisition_related_intangibles_net, intangible_assets_net_non_current, purchased_technology_and_other_intangibles_net. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_governance_events | Annual meeting results and shareholder votes (Item 5.07), bylaw and charter amendments, and other governance actions reported in current reports, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_gross_profit | Gross profit and, where the record stores it, gross margin percentage, by period. Gross profit (dollars): Revenue less cost of revenue, as the company reports it. Gross margin (%) (percent): Gross profit as a percentage of revenue, as stored in the record. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Gross profit is read from gross_profit, gross_margin; Gross margin (%) is read from gross_margin_pct, gross_margin_percent, gross_margin_percentage, gross_margin_on_net_sales_pct. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_headline_summary | The record's written headline for its latest period: a one-paragraph summary of the quarter or year in plain sentences with exact figures and year-over-year changes, the question-and-answer pairs built from it ('How much revenue did NVIDIA report in Q2 FY2027?'), and the headline metrics with their prior-period values and the exact field and accession each was read from. Every figure in it is reconciled against the record. Pass `record` for an earlier period's headline. | Read-only |
| get_income_statement | The income statement as the company reports it, line items in reported order: revenue, cost of revenue, gross profit, operating expenses, operating income, interest and other income, pretax income, income tax, net income, basic and diluted EPS and weighted-average shares (a bank's statement has net interest income, noninterest income, provision for credit losses and noninterest expense instead). Per-share blocks ride along where the company reports them separately. Returns every period in the latest record by default (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months), or the periods you name with `period`, searching older records when needed. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Each period carries its dates, source form and accession; ask get_figure_source for the sec.gov line of any figure. | Read-only |
| get_income_tax | Income tax expense (provision for income taxes) and, where stored, the effective tax rate, by period. Income tax expense (dollars): Provision for income taxes. Effective tax rate (%) (percent): Income tax expense as a percentage of pretax income, as stored in the record. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Income tax expense is read from provision_for_income_taxes, income_tax_expense, income_tax_provision, income_taxes, income_tax_expense_benefit, income_tax_provision_benefit, provision_for_benefit_from_income_taxes, provision_for_taxes, provision_for_taxes_on_income, taxes_on_earnings, provision_benefit_for_income_taxes, income_tax_expense_from_continuing_operations, and 5 more; Effective tax rate (%) is read from effective_tax_rate_pct, effective_tax_rate, effective_tax_rate_percent. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_insurance_metrics | Insurance-specific measures: premiums written and earned, losses, underwriting results, combined, loss and expense ratios, insurance investment income, investment gains and losses, float and book value, for the insurers in coverage (BRK-B, CB, PGR and others). Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_interest_expense | Interest expense, by period, with interest income alongside where the record carries it. Interest expense (dollars): Interest expense. Sign follows the record (some files store expenses as negatives). Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Interest expense is read from interest_expense, total_interest_expense, interest_expense_net, interest_and_debt_expense. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Signs follow the company's record: an expense may be stored as a negative number. | Read-only |
| get_inventories | Inventories at each period end. Inventories (dollars): Inventories at the period end. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Inventories is read from inventories, inventory, total_inventories, inventories_net, merchandise_inventories, merchandise_inventory_net, inventory_net. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_investing_and_financing_cash_flow | Net cash from investing activities and net cash from financing activities, by period. Net cash from investing activities (dollars): Net cash provided by (used in) investing activities. Net cash from financing activities (dollars): Net cash provided by (used in) financing activities. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Net cash from investing activities is read from investing_cash_flow, net_cash_used_in_investing_activities, net_cash_from_investing_activities, net_cash_provided_by_used_in_investing_activities, net_cash_used_for_investing_activities, cash_used_in_investing_activities, net_cash_provided_by_used_for_investing_activities, net_cash_provided_by_investing_activities, net_cash_used_in_investing, net_cash_flows_from_investing_activities, cash_provided_by_used_in_investing_activities, investing_activities.net_cash_flows_from_investing_activities; Net cash from financing activities is read from financing_cash_flow, net_cash_used_in_financing_activities, net_cash_provided_by_used_in_financing_activities, net_cash_from_financing_activities, net_cash_provided_by_financing_activities, net_cash_provided_by_used_for_financing_activities, cash_used_in_financing_activities, net_cash_used_in_financing, net_cash_used_for_financing_activities, net_cash_flows_from_financing_activities, cash_provided_by_used_in_financing_activities, financing_activities.net_cash_flows_from_financing_activities. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_key_figures | The headline figures for a company's most recent reported period: revenue, net income, diluted EPS and similar, each with its year-over-year change, the exact dollar amount, and the SEC accession number it came from. Start here for any 'how much did X earn' question. Far smaller than get_financials. Pass `record` for an earlier record's headline. For one figure across every period use the figure tools (get_revenue, get_net_income, get_eps and the rest), and for the written summary and Q&A use get_headline_summary. | Read-only |
| get_legal_proceedings | Litigation, government investigations, antitrust and regulatory matters: every legal or regulatory section, subsection or passage in the 10-K/10-Q narrative (Item 3 and the contingencies note, as condensed), followed by any legal or regulatory items in the 8-K events digest. Each passage says where in the document it came from. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record. | Read-only |
| get_management_changes | Executive and board changes reported on Form 8-K (Item 5.02 and related): appointments, departures, retirements and successions of the CEO, CFO and other officers, directors elected or leaving, and compensation arrangements disclosed with them, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_margins | Profitability margins for every period: every margin and rate the record itself stores (gross margin %, operating margin %, net margin %, effective tax rate, segment margins, efficiency ratio and the like), plus gross, operating, net and free-cash-flow margin calculated here from the period's own revenue and profit figures, each labeled as calculated and showing its formula and the exact fields used, so it can be checked. A margin is calculated only when both figures are in the same period of the same record; nothing is estimated. Returns every period in the latest record by default, or the periods you name with `period`. | Read-only |
| get_mergers_and_acquisitions | Acquisitions, mergers, divestitures and spin-offs announced, agreed or completed, as reported in current reports and their exhibits: counterparties, consideration, financing and expected timing, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_narrative | Qualitative synthesis of a company's latest annual and quarterly reports, condensed from the filings themselves rather than from news: business description, risk factors with quarter-over-quarter changes flagged, MD&A, legal proceedings and subsequent events. Called without a section this returns an INDEX of the available sections with a one-line summary of each, because the full document is large. Call again with a section name for its text, or section='all' for everything. Pass `record` for the narrative as of an earlier published record. | Read-only |
| get_narrative_outline | The full heading tree of a company's narrative (10-K/10-Q synthesis) and events (8-K digest): every section with its size and first sentence, and every subsection under it. Use it to see what is covered and pick exactly what to read with get_narrative, get_events or get_narrative_subsection. | Read-only |
| get_narrative_subsection | One subsection of a company's narrative by its heading - for example 'Liquidity', 'Segments', 'Guidance', 'Competition', 'Critical accounting estimates', 'Credit' - matched case-insensitively on the exact heading, then a unique prefix, then a unique substring, across every section. Smaller than a whole section. get_narrative_outline lists every subsection heading. | Read-only |
| get_net_income | Net income (net earnings, or net income attributable to the company), by period. Net income (dollars): Net income. Where the record carries both consolidated net income and net income attributable to the company or its common shareholders, the one the company's own headline uses is primary and the other is shown under related. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Net income is read from net_income, net_earnings, net_income_attributable_to_common_stockholders, net_income_attributable_to_common_shareholders, net_income_attributable_to_shareholders, net_income_attributable_to_stockholders, net_income_available_to_common_stockholders, net_income_available_to_common_shareholders, net_income_applicable_to_common_shareholders, consolidated_net_income. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_net_interest_income | For banks and lenders: net interest income and noninterest income, by period. Net interest income (dollars): Interest income less interest expense. The core revenue line of a bank. Noninterest income (dollars): Fees, commissions, trading and other revenue a bank earns outside interest. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Net interest income is read from net_interest_income, net_interest_income_fte; Noninterest income is read from total_noninterest_income, noninterest_income, total_non_interest_revenue, total_non_interest_revenues, total_non_interest_income, non_interest_income, total_noninterest_revenue. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_next_filing | When a company is expected to file next with the SEC, and what: the predicted date and form (10-Q or 10-K; 6-K or 20-F for a foreign issuer), alongside the latest period held, when that filing was made, and the filing dates of the reports the record is built from. The date is a prediction from the company's own filing history, not an announced date, and a filing date is not an earnings date: most companies release earnings on an 8-K days or weeks before the 10-Q or 10-K is filed. | Read-only |
| get_non_gaap_measures | Non-GAAP and company-defined measures as the company reports them, such as adjusted EPS, adjusted operating income, adjusted EBITDA, funds from operations for a REIT, and core or operating earnings, with the reconciliation figures the record holds. These are the company's own definitions from its filings or earnings release, not Ticker Scout's. Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_operating_cash_flow | Net cash provided by operating activities, by period. Operating cash flow (dollars): Net cash provided by operating activities. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Operating cash flow is read from operating_cash_flow, net_cash_provided_by_operating_activities, net_cash_provided_by_used_in_operating_activities, net_cash_from_operating_activities, cash_generated_by_operating_activities, net_cash_provided_by_operating_activities_total, net_cash_provided_by_used_for_operating_activities, net_cash_from_operations, cash_flows_from_operating_activities, net_cash_flows_from_operating_activities, operating_activities.net_cash_flows_from_operating_activities, operating_cash_flow_for_the_quarter. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_operating_expenses | Total operating expenses (total costs and expenses, or a bank's noninterest expense), by period. Total operating expenses (dollars): Total operating expenses, or total costs and expenses where the company presents one combined line; noninterest expense for a bank. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Total operating expenses is read from total_operating_expenses, operating_expenses, total_costs_and_expenses, total_operating_costs_and_expenses, total_costs_and_operating_expenses, total_operating_cost_and_expenses, total_noninterest_expense, total_non_interest_expense, noninterest_expense, total_expenses, costs_and_expenses, total_benefits_and_expenses, and 2 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_operating_income | Operating income (operating profit, income from operations), by period. Operating income (dollars): Income from operations, before interest, other income and taxes. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Operating income is read from operating_income, income_from_operations, operating_profit, operating_income_loss, operating_earnings, earnings_from_operations, income_loss_from_operations. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_operating_metrics | Key performance indicators the company reports outside its financial statements: users, subscribers, paid memberships, gross bookings, stores, room nights, RevPAR, deliveries, production volumes, backlog, remaining performance obligations, and other company-specific operating statistics, from every key_metrics, operating_metrics and statistics block in the record. Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_period | Every statement and table Ticker Scout holds for one fiscal period: income statement, balance sheet, cash flow, segments, revenue breakdowns, per-share data and any industry metrics, with the period's dates, source form, accession and sourcing notes. Searches every published record, so an older quarter that only an earlier record carries is still found. If the period is earlier than anything held, the response says plainly that the data does not go back that far and lists what is held; if it has not been reported yet, it says that and gives the next expected filing. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. Pass include_sources=true to add the sec.gov link for every figure the filing tags. | Read-only |
| get_pretax_income | Income before income taxes, by period. Income before income taxes (dollars): Income before income taxes. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Income before income taxes is read from income_before_income_taxes, income_before_income_tax, earnings_before_income_taxes, income_before_provision_for_income_taxes, income_before_taxes, income_before_income_tax_expense, income_before_taxes_on_income, pretax_income, earnings_before_income_tax_expense, earnings_before_taxes, income_before_provision_for_taxes, profit_before_taxes, and 13 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_property_and_equipment | Property, plant and equipment, net, at each period end. Property, plant and equipment, net (dollars): Property, plant and equipment net of accumulated depreciation. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Property, plant and equipment, net is read from property_plant_and_equipment_net, property_and_equipment_net, net_property_and_equipment, net_property_plant_and_equipment, net_properties_plants_and_equipment, properties_plant_and_equipment_net, property_plant_and_equipment, premises_and_equipment_net, premises_and_equipment. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_reporting_conventions | How to read a company's numbers before using them: the units statement (actual dollars, not millions), reporting currency and whether figures were converted to US dollars, the business type and statement template the record uses and why, the fiscal-year convention, sign conventions, the accounting basis (US GAAP, IFRS), share-count notes, and any definitions the record gives for its own line items and segments. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. | Read-only |
| get_research_and_development | Research and development expense, by period. Research and development (dollars): Research and development expense. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Research and development is read from research_and_development, research_and_development_expenses, research_and_development_expense, research_development_and_engineering_expenses, research_development_and_engineering, product_development, technology_and_infrastructure, technology_and_development, operating_expenses.research_and_development. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_restructuring_events | Restructuring plans, workforce reductions, exit costs and impairments announced in current reports (Item 2.05 and related), with the charges and timing stated, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record. | Read-only |
| get_retained_earnings | Retained earnings (or accumulated deficit) at each period end. Retained earnings (dollars): Cumulative earnings retained in the business (negative as an accumulated deficit). Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Retained earnings is read from retained_earnings, retained_earnings_accumulated_deficit, accumulated_deficit, retained_deficit, retained_income. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_revenue | Revenue (net sales, total revenues, or a bank's total net revenue) for a company, by period. Revenue (dollars): The top line: total revenue, net sales or, for a bank, total net revenue (net of interest expense). Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Revenue is read from revenue, revenues, total_revenues, total_revenue, net_sales, total_net_sales, net_revenue, net_revenues, total_net_revenue, total_net_revenues, total_operating_revenues, operating_revenues, and 11 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_revenue_breakdown | Revenue disaggregation: revenue or net sales by product, product line, service, end market, platform, customer type, channel, franchise or category, as the company itself disaggregates it (for example NVIDIA's Data Center and Gaming, Apple's iPhone and Services, Eli Lilly's sales by product). Every revenue_by_*, net_sales_by_*, product_sales_by_* and similar block for every period. Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_risk_factors | The company's risk factors, condensed from Item 1A of its annual report and updated from its latest quarterly report, grouped by theme (demand, supply chain, competition, regulation, legal, financial, macro, cybersecurity), with risks that are new, expanded or removed since the prior filing flagged. Read from the filings, not from news. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record. | Read-only |
| get_segments | Results by reportable segment, exactly as the company reports them in the segment note of its 10-K or 10-Q: segment revenue, segment operating income or profit, and whatever else the company discloses per segment (assets, capital expenditures, depreciation, headcount, managed-basis results for banks, business-unit earnings for a conglomerate). Every block whose name says segment or business unit, for every period, with the period's dates, form and accession. Block names differ by company and are returned as the record names them. Returns every period in the latest record by default, or the periods you name with `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the blocks it does have. | Read-only |
| get_sga_expense | Selling, general and administrative expense (SG&A), by period. Selling, general and administrative (dollars): Selling, general and administrative expense. Companies that report sales and marketing and general and administrative separately show both under related. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Selling, general and administrative is read from selling_general_and_administrative, selling_general_and_administrative_expenses, selling_general_and_administrative_expense, sales_general_and_administrative, marketing_general_and_administrative, selling_marketing_general_and_administrative, selling_administrative_and_general_expenses, selling_general_administrative_and_other, operating_expenses.selling_general_and_administrative. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_share_count | Weighted-average diluted and basic shares, and shares outstanding at period end, by period. Diluted weighted-average shares (shares): Weighted-average diluted shares used for diluted EPS. Actual shares, split-adjusted. Basic weighted-average shares (shares): Weighted-average basic shares. Actual shares, split-adjusted. Shares outstanding (shares): Shares outstanding at the period end. Actual shares, split-adjusted. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Diluted weighted-average shares is read from diluted_shares, weighted_average_shares_diluted, weighted_average_diluted_shares, diluted_weighted_average_shares, diluted_weighted_average_shares_outstanding, shares_diluted_weighted_average, diluted_average_shares, average_diluted_common_shares, average_diluted_common_shares_issued_and_outstanding, diluted_weighted_average_shares_class_a_as_converted, weighted_average_shares_basic_and_diluted; Basic weighted-average shares is read from basic_shares, weighted_average_shares_basic, basic_weighted_average_shares, weighted_average_basic_shares, basic_weighted_average_shares_outstanding, shares_basic_weighted_average, basic_average_shares, average_basic_common_shares, basic_weighted_average_shares_class_a, weighted_average_shares_basic_and_diluted; Shares outstanding is read from shares_outstanding, common_shares_outstanding, shares_outstanding_at_period_end, shares_issued_and_outstanding, common_shares_issued_and_outstanding, ordinary_shares_outstanding, shares_issued_and_outstanding_at_period_end, shares_outstanding_cover_page, shares_outstanding_on_cover, common_shares_outstanding_end_of_period. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_share_repurchases | Cash spent on share repurchases (buybacks), by period. Share repurchases (dollars): Cash spent buying back the company's own shares. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Share repurchases is read from share_repurchases, repurchases_of_common_stock, repurchase_of_common_stock, purchases_of_treasury_stock, common_stock_repurchased, treasury_stock_purchases, purchase_of_treasury_stock, repurchase_of_ordinary_shares, payments_for_repurchase_of_common_stock, purchases_of_common_stock_for_treasury, treasury_stock_acquired, net_purchases_of_treasury_shares, and 2 more. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_shareholders_equity | Shareholders' equity (book value) at each period end, with total equity including noncontrolling interests alongside. Shareholders' equity (dollars): Equity attributable to the company's shareholders. Total equity including noncontrolling interests is shown under related where the record carries both. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Shareholders' equity is read from total_stockholders_equity, total_shareholders_equity, stockholders_equity, shareholders_equity, shareholders_equity.berkshire_shareholders_equity. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_source_filings | The SEC filings behind a company's record: the annual report (10-K, or 20-F/40-F for a foreign issuer) and the latest quarterly report (10-Q, or 6-K), each with its form, its own fiscal year and period end, the date it was filed, its accession number, a link to the document on sec.gov and how its fiscal year was established; plus, for every period in the statements, which filing (form and accession) its figures were read from, including any separate accession for cash flow, per-share or non-GAAP figures taken from an earnings release; the sec.gov documents the figure links open; and Ticker Scout's published files for the record. Pass `record` for an earlier record. | Read-only |
| get_stock_based_compensation | Stock-based (share-based) compensation expense, by period. Stock-based compensation (dollars): Non-cash stock-based compensation expense, normally from the cash flow statement. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Stock-based compensation is read from stock_based_compensation, share_based_compensation, stock_based_compensation_expense, share_based_compensation_expense, equity_based_compensation, stock_compensation_cost. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_stock_splits | Stock splits a company's record has adjusted for: every split applied (ratio and date), which figures were restated for it, and any as-reported pre-split values the record keeps alongside. Per-share figures and share counts Ticker Scout publishes are split-adjusted, so periods before and after a split compare directly. Also returns the record's notes that mention a split. | Read-only |
| get_subsequent_events | Material developments after the latest period end: what the company disclosed after the balance-sheet date in its latest report and in current reports since (acquisitions, financings, dividends, litigation outcomes, leadership changes), each dated and sourced by accession. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record. | Read-only |
| get_total_assets | Total assets at each period end. Total assets (dollars): Total assets at the period end. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Total assets is read from total_assets, assets.total_assets. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_total_liabilities | Total liabilities at each period end. Total liabilities (dollars): Total liabilities at the period end. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Total liabilities is read from total_liabilities, liabilities.total_liabilities. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_trailing_twelve_months | The trailing-twelve-months block: income statement and cash flow summed over the last four reported quarters, with its own derivation note saying exactly which fiscal year and year-to-date columns it was built from (for example 'FY2026 plus first half FY2027 less first half FY2026'). TTM figures are calculated in the record from filed figures, so they have no sec.gov line of their own. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Pass `record` for an earlier published record. | Read-only |
| get_working_capital | Total current assets and total current liabilities at each period end, with working capital (current assets less current liabilities) calculated from them and labeled as calculated. Total current assets (dollars): Assets expected to be realized within a year. Total current liabilities (dollars): Liabilities due within a year. Default: every period in the latest record (up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months); `period` narrows to one fiscal year or quarter, searching older records, and period='all' returns the full history. Each value carries its exact amount, the field it was read from, its dates, accession and form, and a sec.gov link to the line printing it. Field names differ by company: Total current assets is read from total_current_assets, current_assets; Total current liabilities is read from total_current_liabilities, current_liabilities. The company's own headline field is tried first, then these names in order; nothing is estimated or summed. Look-alike fields come back under `related`; if none match, the response says so and lists similar fields. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. | Read-only |
| get_year_to_date | The year-to-date block (six or nine months, as the latest 10-Q reports it) and, where the record has one, the prior-year year-to-date comparative from the same 10-Q: income statement, cash flow and segment data for the fiscal year so far. Year-to-date cash flow is what a 10-Q actually prints. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. Pass `record` for an earlier published record. | Read-only |
| guide | Start here if unsure. How Ticker Scout's tools fit together: what a record is versus a period, the period syntax every period argument accepts, units and currency, how figures are cited and linked to sec.gov, what to call for common questions, and the full map of tools grouped by what they answer. No arguments. | Read-only |
| list_companies | List the public companies Ticker Scout covers, with the fiscal period of the latest data, every published record held for each (its periods), and the predicted date of the next SEC filing. Call this first when you do not know whether a company is covered, or to turn a company name into a ticker. Coverage is S&P 500 companies plus major foreign issuers that file with the SEC. For a site-wide summary (how many companies, forms, foreign issuers, upcoming filings) use get_coverage_summary. | Read-only |
| list_company_figures | Dumps every numeric figure in a company's record under the exact name its financials.json (and its page on tickerscout.ai) uses, with the value in each period. Two parts: standard_figures maps each standard figure (revenue, net income, EPS, cash, debt and the rest) to the name THIS company's record gives it - Apple's revenue is total_net_sales, JPMorgan's is total_net_revenue - and other_figures holds every remaining figure, grouped by its statement or table (income statement lines beyond the standard ones, segments, revenue_by_* breakdowns, key metrics, bank and insurance tables, non-GAAP measures), keyed by its path. Every name and path here can be passed exactly as written to get_figure or get_figure_history. Pass `block` to list one table only. Defaults to the latest fiscal year and latest quarter; pass `period` for others (period='all' for every period held). | Read-only |
| list_events | An index of every item in a company's 8-K events digest, grouped by its section: for each item, the first date it states, every accession number it cites with the form, and its first sentence. Much smaller than get_events; use it to scan what happened and when, then read an item in full with get_events(section), a topic tool, or get_filing(accession). | Read-only |
| list_periods | History and coverage for one company: every fiscal year and every quarter Ticker Scout holds, across every published record, with each period's start and end dates, length, source form and accession, and which records carry it; plus the year-to-date and trailing-twelve-months blocks, and the list of published records (each the snapshot built when one 10-Q or 10-K was filed, with its permanent URLs). Call this to see how far back the data goes before asking for a specific year or quarter. Fiscal years are the company's own: NVIDIA's FY2027 ends in January 2027, Apple's FY2026 ends in September 2026. | Read-only |
| list_standard_figures | The catalog of standard financial figures Ticker Scout looks for in every company's record - revenue, cost of revenue, gross profit, R&D, SG&A, operating expenses, operating income, interest expense, pretax income, income tax, net income, EPS, share counts, D&A, stock-based compensation, bank net interest income and credit provisions, cash, assets, liabilities, debt, equity, working capital, goodwill, intangibles, inventories, receivables, payables, PP&E, retained earnings, operating cash flow, capex, free cash flow, investing and financing cash flow, dividends, buybacks and acquisitions - with each one's definition, units, the dedicated tool that returns it, the words get_figure accepts for it, and every record field name it is read from. No ticker needed. | Read-only |
| list_upcoming_filings | Every covered company expected to file a 10-Q or 10-K (or 6-K / 20-F) within the next N days, soonest first, with the predicted date and form and the period currently held. Use it to see whose data refreshes soon. Dates are predictions from each company's filing history, not announced dates. Filter by form with `form`. | Read-only |
| search_sections | Keyword search over a company's filings synthesis that answers WHERE: every section and subsection of the 10-K/10-Q narrative, the 8-K events digest and the financial record's sourcing notes that mentions the query, ranked by how often, with a snippet and the section's size. All words must appear (case-insensitive); put a phrase in double quotes to match it exactly, e.g. '"export controls" China'. Then read a hit with get_narrative(section), get_narrative_subsection or search_text. | Read-only |
| search_text | Keyword search that answers WHAT IT SAYS: the individual paragraphs and list items in a company's 10-K/10-Q narrative, 8-K events digest and financial-record notes that contain every word of the query, best first, each in full with its section and subsection. Case-insensitive; double quotes match an exact phrase. Examples: 'buyback authorization', '"remaining performance obligations"', 'China export', 'credit facility', 'goodwill impairment', 'CEO'. | Read-only |
| Directory | Listing | Tier | First seen |
|---|---|---|---|
| Official MCP Registry | ai.tickerscout/ticker-scout | - | 2 Oct 2026 |
| Glama | Listed there according to MCP Toplist’s dataset; not collected by InvokeRank. | ||