Beat & Raise (SEC EDGAR) MCP

Full-text search across all SEC filing content. Returns matching filings with relevance-ranked results, highlighted snippets, and facets by form type and year. Use this to find filings mentioning specific topics like "revenue growth", "cybersecurity risk", "stock buyback", etc. Args: query: Search query (e.g. "revenue growth", "cybersecurity risk factors") form: Filter by SEC form type (

Search for companies by name or ticker symbol. Returns matching entities with CIK, all known names, and ticker symbols, plus the SEC's SIC industry code and name (sic, sic_description) for companies that have one. Use this to find a company's CIK before using other tools. A result with succession_filing filed an 8-K12B or 8-K12G3 in the last five years: it became the successor to an earlier regi

Look up a company by CIK to get its name(s), ticker(s) and industry. When known, the result also has the SEC's SIC classification: sic (4-digit code, e.g. "6200"), sic_description (e.g. "SECURITY & COMMODITY BROKERS, DEALERS, EXCHANGES & SERVICES"), sic_url (a page listing the other companies in the same industry), fiscal_year_end (MMDD, e.g. "1231" for 31 December) and state_of_incorporation. SI

List the SEC's SIC industry codes, so you know which code to use with list_companies_by_sic. With a query (a word from the industry title: "software", "bank", "oil", "pharmaceutical") you get the matching codes, most companies first, at most 50, each with the code (sic), the SEC's industry title (description), the SEC office that reviews filers in it (office), and how many companies we hold under

List the companies in an industry, using the SEC's Standard Industrial Classification (SIC). Pass a SIC code (3-4 digits, e.g. "6200" for securities brokers and exchanges, "3571" for electronic computers, "7372" for prepackaged software) to get its companies: CIK, name, ticker, state of incorporation and fiscal year end, 100 per page, companies with a ticker first. Get a company's own code from g

Query SEC filings by form type, date range, and/or CIK. Returns deduplicated filing metadata sorted by filing date (newest first). Each filing's content_object lists its documents (filename, doc_type, description, sequence; sequence 1 is the primary document); read any of them with get_document(cik, accession_number, filename). A document's sec.gov URL, to cite, is sec_base_url + filename, and it

Get full filing metadata including its content_object. content_object lists every document in the filing with filename, doc_type, description, sequence and whether a markdown version exists; read one with get_document(cik, accession_number, filename). Cite sec_base_url + filename; the beatandraise.com viewer is beatandraise_base_url + filename. The R*.htm files are XBRL financial-table pages; lis

Fetch a filing document's content from storage. For one section of a 10-K, 10-Q or 8-K (MD&A, Risk Factors, Legal Proceedings, Item 2.02…), use get_filing_item instead: it returns just that Item, a fraction of the document, with a link highlighting it. Returns the document as markdown (default) or raw HTML. Use this to read the actual text of a whole 10-K, 8-K, exhibit, or any other filing docum

List the Items of a 10-K, 10-Q or 8-K: which sections the filing has and where. Each entry gives the item ("1A", "7", "2.02"), its part ("I".."IV"; 10-Q items repeat across Part I and Part II), the SEC's title, the heading as the filer wrote it, its length in characters, and a highlight_url that opens the filing with that whole section marked. Read one with get_filing_item. Items are found by the

Read one Item of a 10-K, 10-Q or 8-K, e.g. Risk Factors or MD&A, instead of the whole document. Much smaller than get_document: a 10-K's Item 1A is typically 5-15% of the filing. The first lines say which item it is, give the sec.gov source to cite, and a highlight_url marking the whole section in the filing. If the item's heading was not found, you get the text between the neighbouring items in

List every R*.htm financial table in a filing (10-K, 10-Q, S-1, etc.). Returns one entry per <Report> in the filing's FilingSummary.xml — typically the Cover page, the core financial statements (income, balance sheet, cash flow, comprehensive income, equity), notes, and detail breakdowns. Each entry includes the filename you'd pass to get_document, plus a canonical type (xbrl_role_normalized) so

Get parsed 13F-HR institutional holdings for a filer. Returns individual stock positions with issuer name, CUSIP, FIGI, market value, share count, investment discretion, and voting authority. Data is extracted from the 13F information table XML. Each holding also carries issuer_cik, sic and sic_description (the SEC's SIC industry classification of the issuer, not GICS) when the CUSIP maps to a c

Who holds a company, from 13F filings: how much of each share class institutions hold, and how that changed quarter by quarter. The company-side view of 13F; get_holdings is the manager side (what one institution owns). Use it for questions like: - "What % of AMD do institutions hold, and how has it changed over the last 4 quarters?" -> quarters=4; read quarters[].share_classes[].pct_of_cla

Get parsed Form 4 insider transactions for a company. Returns insider buy/sell transactions with owner details (name, title, relationship), transaction details (date, code, shares, price), and post-transaction holdings. Data is extracted from the Form 4 XML. Transaction codes: P=Purchase, S=Sale, A=Award, M=Exercise, G=Gift, F=Tax By default only Form 4 Table I (the shares themselves) is return

Get a company's shares outstanding over time, as stated on the cover page of each 10-K, 10-Q, 20-F and 40-F (dei:EntityCommonStockSharesOutstanding). One row per share class and as-of date, oldest first, each with the filing it comes from (source). Counts are as filed and never split-adjusted, so a stock split appears as a jump: ratio_to_previous is the count divided by the same class's previous

Search Form D filings: private placements and private funds (exempt offerings under Regulation D, Section 4(a)(5) and the Investment Company Act 3(c) exclusions), since 2009. Each result is one filing: issuer (CIK, name, city, state, entity type, year of incorporation), industry group and fund type, revenue or net-asset-value range, exemptions claimed (code and meaning), securities offered, date

Get one Form D filing in full, by accession number (from search_private_offerings). Everything search returns, plus: the issuer's full address, phone and previous names; co-issuers; related persons (executive officers, directors, promoters) with their roles and addresses as filed; sales compensation recipients (placement agents and brokers) with FINRA CRD numbers, their broker-dealer and the stat

Run SQL over every Form D filing since 2009, for what search_private_offerings cannot answer: totals, comparisons and breakdowns across states, industries, fund types, exemptions, placement agents and years ("money raised by California biotechs this year against last year, by quarter"). Call it first with no sql: it returns the tables, every column with its type and meaning, and the rules for rea

Extract structured financial statements from a 10-K or 10-Q filing. Returns balance sheet, income statement, cash flow statement, equity statement, and comprehensive income — each as markdown table content extracted from the filing's XBRL R-files. To use this tool, first find a 10-K or 10-Q accession number using get_filings, then pass it here. Args: cik: Company CIK (e.g. "0000320193")

Search within a filing's documents for specific terms. Returns matching lines with context. If filename is omitted, searches every readable document in the filing (the main document and its exhibits, e.g. an 8-K's press release AND its CFO commentary), up to 12 files. If filename is provided, searches only that file. Each file in the result carries its own source (sec_url) — cite the file the mat

Check that a figure or sentence really appears in a filing document, and get a link that highlights exactly where. Use this before stating any number or quotation from a filing. Analysts need to see the figure in the source; a link to the whole document is not enough. Quote the text as it appears in the document: a sentence, or a table row's label and figure ("Total net sales 416,161", "Gross mar

Check that a number you are about to state appears in a filing, however it is written. Every number is compared as its digits alone (separators, decimal point, sign, $ and % dropped, zeros trimmed): "416,161", "416.161" and "416,161,000" are all 416161. Your figure must be one of the filing's numbers times a power of ten, allowing for rounding to the digits you give: "$416.2 billion" matches 416,

List the numbers a filing document actually states, each with its label. Each entry is a number with its label (the table row's label, or the words leading up to it in prose) and its digits with formatting removed, e.g. {"digits": "416161", "text": "416,161", "label": "Total net sales"}. Any figure you state from this document must be one of these digit strings times a power of ten (possibly roun

Check every number in a draft against the filing characters it cites, and link them. Write your draft with a citation right after each figure, using the ref that list_figures or verify_figure gave for it: revenue of $68.1 billion [ref:0001045810-26-000019/q4fy26pr.htm@112+4] For a number you calculated, cite its inputs: up 73% [calc: ref:<current>, ref:<prior>] A ref names the exact chara