{"tools":[{"name":"search_companies","description":"Find US-listed companies by name or ticker in the SEC EDGAR directory. Returns ticker, name, exchange, country and CIK, best match first. Use it first when you are not sure of a ticker.","input_schema":{"properties":{"query":{"description":"Company name or ticker, e.g. 'apple' or 'AAPL'.","maxLength":100,"minLength":1,"title":"Query","type":"string"},"limit":{"default":10,"description":"Rows to return, 1-25.","maximum":25,"minimum":1,"title":"Limit","type":"integer"}},"required":["query"],"title":"SearchCompaniesParams","type":"object"}},{"name":"get_company","description":"One company's profile from its SEC filings: name, exchange, country, CIK, industry (SIC), public float (USD millions) and shares outstanding (millions) as of their 10-K cover date, and a summary of its 10-K business section. No prices or market data.","input_schema":{"properties":{"ticker":{"description":"US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.","maxLength":12,"minLength":1,"title":"Ticker","type":"string"}},"required":["ticker"],"title":"TickerParams","type":"object"}},{"name":"get_financials","description":"Standardized financial statements (income, balance, cash_flow) built from SEC XBRL filings, annual or quarterly, one column per period, newest last, in USD millions (non-USD filers converted). Ask for only the metrics you need by key; margins, growth, free cash flow and per-share figures come precomputed. include_provenance shows each value's XBRL concept and SEC accession.","input_schema":{"properties":{"ticker":{"description":"US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.","maxLength":12,"minLength":1,"title":"Ticker","type":"string"},"statement":{"default":"income","description":"Which statement: income, balance or cash_flow.","enum":["income","balance","cash_flow"],"title":"Statement","type":"string"},"metrics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Metric keys for the chosen statement (omit for the defaults: income: revenue, gross_profit, operating_income, net_income, eps_diluted; balance: cash, total_assets, total_liabilities, total_equity, total_debt; cash_flow: cfo, cfi, cff, capex, fcf). Repeat the parameter or comma-separate. income: revenue, cost_of_revenue, gross_profit, rd_expense, sga_expense, total_operating_expenses, operating_income, ebitda, interest_expense, pretax_income, income_tax, effective_tax_rate, net_income, eps_basic, eps_diluted, shares_diluted, dividends_per_share, gross_margin, operating_margin, net_margin, revenue_growth. balance: cash, short_term_investments, receivables, inventory, total_current_assets, ppe_net, goodwill, intangibles, total_assets, accounts_payable, deferred_revenue, current_debt, total_current_liabilities, long_term_debt, total_liabilities, retained_earnings, total_equity, shares_outstanding, total_debt, net_debt, working_capital, tangible_book_value, invested_capital, book_value_per_share. cash_flow: cf_net_income, cf_da, cf_sbc, cf_working_capital_change, cfo, capex, acquisitions, cfi, debt_issued, debt_repaid, buybacks, dividends_paid, cff, net_change_in_cash, ending_cash, fcf, fcf_margin. Industry lines (banks, insurers, REITs, utilities, oil & gas, asset managers) exist too; an unknown key's error lists every valid key.","title":"Metrics"},"period_type":{"default":"annual","description":"annual = fiscal years (FY2024); quarterly = discrete quarters (2024Q3).","enum":["annual","quarterly"],"title":"Period Type","type":"string"},"years":{"default":5,"description":"How many fiscal years back, 1-20: one column per year (annual) or four per year (quarterly).","maximum":20,"minimum":1,"title":"Years","type":"integer"},"include_provenance":{"default":false,"description":"Also return each value's source: the XBRL concept (or formula) and the SEC accession it came from.","title":"Include Provenance","type":"boolean"}},"required":["ticker"],"title":"FinancialsParams","type":"object"}},{"name":"list_filings","description":"A company's SEC filings, newest first: form, filing date, period, accession number, description and the sec.gov link. Filter by one form type (10-K, 10-Q, 8-K, 4, DEF 14A...).","input_schema":{"properties":{"ticker":{"description":"US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.","maxLength":12,"minLength":1,"title":"Ticker","type":"string"},"form_type":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Keep one SEC form type, exact match, e.g. 10-K, 10-Q, 8-K, 4, DEF 14A, 20-F. Omit for every form.","title":"Form Type"},"limit":{"default":20,"description":"Rows to return, newest first, 1-50.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["ticker"],"title":"FilingsParams","type":"object"}},{"name":"get_insider_trades","description":"Insider transactions from SEC Forms 3/4/5 for one company, newest filed first: insider, role, transaction code, shares, price, value, shares held after, and the filing link.","input_schema":{"properties":{"ticker":{"description":"US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.","maxLength":12,"minLength":1,"title":"Ticker","type":"string"},"limit":{"default":20,"description":"Rows to return, newest filed first, 1-100.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["ticker"],"title":"TradesParams","type":"object"}},{"name":"get_congress_trades","description":"Trades in one company's stock disclosed by members of the U.S. House and Senate (Periodic Transaction Reports), newest filed first: member, party, chamber, state, buy/sell, disclosed amount range, owner and the filing link.","input_schema":{"properties":{"ticker":{"description":"US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.","maxLength":12,"minLength":1,"title":"Ticker","type":"string"},"limit":{"default":20,"description":"Rows to return, newest filed first, 1-100.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["ticker"],"title":"TradesParams","type":"object"}},{"name":"get_headlines","description":"Recent press headlines about one company (headline, outlet, date, link; never article text), from The GDELT Project's news index, newest first.","input_schema":{"properties":{"ticker":{"description":"US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.","maxLength":12,"minLength":1,"title":"Ticker","type":"string"},"limit":{"default":10,"description":"Headlines to return, newest first, 1-20.","maximum":20,"minimum":1,"title":"Limit","type":"integer"}},"required":["ticker"],"title":"HeadlinesParams","type":"object"}},{"name":"get_economy","description":"U.S. economic indicators from FRED (inflation, jobs, growth, housing, rates, credit, markets, government debt). Without series_id: every indicator's latest and prior figure and next release date. With series_id: that indicator's history as date,value rows.","input_schema":{"properties":{"series_id":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"One indicator's history, by FRED series id: CPIAUCSL, CPILFESL, PCEPI, PCEPILFE, PPIFIS, CUSR0000SAH1, GASREGW, DCOILWTICO, T5YIE, T10YIE, UNRATE, U6RATE, PAYEMS, ICSA, CCSA, JTSJOL, CIVPART, CES0500000003, A191RL1Q225SBEA, RSAFS, INDPRO, TCU, DGORDER, PCEC96, DSPIC96, PSAVERT, UMCSENT, BOPGSTB, HOUST, PERMIT, HSN1F, HPIPONM226S, MORTGAGE30US, DFF, SOFR, DPRIME, DGS3MO, DGS2, DGS5, DGS10, DGS30, T10Y2Y, T10Y3M, WALCL, M2SL, TOTALSL, DRCCLACBS, NFCI, VIXCLS, DTWEXBGS, GFDEBTN, GFDEGDQ188S, MTSDS133FMS, SAHMREALTIME. Omit for the latest value of every indicator.","title":"Series Id"},"range":{"default":"5Y","description":"History window when series_id is given: 1Y, 5Y, 10Y or MAX.","enum":["1Y","5Y","10Y","MAX"],"title":"Range","type":"string"}},"title":"EconomyParams","type":"object"}}]}