io.github.AAAZZZR/stockfacts · v1.1.0 · finance-and-payments
Stockfacts is healthy: it completed an MCP handshake in 2083 ms and exposes 19 tools.
US stock market data for AI agents: SEC filings, financials, insider trades, 13F, options, macro.
Endpoint: https://mcp.livermore.club/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 19 |
| Latency | 2083 ms |
| Last checked (UTC) | 2026-10-15T00:30:51.954Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-15T00:30:51.954Z | Healthy | 2083 |
search | Find US stocks, 13F institutions (including the curated superinvestors, matched by fund or manager name, e.g. 'Buffett' or 'Pershing', and large asset managers matched by their common name, e.g. 'Fidelity' finds FMR LLC and 'Capital Group' its three 13F filers), corporate insiders (Form 4 reporting |
get_stock | Overview of one US-listed stock: company facts (SEC name, CIK, exchange, SIC industry, other share classes), open-market insider activity in the last 90 days (Form 4 codes P and S, non-derivative: number of filings and total USD), institutional ownership from 13F for the latest complete quarter (num |
get_stock_13f_holders | Institutions that reported holding a stock in their 13F-HR filings for one calendar quarter (default: the latest complete quarter, or for a ticker that is no longer listed its last quarter with a full set of 13F holders; 13F is filed up to 45 days after quarter end and covers long positions in US-li |
get_insider_trades | Insider transactions from SEC Form 4 filings (coverage starts July 2021; updated daily). One row per filing and transaction type: same-day lots are combined, avg_price_usd is value-weighted, value_usd is the USD total, shares_owned_after is the holding after the last lot, ownership_change_pct is the |
get_insider_lists | Ready-made insider trading screens, the same lists as livermore.club/en/insiders: cluster-buys (companies where 3 or more different insiders bought on the open market in the last 30 days, ranked by total value; returned in `companies`), ceo-cfo-buys (CEO or CFO open-market purchases of $25,000 or mo |
get_institution | One 13F filer (an institution or a curated superinvestor) by SEC CIK: names (and the superinvestor's manager and style), the quarters it filed (newest 12, with quarters_total: number of positions, portfolio value in USD, filing time, amendments), and its holdings for one quarter (default: the latest |
list_superinvestors | The curated list of superinvestors (well-known long-term investors such as Warren Buffett's Berkshire Hathaway, Bill Ackman's Pershing Square, Li Lu's Himalaya Capital) with their latest 13F quarter: portfolio value in USD (long positions, excluding options), number of positions, filing date, and th |
get_superinvestor_activity | What the curated superinvestors bought and sold in one quarter according to 13F, compared with the previous calendar quarter (default: the latest complete quarter). Without superinvestor_cik: most_bought (stocks the most superinvestors opened or added to), most_sold (reduced or sold out) and per-sup |
get_major_holders | The current holders of 5% or more of a stock according to their latest Schedule 13D or 13G filing, largest first, like the Major holders tab on livermore.club. Each holder has pct_of_class (percent of the share class, 7.5 = 7.5%) and shares from its latest filing, the change against the previous fil |
get_ownership_filings | Schedule 13D and 13G filings by holders of more than 5% of a company, newest first, like livermore.club/en/ownership. 13D is filed by holders who may seek to influence the company (activists), 13G by passive holders; /A marks an amendment. Filter by form, ticker (one stock's whole history), filer_ci |
get_form144_notices | Form 144 notices of proposed sales of restricted or control stock by insiders (officers, directors, large holders), newest first, like livermore.club/en/ownership/144. A notice is a plan to sell, not a completed sale. Notices replaced by a Form 144/A are left out. Filter by ticker (one company's who |
get_politician_trades | Trades in stocks, ETFs, options and, on request, other assets reported by politicians (members of the U.S. Congress: House and Senate), one row per trade, newest report first by default. Filter by politician (bioguide ID or name), ticker, asset (listed by default, or stock, option, other, all), cham |
get_politician | One politician (a member of the U.S. Congress: House or Senate), by bioguide ID or name: party, chamber, state, district, in office or former, terms served with start and end dates; a profile with the official photo_url, position (e.g. U.S. Representative for California's 11th district), district co |
get_financials | Financial statements of one company from the XBRL data in its 10-K, 10-Q, 20-F and 40-F filings (SEC companyfacts), newest period first: income statement (revenue, cost_of_revenue, gross_profit, operating_expenses, rd_expense, sga_expense, operating_income, interest_expense, tax_expense, net_income, |
list_filings | A company's SEC filings, or the whole market's: 10-K (annual report, including 10-KT), 10-Q (quarterly report), 8-K (current report), 20-F and 40-F (foreign companies' annual reports), each with its amendments (/A), newest first, since 2009. Each row: accession, form, the 8-K item codes with their d |
get_short_interest | Short-selling data for one stock, newest first, in four sections: short_interest (FINRA short interest per settlement date since 2021: short_shares, prev_short_shares, change_shares, change_pct, avg_daily_volume, days_to_cover, dtc_capped), short_volume (FINRA daily off-exchange short volume, last t |
list_short_interest | Every stock's FINRA short interest for one settlement date (default: the latest), ranked like livermore.club/en/shorts: by change in short shares since the previous settlement date (default; dir=asc gives the largest decreases), change_pct, days_to_cover or short_shares. Only stocks with an average |
screen_stocks | US-listed companies by market cap, largest first (dir=asc for smallest first), optionally within min_market_cap_usd and max_market_cap_usd (US dollars, both inclusive; give either, both or neither). For companies around $100 million, try for example min_market_cap_usd 50000000 and max_market_cap_usd |
get_data_coverage | What data Livermore has and how fresh it is: the Form 4 filing-date range, the 13F quarters loaded (with the number of filers), the latest complete 13F quarter, the number of curated superinvestors, the Schedule 13D, 13G and Form 144 filing-date ranges, the filing-date range of politicians' trade re |