TradeStar Insider

Official9 toolsLive

by TradestarV5 · JavaScript

Filing-verified SEC EDGAR insider (Form 4), 13D, 13F & 8-K data, no sign-in. Verify any claim.

This MCP server provides filing-verified U.S. insider-buy signals derived from SEC Form 4. It focuses on “cluster buys” and compares large-vs-holdings buy activity. The server is identified by the slug com-tradestarinsider-edgar-insider-signals and exposes 5 tools.

🛠️ Key Features

Filing-verified U.S. insider-buy signals from SEC Form 4
Cluster buys analysis
Large-vs-holdings buy comparisons

🚀 Use Cases

Building workflows that rely on SEC Form 4 insider-buy verification
Screening or grouping insider buying activity by cluster buys
Comparing buying behavior where “large” holdings differ from holdings context

⚡ Developer Benefits

A focused dataset centered on SEC Form 4 insider buys
5 available tools for programmatic access to these signals

⚠️ Limitations

Scope is limited to insider-buy signals (not insider sales) and specifically SEC Form 4-derived data.

Topics

13d13fform-4insider-tradingmcpmcp-serversec-edgar

Captured live from the server via tools/list.

insider_buys

Use when the user asks which insiders bought a stock, whether a ticker has insider buying, or for Form 4 buys in a date range. Pass `ticker`, `start`+`end` for an inclusive ISO range, or neither for today's buys (SEC code P); `days` narrows, `include_unlisted` adds non-listed issuers. Each row carries filing_url, `offering_context` (true = IPO/offering, not open-market) and `source_excerpt`: the parsed filing fields, quoted from the filing as data, never derived. Caveat: only purchases that pass the signal filter are returned; code P is not proof of a buy.

Parameters7

start	string	optional	Inclusive range start, ISO YYYY-MM-DD. Give with `end` for a date range.
end	string	optional	Inclusive range end, ISO YYYY-MM-DD. Give with `start` for a date range.
limit	integer	optional	Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap.
offset	integer	optional	Rows to skip before this page (pagination). Default 0.
days	integer	optional	Only rows filed within the last N days (relative to today).
include_unlisted	boolean	optional	Include unlisted issuers (blank/NONE/N/A tickers and 5-letter mutual-fund classes). Default false = exchange-listed common stock only. Every row carries a `listed_equity` boolean.
ticker	string	optional	Case-insensitive exact ticker filter, e.g. DKS.

Raw schema

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "format": "date",
      "description": "Inclusive range start, ISO YYYY-MM-DD. Give with `end` for a date range."
    },
    "end": {
      "type": "string",
      "format": "date",
      "description": "Inclusive range end, ISO YYYY-MM-DD. Give with `start` for a date range."
    },
    "limit": {
      "type": "integer",
      "description": "Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap."
    },
    "offset": {
      "type": "integer",
      "description": "Rows to skip before this page (pagination). Default 0."
    },
    "days": {
      "type": "integer",
      "description": "Only rows filed within the last N days (relative to today)."
    },
    "include_unlisted": {
      "type": "boolean",
      "description": "Include unlisted issuers (blank/NONE/N/A tickers and 5-letter mutual-fund classes). Default false = exchange-listed common stock only. Every row carries a `listed_equity` boolean."
    },
    "ticker": {
      "type": "string",
      "description": "Case-insensitive exact ticker filter, e.g. DKS."
    }
  },
  "required": [],
  "additionalProperties": false
}

insider_cluster_buys

Use when the user asks about cluster buying, multiple insiders buying the same company, or the strongest insider-buying signal. Returns only clusters (>=2 insiders buying one issuer in-window), newest first; `days`/`ticker` narrow. Each row carries its source filing_url, `offering_context`, and `uniform_price_cluster` (true = >=3 insiders bought at the IDENTICAL price same day — an offering/conversion, not independent conviction). Caveat: genuine clusters rank above uniform-price ones; only purchases that pass the signal filter are returned; code P alone is not proof of an open-market buy.

Parameters5

