{"id":"io.github.theodor90/form4api-mcp","slug":"io-github-theodor90-form4api-mcp","title":"Form4API — SEC Insider Trading","description":"Real-time SEC Form 4, Form 144, 13F-HR & congressional STOCK Act insider data. 40 tools + 6 prompts.","version":"1.18.0","publisher":{"kind":"github","id":"theodor90","label":"@theodor90 on GitHub","url":"https://github.com/theodor90"},"website":"https://www.form4api.com","repository":"https://github.com/theodor90/form4api-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.form4api.com/mcp","headers":[{"description":"Your Form4API key as a Bearer token. Get a free one (500 req/day, no card) at https://www.form4api.com","isRequired":true,"value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"Form4API key","isRequired":true,"isSecret":true}},"name":"Authorization"}]}],"packages":[{"registryType":"npm","identifier":"form4api-mcp","version":"1.18.0","transport":{"type":"stdio"},"environmentVariables":[{"description":"Form4API key — get a free one (500 req/day, no card) at https://www.form4api.com","isRequired":true,"isSecret":true,"name":"FORM4API_KEY"}]}],"published":"2026-11-13","updated":"2026-11-13","status":"online","auth":"","latency_ms":1229,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_transactions","title":"Search insider transactions","description":"Search SEC Form 4 insider transactions with rich filters: ticker, insider CIK, transaction code/category, date range, a dollar floor (min_value), institutional-ownership trend, and (Pro+) upper trade-size bounds plus post-trade return screening (1d/1w/1m/3m/6m, returns as fractions e.g. 0.05 = +5%). Returns transaction-level rows — shares, price, total value, transaction code, 10b5-1 flag, insider","read_only":true},{"name":"get_recent_filings","title":"Latest Form 4 filings","description":"Live feed of the newest SEC Form 4 filings, sorted most-recent-first, optionally filtered to one ticker. New filings typically appear within ~60 seconds of SEC publication. Use this to check \"what just happened\" rather than get_transactions (built for filtered/historical search across date ranges and codes). Returns per-filing accession number, filed/period-of-report dates, company + insider ident","read_only":true},{"name":"get_filing","title":"Look up a filing","description":"Fetch one Form 4 filing by its exact SEC accession number (format NNNNNNNNNN-YY-NNNNNN, e.g. 0000320193-26-000001). Use this once you already have an accession number from get_recent_filings or get_transactions. Returns filed/period-of-report dates, company and insider identity, and transaction count for that filing. Free plan.","read_only":true},{"name":"get_insider_profile","title":"Insider profile","description":"Identity card for one insider by CIK (SEC's numeric filer identifier): name, all known titles, and director/officer/10%-owner role flags. Returns NO transactions — when the user asks what an insider bought, sold or filed, use get_insider_transactions (raw rows) or get_insider_career_summary (aggregated rollup) instead. If you only have a name, resolve it to a CIK first with search. Free plan.","read_only":true},{"name":"get_insider_transactions","title":"Trades by one insider","description":"All Form 4 transactions filed by one insider (by CIK), filterable by ticker, transaction code, date range, and 10b5-1 exclusion. Use this once you have an insider's CIK on hand; get_transactions with insider_cik= gives the same rows alongside its broader filter set, while get_insider_career_summary returns a pre-aggregated rollup instead of raw rows. Free plan. Paginated, max 100/page.","read_only":true},{"name":"get_company_overview","title":"Company overview","description":"Company profile for a single ticker — name, CIK, SIC sector/description, state of incorporation, website, total Form 4 filing count, and active insider count. Use this for company identity/metadata; use get_company_insiders to list who is filing, or get_transactions with ticker= for their trade history. Free plan.","read_only":true},{"name":"get_company_insiders","title":"Company insider roster","description":"Full roster of insiders who have ever filed a Form 4 for a given ticker — name, CIK, titles, director/officer/10%-owner flags, last-filed date, and total transaction count per insider. Use this to enumerate a company's insiders (e.g. before pulling each one's career summary); use get_transactions with ticker= for the underlying trade history itself. Free plan. Paginated, max 100/page.","read_only":true},{"name":"get_signals","title":"Insider cluster signals","description":"Cluster buy/sell signals — multiple insiders at the same company trading in the same direction within a short window, a stronger conviction signal than any single trade. Excludes 10b5-1 plan trades automatically by construction. Returns signal type, detection date, buyer/seller counts, total $ value, and the underlying transactions. Use this to FIND which companies have signals; when the user alre","read_only":true},{"name":"get_form144","title":"Form 144 sale notices","description":"Form 144 notice-of-proposed-sale filings — insiders disclose intent to sell roughly 2 days before the matching Form 4 sale lands, so this is an early-warning signal, especially discretionary (non-10b5-1) notices. Filter by ticker, insider name (partial match), date range, or exclude_10b5. Cross-reference with get_transactions/get_insider_transactions to see whether the intent was actually executed","read_only":true},{"name":"get_holdings","title":"Institutional 13F holdings","description":"Institutional 13F-HR positions — filter by ticker (CUSIP resolved to ticker automatically), CUSIP, manager CIK, quarter, or minimum position value. Answers \"who owns NVDA\" or \"which managers hold AAPL this quarter\"; pair with get_managers to look up a manager's identity/AUM, or get_transactions to cross-reference insider activity at the same company. Requires Business plan. Paginated, max 100/page","read_only":true},{"name":"get_managers","title":"Institutional managers","description":"Browse the institutional manager index — each manager with their latest 13F-HR filing date and AUM. Filter by name (partial match — \"Berkshire\" returns Berkshire Hathaway) or minimum AUM. Pair with get_holdings to see what a given manager owns. Requires Business plan. Paginated, max 100/page.","read_only":true},{"name":"get_sentiment","title":"Insider sentiment score","description":"Monthly insider-sentiment score for a ticker (MSPR-style, -100 to +100; positive = net buying conviction), one point per month, defaulting to roughly the last 12 months. Automatically excludes 10b5-1 plan trades so the score reflects discretionary conviction, not pre-scheduled dispositions. Use get_transactions or get_signals for the trade-level detail behind a given month. Requires Business plan.","read_only":true},{"name":"get_insider_career_summary","title":"Insider career summary","description":"Aggregate career rollup for one insider by CIK — first/last transaction dates, total shares/value bought vs sold, top companies traded, transaction-code breakdown, 10b5-1 plan split, and median post-trade returns (stored as fractions, e.g. 0.05 = +5%). Use this instead of get_insider_transactions when you want a pre-computed summary rather than raw rows; pair with the generated get_insider_scoreca","read_only":true},{"name":"check_usage","title":"Check API usage","description":"Snapshot of the authenticated API key's current usage — plan name, requests made today, daily limit, and all-time request count. Use this for a quick right-now check; use the generated get_usage_history tool for a daily trend over time, or get_key_activity for a per-request log. Free plan, works on every tier.","read_only":true},{"name":"verify_setup","title":"Verify setup","description":"Diagnostic check: confirms FORM4API_KEY is present and valid, the backend is reachable, and reports your current plan — returns a pass/fail/warn per check plus concrete next steps (where to get a key, how to upgrade) instead of a raw error. Run this first whenever another tool fails or returns a 401/402, to isolate whether the problem is configuration, plan, or a backend outage. No API key or para","read_only":true},{"name":"search","title":"Find companies and insiders","description":"Resolve free-text input — a company name, ticker fragment, or a person's name — to a ticker or CIK. This is usually the right FIRST call when a user names a company or insider you don't already have an identifier for; feed the resulting ticker into get_company_overview/get_transactions or the CIK into get_insider_profile/get_insider_transactions. Returns two independently-ranked lists: `companies`","read_only":true},{"name":"research_company","title":"Research a company","description":"Bundled insider-research context for one ticker in a single call — company profile, recent insider transactions (10b5-1 flagged), cluster buy/sell signals, monthly sentiment score, and a computed net buy/sell direction summary. Use this FIRST for any company insider-research question; it replaces 4 separate calls (get_company_overview, get_transactions, get_signals, get_sentiment) and degrades gra","read_only":true},{"name":"explain_signal","title":"Explain a signal","description":"Explain why a signal fired: the insiders and trades counted, what was excluded, and the criteria (Business plan+). Use this when the question is WHY a named company's signal fired, or WHICH insiders and trades made up its cluster. It takes the ticker directly, so there is no need to call GET /v1/signals first; that endpoint is for finding which companies have signals. Reconstructs the full evidenc","read_only":true},{"name":"get_company_peers","title":"Peer companies","description":"Peer companies in the same SIC industry, ranked by recent Form 4 activity. Returns other tracked companies in the same industry as the given ticker, for \"similar companies\" links. Candidates share the company's 4-digit SIC code (matchLevel \"sic4\"); when too few of those have Form 4 filings in the last 12 months to fill `limit`, companies sharing only the 2-digit SIC prefix (matchLevel \"sic2\") are ","read_only":true},{"name":"get_company_returns_summary","title":"Returns after company trades","description":"What happened after insiders traded at a company (Pro plan+). Summarises price returns after insider open-market trades at one company, for buys and for discretionary sells, next to a site-wide baseline computed the same way. The unit is an event: one per company per filing date and side. An event's return at a horizon (1m, 3m, 6m = 21, 63, 126 trading days) is the average of that event's rows, me","read_only":true},{"name":"get_congress_politician","title":"Congress member profile","description":"Get one politician's congressional trading profile (Pro plan+). Returns one politician's profile — identity fields, total/buy/sell trade counts, most recent trade's disclosure date, their top N most-traded tickers (by trade count), and their N most recent trades (same shape as GET /v1/congress/trades). Use this for a one-call politician overview rather than paging /v1/congress/trades?politician= y","read_only":true},{"name":"get_congress_ticker_rollup","title":"Congress trades by ticker","description":"Which politicians traded a ticker, with net buy/sell counts (Pro plan+). Returns every politician who has a non-superseded congressional trade in the given ticker, each with their trade/buy/sell counts, plus ticker-level totals. Optional window_days restricts to trades with a transactionDate in the trailing N days; omit for all-time. A ticker with no congress trades returns 200 with an empty polit","read_only":true},{"name":"get_convergence_signals","title":"Insider and Congress convergence","description":"Insider cluster-buy x congressional-purchase convergence (Pro plan+). Returns the tickers where an insider cluster-buy (InsiderSignal.IsClusterBuy) and at least one non-superseded congressional PURCHASE happened within window_days of EACH OTHER, restricted to convergences where the MORE RECENT of the pair's two dates is within a trailing lookback_days (so this surfaces CURRENT convergences, not an","read_only":true},{"name":"get_data_quality","title":"Data quality metrics","description":"Public data-quality, freshness and coverage metrics for the whole dataset. Returns public, keyless metrics on data freshness, ingestion latency, corpus coverage, and post-trade returns coverage — use this to check whether the dataset is current before relying on it (e.g. confirm Form 4 ingestion isn't stalled, or that price data isn't stale), not to look up any single company, insider, or transact","read_only":true},{"name":"get_insider_directory","title":"Insider A-Z directory","description":"Browse insiders alphabetically by surname. Returns the A-Z rail with a count per letter, plus one page of insiders under the\nrequested letter. Omit `letter` to get the rail and totals with no rows.\n\nNames come from EDGAR surname-first (\"HENNEMAN JOHN B III\"), so alphabetical order\nis order by surname. Casing in the source is inconsistent and is not normalised here.\n\nThis lists only insiders with a","read_only":true},{"name":"get_insider_leaderboard","title":"Insider leaderboard","description":"Ranked leaderboard of insiders by buy track-record (Business plan+). Returns the top insiders ranked by historical buy performance — same scored-buy methodology as\nGET /v1/insiders/{cik}/scorecard, applied across the whole corpus rather than one insider. Use\nthis to discover which insiders have the best track record; use the per-insider scorecard once\nyou have a specific CIK. Scores use absolute r","read_only":true},{"name":"get_insider_scorecard","title":"Insider buy scorecard","description":"Get insider buy track-record scorecard (Pro plan+). Returns the historical hit rate and average/median return of an insider's discretionary\nopen-market buys (TransactionCode=P, excluding 10b5-1 plans and derivatives), plus their best\nand worst scored buy. Scores use absolute return (NOT market-adjusted) anchored at the\nfiling-date close. A 'hit' is a scored buy whose 3m (or 6m) return is positive.","read_only":true},{"name":"get_key_activity","title":"API key activity log","description":"Recent, per-request API activity log for the authenticated key. Returns the most recent HTTP requests made with the authenticated API key, most recent first, including the endpoint path, response status code, duration in milliseconds, and timestamp. Use this to debug integration issues — confirm a specific call reached the API, check for repeated 4xx/5xx responses, or spot slow requests — rather t","read_only":true},{"name":"get_public_stats","title":"Public dataset statistics","description":"Public corpus-wide statistics — no API key required. Returns headline dataset totals: filing count, transaction count, tracked companies, institutional holdings rows, Form 144 and Form 13F-HR filing counts, the earliest filing date in the corpus, the most recent quarter's total 13F-HR reported AUM in USD, and measured ingestion latency (median/p95 seconds from SEC acceptance to our processing, tra","read_only":true},{"name":"get_status_history","title":"Service uptime history","description":"Measured uptime history for the public status page — trailing 90-day daily breakdown. Returns a daily breakdown of measured API uptime over a trailing 90-day window, computed from an internal heartbeat probe that runs every 5 minutes and performs the same DB-connectivity check as GET /health/ready. Each day in the `days` array reports the number of 5-minute slots expected to have elapsed (288 for ","read_only":true},{"name":"get_usage_history","title":"API usage history","description":"Daily request counts for the authenticated key over a trailing window. Returns a daily time series of request counts for the authenticated API key over the trailing N days — one data point per calendar day (UTC). Use this to plot usage trends or check rate-limit headroom over time. For a single current-day snapshot (today's count, plan limit, reset time) use GET /v1/keys/usage instead; for a raw r","read_only":true},{"name":"get_webhook_events","title":"Webhook delivery events","description":"Replay webhook delivery events since a given timestamp (default: last 24h). Returns up to 500 delivery attempts across all of the authenticated key's subscriptions since `since` (default: last 24 hours), most recent first — delivery id, subscription id, event type, attempt count, delivered-at/next-retry-at timestamps, last HTTP status code from the receiving endpoint, whether the delivery is dead ","read_only":true},{"name":"health_ingestion","title":"Data ingestion health","description":"Ingestion-death detector — Form 4 freshness, parse-queue health, price-feed freshness. Returns live (uncached) ingestion health: Form 4 processing freshness (stale after 90 minutes during the weekday 06:00-22:00 US Eastern EDGAR activity window, counted from the later of the last filing and the 06:00 opening; outside it, 14 hours or the time since the window last closed plus 90 minutes, whichever ","read_only":true},{"name":"list_companies","title":"Browse companies","description":"List companies with a public ticker, sorted by name or total filings. Returns a single page of companies that have a tracked public ticker — for browsing or building a company picker, not for searching by name or CIK (there is no full-text search here; use GET /v1/companies/{ticker} to fetch one company by its exact ticker). Each entry includes the company's CIK, name, ticker, exchange, total fili","read_only":true},{"name":"list_congress_politicians","title":"Congress trading leaderboard","description":"Ranked rollup of politicians by congressional trade activity (Pro plan+). Returns a paginated list of politicians who have at least one non-superseded congressional trade, each with total/buy/sell counts (sells include both Sale and PartialSale; Exchange trades count only toward total) and their most recent trade's disclosure date. Ordered by total trade count descending, ties broken by most recen","read_only":true},{"name":"list_congress_trades","title":"Congress stock trades","description":"Query congressional STOCK Act trades (Free+, plan-clamped disclosure window). Returns a paginated JSON list of congressional periodic-transaction-report trades, most recently DISCLOSED first, with non-superseded rows only (amended-away rows never appear). COVERAGE — HOUSE ONLY TODAY: every trade in this dataset comes from the U.S. House Clerk's PTR index. Senate eFD (efdsearch.senate.gov) returns ","read_only":true},{"name":"list_filings","title":"Browse Form 4 filings","description":"List Form 4 filings with optional ticker, CIK and date filters. Returns a paginated list of Form 4 filings, newest filed first. Filter by ticker, cik, and a from/to filed-date window. Each entry carries the accession number, company ticker/name, period of report, filed date, acceptedAt (the precise UTC SEC-acceptance instant, null if not captured), documentUrl (the public SEC document URL), amendm","read_only":true},{"name":"list_schedule13_dg","title":"13D/13G ownership stakes","description":"List Schedule 13D/13G >5% beneficial-ownership crossings (Business plan+). Returns every parsed >5% beneficial-ownership crossing event for a company — filer/reporting person, ownership percent, event date, form type (13D or 13G), and amendment status — parsed from EDGAR's structured Schedule 13D/13G cover-page XML (mandatory since the SEC's 2023 rule, compliance date 2024-12-18). SC 13D indicates","read_only":true},{"name":"list_webhooks","title":"Your webhook subscriptions","description":"List webhook subscriptions owned by the authenticated API key. Returns active webhook subscriptions under the authenticated API key, plus any the system auto-disabled after sustained delivery failures (disabledReason \"delivery_failures\") — those stay visible with disabledAt/disabledReason set so you can see why delivery stopped and reverse it with POST /v1/webhooks/{id}/enable. Subscriptions you d","read_only":true},{"name":"search_insiders","title":"Search insider names","description":"Search insiders (officers, directors, 10% owners) by name. Searches insiders by name and returns a paginated list of matches with each insider's CIK, title, director/officer/10%-owner flags, and total filing count. Use this to resolve a person's name to their CIK before fetching their transaction history, career summary, or scorecard — the CIK returned here feeds directly into GET /v1/insiders/{ci","read_only":true}],"server_info":{"name":"form4api","version":"1.19.0"},"category":"finance","tags":["agents","hr","automation"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-06-25","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-theodor90-form4api-mcp/"}