Toolstem Sec MCP Server

Toolstem SEC MCP Server

Signal-first SEC EDGAR intelligence for AI agents. Five tools that answer questions directly — "Is the CEO buying?", "Has there been a restatement?", "Is an activist circling?" — instead of returning raw filing lists.

---

Why this exists

Existing SEC data tools give agents paginated filing lists and raw XML. Agents then have to parse, classify, and derive signals themselves — burning context window on bureaucratic extraction instead of analysis.

Toolstem SEC MCP Server pre-computes five high-value signals directly from SEC EDGAR's public submissions API, returning structured, agent-ready JSON. No third-party data providers, no API keys, no per-symbol fees — just SEC EDGAR's authoritative source with a rate-limiter that keeps you off their blocklist.

---

The five tools

1. get_company_filings_summary

Overview of a company's filing activity: last 20 filings + computed signals.

Example output (abbreviated):

{
  "ticker": "AAPL",
  "cik": "0000320193",
  "company_name": "Apple Inc.",
  "signals": {
    "filing_velocity": "NORMAL",
    "material_event_count_90d": 4,
    "disclosure_volume_trend": "RISING",
    "latest_form_types": ["8-K", "4", "DEF 14A"]
  },
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

2. get_insider_signal

Probes Form 3/4/4A insider filing activity within a lookback window.

Returns: recent_insider_filings (accession numbers + SEC URLs for Forms 3/4/4A), lookback_days, and counts.

v0.1 note: When at least one Form 3/4/4A filing exists in the lookback window, insider_signal is null ("direction unknown — Form 4 XML parsing ships in v0.2"). When no insider filings exist in the window, insider_signal is "NEUTRAL" ("verified absence of activity"). buy_count and sell_count are 0 in v0.1.

Example output (abbreviated):

{
  "ticker": "MSFT",
  "cik": "0000789019",
  "company_name": "MICROSOFT CORP",
  "lookback_days": 90,
  "insider_signal": null,
  "net_transaction_count": 0,
  "buy_count": 0,
  "sell_count": 0,
  "recent_insider_filings": [
    {
      "accession_number": "0001127602-26-001234",
      "filing_date": "2026-04-15",
      "sec_url": "https://www.sec.gov/Archives/edgar/data/789019/000112760226001234/0001127602-26-001234-index.htm"
    }
  ],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

3. get_institutional_signal

Probes for activist investor activity via SC 13D / 13D/A filings.

v0.1 note: institutional_signal and recent_13f_count are null/0. Quarterly 13F XBRL/XML parsing (ACCUMULATING / HOLDING / DISTRIBUTING) ships in v0.2.

Example output (abbreviated):

{
  "ticker": "NVDA",
  "cik": "0001045810",
  "company_name": "NVIDIA CORP",
  "quarters_back": 4,
  "institutional_signal": null,
  "recent_13f_count": 0,
  "activist_risk_flag": false,
  "recent_13d_filings": [],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

4. get_material_events_digest ⚡ premium ($0.02)

Severity-ranked digest of all 8-K and 8-K/A filings within a lookback window. Maps each item code to a plain-English label and severity rating.

Returns: events[] (sorted newest-first), redflag_count, category_counts.

Example output (abbreviated):

{
  "ticker": "TSLA",
  "cik": "0001318605",
  "company_name": "Tesla, Inc.",
  "lookback_days": 180,
  "redflag_count": 1,
  "category_counts": { "RED": 1, "YELLOW": 3, "GREEN": 7 },
  "events": [
    {
      "accession_number": "0001628280-26-005678",
      "filing_date": "2026-04-10",
      "form": "8-K",
      "items": [
        { "code": "4.02", "label": "Non-Reliance on Previously Issued Financial Statements", "category": "financial", "severity": "RED" }
      ],
      "sec_url": "https://www.sec.gov/Archives/edgar/data/1318605/000162828026005678/0001628280-26-005678-index.htm"
    }
  ],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

5. compare_disclosure_signals

Side-by-side comparison of 2-5 companies across all key disclosure signals. All lookups run in parallel.

Returns per-company: filing_velocity, material_event_count_90d, redflag_count_365d, activist_risk_flag, last_filing_date.

Returns winners (as CIKs, not tickers — cross-reference with the companies[] array): quietest_disclosure, most_active, most_redflags, activist_targets.

Example output (abbreviated):

{
  "companies": [
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "filing_velocity": "NORMAL",
      "material_event_count_90d": 4,
      "redflag_count_365d": 0,
      "activist_risk_flag": false,
      "last_filing_date": "2026-04-25"
    },
    {
      "ticker": "MSFT",
      "cik": "0000789019",
      "filing_velocity": "ACCELERATING",
      "material_event_count_90d": 7,
      "redflag_count_365d": 0,
      "activist_risk_flag": false,
      "last_filing_date": "2026-04-26"
    }
  ],
  "winners": {
    "quietest_disclosure": "0000320193",
    "most_active": "0000789019",
    "most_redflags": null,
    "activist_targets": []
  },
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

Installation

npm (MCP stdio transport)

npm install -g toolstem-sec-mcp-server

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "toolstem-sec": {
      "command": "toolstem-sec-mcp-server"
    }
  }
}

No API key required.

Hosted on Apify

Run the Actor directly or connect via the MCP gateway:

https://mcp.apify.com/?tools=toolstem/toolstem-sec-mcp-server

Actor input example:

{
  "tool": "get_material_events_digest",
  "ticker_or_cik": "TSLA",
  "lookback_days": 365
}

HTTP server (self-hosted)

npm install -g toolstem-sec-mcp-server
toolstem-sec-mcp-server --http
# Listens on http://0.0.0.0:3000/mcp

---

SEC EDGAR fair-access policy

All outbound traffic goes through a shared sliding-window rate limiter (8 rps target, 4 rps safety margin below SEC's 10 rps hard cap). Every request includes a User-Agent header identifying the package and a contact email per SEC policy. Override the contact email via:

SEC_USER_AGENT_CONTACT=you@yourorg.com toolstem-sec-mcp-server

Violating SEC's fair-access policy can result in your IP being blocked. This server is designed to stay compliant automatically.

---

v0.2 roadmap

• Form 4 XML parsing — direction-aware insider signals (STRONG_BUYING / BUYING / NEUTRAL / SELLING / STRONG_SELLING) with net share counts
• 13F XBRL parsing — quarterly institutional flow signals (ACCUMULATING / HOLDING / DISTRIBUTING) with institution count
• 8-K text extraction — natural-language summaries of each material event from the filing's primary HTML document

---

License & author

MIT License — see LICENSE.

Built by Toolstem. Data sourced directly from SEC EDGAR.