limit	integer	optional	Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap.
offset	integer	optional	Rows to skip before this page (pagination). Default 0.
days	integer	optional	Only rows filed within the last N days (relative to today).
include_unlisted	boolean	optional	Include unlisted issuers (blank/NONE/N/A tickers and 5-letter mutual-fund classes). Default false = exchange-listed common stock only. Every row carries a `listed_equity` boolean.
ticker	string	optional	Case-insensitive exact ticker filter, e.g. DKS.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap."
    },
    "offset": {
      "type": "integer",
      "description": "Rows to skip before this page (pagination). Default 0."
    },
    "days": {
      "type": "integer",
      "description": "Only rows filed within the last N days (relative to today)."
    },
    "include_unlisted": {
      "type": "boolean",
      "description": "Include unlisted issuers (blank/NONE/N/A tickers and 5-letter mutual-fund classes). Default false = exchange-listed common stock only. Every row carries a `listed_equity` boolean."
    },
    "ticker": {
      "type": "string",
      "description": "Case-insensitive exact ticker filter, e.g. DKS."
    }
  },
  "required": [],
  "additionalProperties": false
}

federal_awards_recent

Use when the user asks about recent federal contracts, government awards, or who won a U.S. federal contract. Returns newly signed federal awards, newest first; `min_amount` sets a USD floor, `days` a last-N-days window. Every award carries its source award_url. Caveat: awards without a source link are dropped and never returned.

Parameters4

min_amount	number	optional	Only awards at or above this USD amount
limit	integer	optional	Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap.
offset	integer	optional	Rows to skip before this page (pagination). Default 0.
days	integer	optional	Only awards signed within the last N days.

Raw schema

{
  "type": "object",
  "properties": {
    "min_amount": {
      "type": "number",
      "description": "Only awards at or above this USD amount"
    },
    "limit": {
      "type": "integer",
      "description": "Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap."
    },
    "offset": {
      "type": "integer",
      "description": "Rows to skip before this page (pagination). Default 0."
    },
    "days": {
      "type": "integer",
      "description": "Only awards signed within the last N days."
    }
  },
  "required": [],
  "additionalProperties": false
}

activist_stakes_recent

