> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vistazo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SEC EDGAR

> Public company financials

Financial data for U.S. public companies from SEC filings — revenue, net income, assets, and more, per company over time or compared across companies.

Data from SEC EDGAR (U.S. Securities and Exchange Commission). Upstream API: [www.sec.gov](https://www.sec.gov/search-filings/edgar-application-programming-interfaces).

**Endpoint** `https://mcp.vistazo.ai/edgar/mcp`

| Tool                                        | What it does       |           |
| ------------------------------------------- | ------------------ | --------- |
| [`search_companies`](#search_companies)     | Search companies   | Read-only |
| [`company_financials`](#company_financials) | Company financials | Read-only |
| [`compare_metric`](#compare_metric)         | Compare metric     | Read-only |

## search\_companies

`Read-only` · `Reaches outside Vistazo`

Find public companies by ticker or name (e.g. "AAPL" or "Apple") — returns ranked matches with \{cik, ticker, name}. Use it to get the ticker/CIK for the other tools.

## company\_financials

`Read-only` · `Reaches outside Vistazo`

A single financial metric for one company as a time series — e.g. Apple revenue by year. Give a ticker and a metric (revenue, net\_income, gross\_profit, operating\_income, assets, liabilities, equity, cash). Returns one row per period (\{period, end, value} in USD), annual (default) or quarterly. From SEC XBRL filings (10-K/10-Q).

## compare\_metric

`Read-only` · `Reaches outside Vistazo`

Compare one financial metric across companies for a calendar year — e.g. revenue of AAPL vs MSFT vs GOOGL in 2023. Give a metric, a year, and optional tickers (omit for the top 20 filers by value). Returns \{ticker, entityName, value} rows sorted high→low, chart-ready as a ranked bar.