MCP server

FilingPulse runs a hosted Model Context Protocol server, so AI agents — Claude, ChatGPT, Cursor, anything that speaks MCP — can query normalized SEC EDGAR filings directly:

https://mcp.filingpulse.io/mcp

Streamable HTTP, read-only, no key and no install required. The 32-odd EDGAR MCP servers on the registries run locally against raw EDGAR; this one is hosted and serves the same already-normalized schema-v1 objects as our REST API — full transaction legs, footnotes, owner roles, item codes, file-number threading — from a pipeline that ingests continuously. FilingPulse is data infrastructure: tools report what was filed with the SEC, never signals or advice.

Connect a client

Claude Code

claude mcp add --transport http filingpulse https://mcp.filingpulse.io/mcp

Claude (web and desktop)

Settings → Connectors → Add custom connector → paste https://mcp.filingpulse.io/mcp. No authentication.

ChatGPT (Developer Mode)

Settings → Connectors → Advanced → enable Developer mode, then add a connector with the same URL and no authentication. Requires a plan with Developer Mode access.

Cursor

// .cursor/mcp.json
{"mcpServers": {"filingpulse": {"url": "https://mcp.filingpulse.io/mcp"}}}

VS Code (Copilot agent mode)

// .vscode/mcp.json
{"servers": {"filingpulse": {"type": "http", "url": "https://mcp.filingpulse.io/mcp"}}}

Tools

Seven read-only tools over the same tables the REST API serves. List tools return the standard {"data": […], "total": n, "limit": n, "offset": n} envelope, newest filed first; numeric values are strings exactly as filed (schema v1). List and status results also carry a source object naming FilingPulse and a web URL — the human-browsable page showing the same data (a ticker page, an 8-K item page, or a directory) — so agents can cite where results came from. These URLs carry a ?src=mcp marker; it is attribution only, and the pages serve identically without it.

ToolWhat it returns
get_insider_tradesInsider ownership filings — Form 4 transactions plus Form 3/5 (live-forward since 2026-09-23); filter by ticker, CIK, form type (3 / 4 / 5, /A variants), or since-date. compact=true returns one summary row per filing (owners, roles, leg counts, open-market P/S aggregates) at up to 100 rows per call — built for day-wide sweeps.
get_insider_filingOne insider ownership filing (Form 3/4/5) by accession number, with all transaction legs, holdings, and footnotes.
get_corporate_events8-K events classified by official item code (2.02 results, 5.02 leadership changes, …).
get_ipo_registrationsS-1/F-1 registration lifecycle events, threaded across stages by SEC file number.
get_registration_eventOne registration lifecycle event by accession number.
get_dataset_statusRow counts and the covered date range per dataset, plus an evaluated data_freshness verdict (ok / warn / critical against SEC EDGAR’s filing calendar — the same rule as GET /v1/health).
get_schemaThe frozen schema-v1 contract, section by section, including the transaction-code table.

Prompts

Three ready-made task prompts (MCP prompts/list — most clients surface them as slash commands or prompt pickers). Each renders a concrete task over the tools with the date window already computed server-side:

PromptArgumentsWhat it does
insider_activityticker (optional), days (90; 7 market-wide)Summarize Form 4 insider transactions for one issuer: buys vs sells, distinct insiders, largest priced transactions, amendments. Without a ticker: a market-wide view of the newest filings.
events_digestticker (optional), days (30; 7 market-wide)Digest recent 8-K filings grouped by official item code, with accession numbers and links to the original filings. Without a ticker: a market-wide digest of the newest events.
ipo_pipelinedays (14)Report new S-1/F-1 registration statements and freshly priced prospectuses, threaded per offering by SEC file number.

Every prompt reports what was filed with the SEC — none produce investment advice, signals, or recommendations. The full API docs are also served in-band as MCP resources (resources/list: llms.txt + llms-full.txt).

Limits

The anonymous MCP endpoint is a discovery tier: 20 tool calls per minute per IP, at most 25 full-object rows per list call (100 rows in get_insider_trades' compact survey mode). That is deliberately enough to explore the data and answer real questions in a chat, and deliberately not enough to run a sync pipeline. For programmatic access — bigger pages, monthly quotas, incremental since= sync, HMAC-signed webhooks — get a free API key (no card) and use the REST API. Coverage note: Form 4 and 8-K data extend backward continuously as our backfill runs; registration events are tracked live since Aug 1, 2026 and Forms 3/5 live since Sep 23, 2026 — neither is backfilled. get_dataset_status reports the exact current window.

Raw protocol

The endpoint speaks standard MCP JSON-RPC over streamable HTTP (protocol 2025-11-25, with 2025-06-18 and 2025-03-26 also accepted at negotiation; stateless — no session ids). To see the tool list without an MCP client:

curl -s https://mcp.filingpulse.io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'