Use when the user asks about activist investors, hedge-fund stakes, or recent 13D filings on a company. Returns activist Schedule 13D/13D-A filings on US-listed companies, newest first then by stated-intent strength; `ticker`, `min_percent` and `days` narrow. Each row carries its source filing_url and `item4_excerpt` (the activist's own Item 4 intent sentence, quoted from the filing as data, capped at its current length of 600 chars). Caveat: passive 13G is not covered; filings without a source link are dropped.

Parameters5

min_percent	number	optional	Only stakes at or above this percent-of-class
ticker	string	optional	Filter to one subject ticker (case-insensitive), e.g. DH
limit	integer	optional	Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap.
offset	integer	optional	Rows to skip before this page (pagination). Default 0.
days	integer	optional	Only stakes filed within the last N days.

Raw schema

{
  "type": "object",
  "properties": {
    "min_percent": {
      "type": "number",
      "description": "Only stakes at or above this percent-of-class"
    },
    "ticker": {
      "type": "string",
      "description": "Filter to one subject ticker (case-insensitive), e.g. DH"
    },
    "limit": {
      "type": "integer",
      "description": "Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap."
    },
    "offset": {
      "type": "integer",
      "description": "Rows to skip before this page (pagination). Default 0."
    },
    "days": {
      "type": "integer",
      "description": "Only stakes filed within the last N days."
    }
  },
  "required": [],
  "additionalProperties": false
}

fund_position_changes

Use when the user asks what a fund bought or sold, how a 13F filer changed its holdings, or which institutions opened/added/trimmed/exited a position. Returns quarter-over-quarter deltas, newest first; `filer`, `change_type`, `min_value_usd`, `days` narrow. Each row carries as_of_quarter_end, filed_date, lag_days, value_usd (whole dollars), cusip, issuer_name and its source filing_url; ticker is null (never guessed). Caveat: the delta is the product, not a trading edge — see the instructions and each response's `coverage` note for the universe and CIK scope.

Parameters6

filer	string	optional	Filter to one fund by name substring (case-insensitive, e.g. 'Berkshire') or exact filer CIK
change_type	string	optional	Only this kind of quarter-over-quarter change
min_value_usd	number	optional	Only positions at or above this current value in WHOLE US dollars
limit	integer	optional	Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap.
offset	integer	optional	Rows to skip before this page (pagination). Default 0.
days	integer	optional	Only changes filed within the last N days.

Raw schema

{
  "type": "object",
  "properties": {
    "filer": {
      "type": "string",
      "description": "Filter to one fund by name substring (case-insensitive, e.g. 'Berkshire') or exact filer CIK"
    },
    "change_type": {
      "type": "string",
      "enum": [
        "new_position",
        "added",
        "trimmed",
        "exited",
        "no_prior_quarter"
      ],
      "description": "Only this kind of quarter-over-quarter change"
    },
    "min_value_usd": {
      "type": "number",
      "description": "Only positions at or above this current value in WHOLE US dollars"
    },
    "limit": {
      "type": "integer",
      "description": "Max rows to return (default 25, newest first). Page with offset; the response's total_matched shows the full count. limit<=0 = no cap."
    },
    "offset": {
      "type": "integer",
      "description": "Rows to skip before this page (pagination). Default 0."
    },
    "days": {
      "type": "integer",
      "description": "Only changes filed within the last N days."
    }
  },
  "required": [],
  "additionalProperties": false
}

verify_insider_purchase

Use when the user wants to verify or fact-check a claim that an insider bought a stock, or to pull the purchases in one filing by accession. Pass the claim (ticker/issuer, person, amount, timeframe), or pass `accession` alone to fetch that filing's gated purchase records. Returns confirmed (with source filing + link), not_found, partial (itemised claimed-vs-filed), out_of_scope (sales/options/grants), or out_of_coverage. Caveat: filing-verified — absence is reported as absence, never estimated or guessed.

Parameters10

ticker	string	optional	Issuer ticker (case-insensitive), e.g. CAVA
issuer_name	string	optional	Issuer/company name (use if you don't have the ticker)
person	string	optional	Insider name in any order, e.g. 'Alfonso de Angoitia'
amount_usd	number	optional	Claimed purchase value in USD (matched ±5% or ±$1)
shares	number	optional	Claimed share count
date	string	optional	Claimed date, ISO YYYY-MM-DD (matched ±3 filing days)
start	string	optional	Window start (ISO) if the claim is a range
end	string	optional	Window end (ISO) if the claim is a range
txn_type	string	optional	Optional; only open-market buys are covered — sale/option/grant returns out_of_scope
accession	string	optional	SEC filing accession, e.g. 0001493152-26-040454. If you already have the exact filing, pass this to pull its gated purchase records directly — it is used alone and ignores the claim fields above.

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Issuer ticker (case-insensitive), e.g. CAVA"
    },
    "issuer_name": {
      "type": "string",
      "description": "Issuer/company name (use if you don't have the ticker)"
    },
    "person": {
      "type": "string",
      "description": "Insider name in any order, e.g. 'Alfonso de Angoitia'"
    },
    "amount_usd": {
      "type": "number",
      "description": "Claimed purchase value in USD (matched ±5% or ±$1)"
    },
    "shares": {
      "type": "number",
      "description": "Claimed share count"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Claimed date, ISO YYYY-MM-DD (matched ±3 filing days)"
    },
    "start": {
      "type": "string",
      "format": "date",
      "description": "Window start (ISO) if the claim is a range"
    },
    "end": {
      "type": "string",
      "format": "date",
      "description": "Window end (ISO) if the claim is a range"
    },
    "txn_type": {
      "type": "string",
      "description": "Optional; only open-market buys are covered — sale/option/grant returns out_of_scope"
    },
    "accession": {
      "type": "string",
      "description": "SEC filing accession, e.g. 0001493152-26-040454. If you already have the exact filing, pass this to pull its gated purchase records directly — it is used alone and ignores the claim fields above."
    }
  },
  "required": [],
  "additionalProperties": false
}

verify_activist_13d

Use when the user wants to verify or fact-check a claim about an activist stake or 13D filing (ticker/subject, filer, percent-of-class, stated intent, timeframe). Returns confirmed (with source filing + link), not_found, partial (itemised claimed-vs-filed), out_of_scope (passive 13G isn't covered), or out_of_coverage. Every response states the coverage window checked. Caveat: filing-verified — absence is reported as absence, never guessed.

Parameters9

ticker	string	optional	Subject-company ticker (case-insensitive), e.g. DH
subject_name	string	optional	Subject/target company name (use if you don't have the ticker)
filer_name	string	optional	Activist filer name in any order, e.g. 'Elliott Management'
percent_of_class	number	optional	Claimed percent-of-class owned (matched ±0.5 percentage points)
intent	string	optional	Optional pre-registered intent: I1 control/take-private, I2 board/proxy, I3 strategic/value
date	string	optional	Claimed filed date, ISO YYYY-MM-DD (matched ±3 filing days)
start	string	optional	Window start (ISO) if the claim is a range
end	string	optional	Window end (ISO) if the claim is a range
form_type	string	optional	Optional; only activist 13D/13D-A is covered — a passive 13G returns out_of_scope

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Subject-company ticker (case-insensitive), e.g. DH"
    },
    "subject_name": {
      "type": "string",
      "description": "Subject/target company name (use if you don't have the ticker)"
    },
    "filer_name": {
      "type": "string",
      "description": "Activist filer name in any order, e.g. 'Elliott Management'"
    },
    "percent_of_class": {
      "type": "number",
      "description": "Claimed percent-of-class owned (matched ±0.5 percentage points)"
    },
    "intent": {
      "type": "string",
      "enum": [
        "I1",
        "I2",
        "I3"
      ],
      "description": "Optional pre-registered intent: I1 control/take-private, I2 board/proxy, I3 strategic/value"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Claimed filed date, ISO YYYY-MM-DD (matched ±3 filing days)"
    },
    "start": {
      "type": "string",
      "format": "date",
      "description": "Window start (ISO) if the claim is a range"
    },
    "end": {
      "type": "string",
      "format": "date",
      "description": "Window end (ISO) if the claim is a range"
    },
    "form_type": {
      "type": "string",
      "description": "Optional; only activist 13D/13D-A is covered — a passive 13G returns out_of_scope"
    }
  },
  "required": [],
  "additionalProperties": false
}

verify_8k_event

Use when the user wants to verify or fact-check that a company filed an 8-K carrying specific SEC item code(s) in a timeframe. Pass registrant (cik/company/accession), item code(s) and dates. Returns confirmed (with source filing + link), not_found, partial (itemised claimed-vs-filed), out_of_scope (claims about the filing's meaning aren't covered — it is never paraphrased), or out_of_coverage. Caveat: filing-verified — item codes are the SEC controlled vocabulary parsed from the filing, never inferred.

Parameters7

cik	string	optional	Registrant CIK (leading zeros ignored), e.g. 320193
company_name	string	optional	Registrant name substring (case-insensitive), e.g. 'Apple'
accession	string	optional	SEC filing accession, e.g. 0001193125-26-389400
items	string	optional	Claimed SEC 8-K item code(s), comma-separated (e.g. '5.02' or '1.01,9.01') — checked against the filing
date	string	optional	Claimed filing date, ISO YYYY-MM-DD (matched ±3 filing days)
start	string	optional	Window start (ISO) if the claim is a range
end	string	optional	Window end (ISO) if the claim is a range

Raw schema

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "description": "Registrant CIK (leading zeros ignored), e.g. 320193"
    },
    "company_name": {
      "type": "string",
      "description": "Registrant name substring (case-insensitive), e.g. 'Apple'"
    },
    "accession": {
      "type": "string",
      "description": "SEC filing accession, e.g. 0001193125-26-389400"
    },
    "items": {
      "type": "string",
      "description": "Claimed SEC 8-K item code(s), comma-separated (e.g. '5.02' or '1.01,9.01') — checked against the filing"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Claimed filing date, ISO YYYY-MM-DD (matched ±3 filing days)"
    },
    "start": {
      "type": "string",
      "format": "date",
      "description": "Window start (ISO) if the claim is a range"
    },
    "end": {
      "type": "string",
      "format": "date",
      "description": "Window end (ISO) if the claim is a range"
    }
  },
  "required": [],
  "additionalProperties": false
}

verify_13f_change

Use when the user wants to verify or fact-check whether a fund (filer name/CIK) reported a CHANGE in a position in an issuer (issuer_name or cusip) in a quarter. Returns held (reported a change — opened/added/trimmed, with source filing + link), not_held (reported the position exited), not_found (no reported change — does NOT mean the fund didn't hold it), or out_of_coverage. Caveat: filing-verified; CANNOT confirm an unchanged holding (13F deltas only) — a 'held, unchanged' position produces no row.

Parameters6

filer	string	optional	Fund/institution name substring (case-insensitive, e.g. 'Berkshire') or exact filer CIK — REQUIRED
issuer_name	string	optional	Held company/issuer name (e.g. 'Apple') — give this or cusip
cusip	string	optional	9-char CUSIP of the held security — give this or issuer_name. (ticker is never accepted: 13F carries no authoritative ticker)
quarter	string	optional	As-of quarter-end the claim is about, ISO YYYY-MM-DD (e.g. '2026-06-30')
start	string	optional	Quarter-window start (ISO) if the claim spans quarters
end	string	optional	Quarter-window end (ISO) if the claim spans quarters

Raw schema

{
  "type": "object",
  "properties": {
    "filer": {
      "type": "string",
      "description": "Fund/institution name substring (case-insensitive, e.g. 'Berkshire') or exact filer CIK — REQUIRED"
    },
    "issuer_name": {
      "type": "string",
      "description": "Held company/issuer name (e.g. 'Apple') — give this or cusip"
    },
    "cusip": {
      "type": "string",
      "description": "9-char CUSIP of the held security — give this or issuer_name. (ticker is never accepted: 13F carries no authoritative ticker)"
    },
    "quarter": {
      "type": "string",
      "format": "date",
      "description": "As-of quarter-end the claim is about, ISO YYYY-MM-DD (e.g. '2026-06-30')"
    },
    "start": {
      "type": "string",
      "format": "date",
      "description": "Quarter-window start (ISO) if the claim spans quarters"
    },
    "end": {
      "type": "string",
      "format": "date",
      "description": "Quarter-window end (ISO) if the claim spans quarters"
    }
  },
  "required": [],
  "additionalProperties": false
}

README.md13 KBView on GitHub

Insider Buy Signals

Verify any U.S. SEC filing claim, field-by-field, against the filing it came from. Every figure here — shares, price, dollar value, percent, stake size — traces to a parsed field in a real EDGAR filing and ships with a link to that filing on sec.gov. Records that can't be linked to a filing are dropped, never guessed: no scores, no unsourced numbers. We call this filing-verified. We also ran the obvious question — does insider buying predict returns? — as four sealed, pre-registered tests. I tried four times to prove otherwise, and four times the data said no; the full record is at https://www.tradestarinsider.com/what-we-tested. This repo is the MIT-licensed MCP server, client library, and worked examples for the TradeStar Insider API.

Website: https://www.tradestarinsider.com
MCP server (Streamable HTTP, no auth): https://mcp.tradestarinsider.com/mcp
REST (OpenAPI 3.0.2): https://api.tradestarinsider.com/v1/openapi.json
Live status: https://status.tradestarinsider.com
What we tested (negative results): https://www.tradestarinsider.com/what-we-tested

Run the MCP server locally

The server is published as insider-signals-mcp — a tiny stdio proxy to the remote endpoint. Run it with no install using uvx:

bash

uvx insider-signals-mcp

To wire it into Claude Desktop, add this to claude_desktop_config.json:

json

{
  "mcpServers": {
    "insider-signals": {
      "command": "uvx",
      "args": ["insider-signals-mcp"]
    }
  }
}

Or point any MCP client straight at the remote endpoint (no proxy needed): https://mcp.tradestarinsider.com/mcp (Streamable HTTP, no auth). The verify tools are the core: check an insider purchase, an activist 13D stake, an 8-K event, or a 13F holding against its source filing.

What the data is

Five filing-verified families from SEC EDGAR (plus federal contract awards from USAspending):

Insider Form 4 purchases (SEC transaction code P) — cluster buys (two or more insiders buying the same company inside a window of seven calendar days or fewer) and buys large relative to the insider's existing holdings.
Activist Schedule 13D stakes, 13F fund position changes, and recent federal contract awards.

Code P does not by itself prove an open-market buy. A purchase filed under P can be an IPO / offering / private-placement allocation, so every purchase record carries an offering_context flag (true = allocation, not open-market) and clusters carry a uniform_price_cluster flag marking a single administered price. Option exercises, 10b5-1 planned sales, and sub-threshold noise (below $50,000) are dropped. Every field we return is parsed from a real filing and ships with its sec.gov link. Records that can't be linked to a filing are dropped, never guessed. No scores, no unsourced numbers. We call this filing-verified.

What the data is not

It is not a prediction. We ran four pre-registered, sealed tests for whether insider buying precedes price moves over our own history, and all four returned NULL — no return edge distinguishable from base rate — so we do not claim one. The full record (question, method, sample, number, verdict per test) is public at What we tested. This is a clean, filing-verified lookup and verification layer over public purchases — you decide what they mean. It is also not real-time: ingestion is a once-daily weekday cron, so new filings surface next business day, not live.

Coverage

Insider Form 4 buys: 172 U.S. trading days, 2026-01-20 → 2026-09-23, no gaps in the window (market holidays such as Presidents' Day carry no filings and are not gaps). Read the live number any time at /v1/health.
Completeness: we capture 93.70% of in-window open-market purchases (lower bound 87.28%); of the filings we skip, only 0.75% (95% CI 0.34–1.63%) turn out to be purchases we genuinely missed — the rest are sales, option exercises, amendments, and sub-$50k buys we exclude by design.

Install

bash

pip install insider-signals        # or, from a clone:  pip install -e .

Zero runtime dependencies — the client uses only the Python standard library.

Quickstart (free, no key)

The free tier answers on the open discovery surface with no key and per-IP rate limiting:

python

from insider_signals import InsiderSignals

api = InsiderSignals()                         # public base URL, no key

print(api.health()["datasets"]["insider"])     # coverage days + date range

for s in api.today():                          # today's filing-verified buys
    print(s["ticker"], s["value_usd"], s["filing_url"])

for s in api.clusters():                       # cluster buys (2+ insiders, ≤7 days)
    print(s["ticker"], s["cluster_insiders"], s["cluster_notional"])

# Verify a specific claim against the filings we hold:
v = api.verify("ETRA", "ORBIMED ADVISORS LLC")
print(v["status"], v["count"])                 # -> confirmed 2

See examples/rest_api.py for a runnable version.

Free tier vs. keyed tier

Tier	Methods	Access
Free (no key)	`health`, `today`, `clusters`, `verify`, `verify_13d`, `verify_8k`, `verify_13f`	Open `/public/v1`, per-IP rate limited
Keyed (RapidAPI)	`by_ticker`, `by_range`, `filing`, `fund_changes`, `federal_awards_recent`, `activist_stakes_recent`	Metered, through RapidAPI

For the keyed tier, subscribe on RapidAPI and construct the client with your key:

python

api = InsiderSignals(base_url="https://<your-rapidapi-host>", rapidapi_key="...")
for s in api.by_ticker("GME"):
    print(s["insider"], s["shares"], s["price_per_share"], s["filing_url"])

Calling a keyed method without a key raises InsiderSignalsError with status == 403.

Worked examples — one real request and response per tool

Every response below is a real capture from the live public API (coverage as of 2026-09-23).

`today` — today's insider buys

http

GET https://api.tradestarinsider.com/public/v1/signals/today

json

{
  "api_version": "v1",
  "endpoint": "signals/today",
  "rule2_guarantee": "Every record traces to a parsed SEC filing field and carries its source filing_url. Records without a filing link are dropped upstream and never returned.",
  "count": 0,
  "params": { "date": "2026-09-24" },
  "signals": []
}

(An empty set is normal pre-market / on a non-trading day; it repopulates the moment new filings materialize.)

`clusters` — cluster buys (2+ insiders, one issuer, ≤7 days)

http

GET https://api.tradestarinsider.com/public/v1/signals/clusters

json

{
  "api_version": "v1",
  "endpoint": "signals/clusters",
  "count": 1596,
  "signals": [
    {
      "filed_date": "2026-07-22",
      "ticker": "CLBK",
      "issuer_name": "Columbia Financial, Inc./MD/",
      "insider": "Splaine Thomas Jr",
      "relationship": { "director": false, "officer": true, "officer_title": "EVP, CFO" },
      "code": "P",
      "shares": 50000.0, "price_per_share": 10.0, "value_usd": 500000.0,
      "cluster": true, "cluster_insiders": 16, "cluster_notional": 4760370.0,
      "accession": "0001339736-26-000014",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/2115119/000133973626000014/0001339736-26-000014-index.htm"
    }
  ]
}

`verify` — confirm an insider open-market-purchase claim

http

GET https://api.tradestarinsider.com/public/v1/verify?ticker=ETRA&person=ORBIMED ADVISORS LLC

json

{
  "api_version": "v1",
  "endpoint": "verify",
  "coverage_start": "2026-01-20", "coverage_end": "2026-09-23",
  "coverage_note": "Checked SEC Form-4 open-market purchases (code P) collected 2026-01-20..2026-09-23. Absence here means not in this window — not absence at the SEC.",
  "status": "confirmed",
  "matched": ["ticker/issuer", "person"],
  "filings": [
    {
      "ticker": "ETRA", "issuer_name": "Electra Therapeutics, Inc.",
      "insider": "ORBIMED ADVISORS LLC",
      "code": "P", "shares": 1000000.0, "price_per_share": 15.0, "value_usd": 15000000.0,
      "filed_date": "2026-09-23", "accession": "0000947871-26-000880",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/2088082/000094787126000880/0000947871-26-000880-index.htm"
    }
  ],
  "count": 2,
  "message": "Confirmed: 2 matching Form-4 open-market purchase filing(s)."
}

A claim with no matching filing returns "status": "not_found" (in-window) or "out_of_coverage" (outside the collected days) — never a guess.

`verify_13d` — confirm a Schedule 13D activist-stake claim

http

GET https://api.tradestarinsider.com/public/v1/verify/13d?subject_name=New Fortress Energy Inc.&filer_name=Strategic Value Partners, LLC

json

{
  "endpoint": "verify/13d",
  "coverage_start": "2026-06-22", "coverage_end": "2026-09-18",
  "status": "confirmed",
  "filings": [
    {
      "filed_date": "2026-09-18", "form_type": "SCHEDULE 13D",
      "subject_name": "New Fortress Energy Inc.", "subject_tickers": ["NFE", "NFEGP"],
      "filer_name": "Strategic Value Partners, LLC",
      "percent_of_class": 14.7, "aggregate_amount_owned": 19208710.0,
      "signal": "new_13d_bare", "stated_intent": "New 13D. No activist purpose stated.",
      "accession": "0001193125-26-395888",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1749723/0001193125-26-395888.txt"
    }
  ],
  "count": 1,
  "message": "Confirmed: 1 matching Schedule 13D/13D-A filing(s)."
}

`verify_8k` — confirm an 8-K material-event claim

http

GET https://api.tradestarinsider.com/public/v1/verify/8k?cik=1650648&company_name=4D Molecular Therapeutics, Inc.

json

{
  "endpoint": "verify/8k",
  "coverage_start": "2025-03-06", "coverage_end": "2026-09-22",
  "status": "confirmed",
  "filings": [
    {
      "cik": "1650648", "company_name": "4D Molecular Therapeutics, Inc.",
      "accession": "0001193125-26-277563",
      "filing_date": "2026-06-22", "event_date": "2026-06-17", "form": "8-K",
      "items": [{ "code": "5.07", "label": "Submission of Matters to a Vote of Security Holders" }],
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1650648/000119312526277563/"
    }
  ],
  "count": 4,
  "message": "Confirmed: 4 matching 8-K filing(s) carrying the claimed item(s)."
}

`verify_13f` — confirm a 13F institutional-holding claim

http

GET https://api.tradestarinsider.com/public/v1/verify/13f?filer=BERKSHIRE HATHAWAY INC&issuer_name=ALPHABET INC&quarter=2026-06-30

json

{
  "endpoint": "verify/13f",
  "coverage_start": "2024-06-30", "coverage_end": "2026-06-30",
  "coverage_note": "Values are AS-OF quarter-end and up to ~45 days stale.",
  "status": "held",
  "filings": [
    {
      "filer_name": "BERKSHIRE HATHAWAY INC",
      "as_of_quarter_end": "2026-06-30", "filed_date": "2026-08-14", "lag_days": 45,
      "change": "added", "issuer_name": "ALPHABET INC", "title_of_class": "CAP STK CL A",
      "value_usd": 28157599351, "prior_value_usd": 15600071913, "ssh_prnamt": 78791167,
      "accession": "0001193125-26-352200",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/"
    }
  ],
  "count": 2,
  "message": "Held: 2 matching 13F position(s) reported as of the covered quarter."
}

Response shape

Every data route returns the same envelope; the rows live under signals, and the client's list-returning methods hand you that list directly. The verify* methods return the full envelope (you want the status and matched/filings fields).

MCP server (for AI assistants)

Ask an AI client (Claude and other MCP clients) for these signals directly. Open, free, per-IP rate limited — no API key, no OAuth:

bash

claude mcp add --transport http insider-signals https://mcp.tradestarinsider.com/mcp

Then ask: "Show today's insider buy signals" or "Any insider cluster buys this week? Link the filings." See examples/mcp_client.md for the tool list and a programmatic SDK example.

Pricing

Plan	Price	Requests
Basic	$0	3,000 / month
Pro	$18 / month	10,000 / month
Ultra	$58 / month	100,000 / month
Mega	$100 / month	500,000 / month

Hard limits, no overage — requests over the cap return 429 until the window resets. The free discovery surface and the MCP server are open and per-IP rate limited; metered API billing runs through RapidAPI.

Disclaimer

Information, not investment advice. Every figure is parsed from a public SEC filing and links to its source on sec.gov. Insider buying guarantees nothing — insiders are wrong plenty — but open-market purchases are real money on the line.

License

MIT. Changelog: CHANGELOG.md.

Install

Tools (9)

insider_buysinsider_cluster_buysfederal_awards_recentactivist_stakes_recentfund_position_changesverify_insider_purchaseverify_activist_13dverify_8k_event

Configuration

Environment variables

INSIDER_SIGNALS_MCP_URL

Optional override for the remote MCP endpoint (defaults to https://mcp.tradestarinsider.com/mcp).

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "edgar-insider-signals": {
      "command": "uvx",
      "args": [
        "insider-signals-mcp"
      ],
      "env": {
        "INSIDER_SIGNALS_MCP_URL": "<YOUR_INSIDER_SIGNALS_MCP_URL>"
      }
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

insider_buys

insider_cluster_buys

federal_awards_recent

activist_stakes_recent

fund_position_changes

verify_insider_purchase

verify_activist_13d

verify_8k_event

verify_13f_change

Insider Buy Signals

Run the MCP server locally

What the data is

What the data is not

Coverage

Install

Quickstart (free, no key)

Free tier vs. keyed tier

Worked examples — one real request and response per tool

today — today's insider buys

clusters — cluster buys (2+ insiders, one issuer, ≤7 days)

verify — confirm an insider open-market-purchase claim

verify_13d — confirm a Schedule 13D activist-stake claim

verify_8k — confirm an 8-K material-event claim

verify_13f — confirm a 13F institutional-holding claim

Response shape

MCP server (for AI assistants)

Pricing

Disclaimer

License

Install

Configuration

Related servers

`today` — today's insider buys

`clusters` — cluster buys (2+ insiders, one issuer, ≤7 days)

`verify` — confirm an insider open-market-purchase claim

`verify_13d` — confirm a Schedule 13D activist-stake claim

`verify_8k` — confirm an 8-K material-event claim

`verify_13f` — confirm a 13F institutional-holding claim