com.agentfilings由 agentfilings.com 發布官方發布者v1.1.0更新於 Oct 24, 2026
SEC filings, XBRL earnings, Form 4 insiders for ~2,800 US SEC filers. x402 pay-per-call, no signup.
遠端 MCP 伺服器，為助理提供結構化的美國 SEC 資料：最新申報文件、XBRL 財報摘要與 Form 4 內部人交易，按次付費。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/com.agentfilings%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"agentfilings": {
"type": "http",
"url": "https://api.agentfilings.com/mcp"
}
}
}Structured US SEC/EDGAR filing data for AI agents — filings index, XBRL-derived earnings, and Form 4 insider transactions as clean JSON, over both HTTP and MCP.
Paid per call with x402 (USDC on Base mainnet, no account required). A flat
Stripe subscription rail — API-key issuance, subscription gate, checkout and
webhook — is implemented in apps/api/src/billing/ but not switched on in the live
deployment.
Live at api.agentfilings.com ·
OpenAPI ·
llms.txt ·
MCP at https://api.agentfilings.com/mcp, listed in the official MCP registry as
com.agentfilings/mcp, with an MCP Server Card,
an AI Catalog and an
x402 manifest for discovery.
Most of the work went into three things that are easy to get wrong with SEC data, and one that's easy to get wrong with agent payments.
Restatements. companyfacts returns the same period once per filing that
reported it. When a company restates a figure, the superseded value is still in the
API. Each period here reconciles to its most recently filed value rather than the
first one encountered.
Fiscal period provenance. The fy/fp fields on a fact describe the filing,
not the period. A 10-Q showing last year's quarter as a comparative stamps that
older period with the newer filing's fiscal year. Each period here keeps the labels
from the filing that originally reported it. benchmark/ is a
runnable measurement of how often those disagree.
Entity identity. SEC's ticker map can point at a post-reorganization shell that
holds the ticker and files no financial data. Resolution is CIK-authoritative, with
a guard that refuses to record coverage for an entity reporting no us-gaap facts.
Payment replay. Every x402 payment proof is bound to the specific resource it paid for, so a proof issued for one endpoint or MCP tool cannot be replayed against another. Settlement is idempotent, and EIP-712 domains are read per-network from the USDC contracts rather than hardcoded.
/probe is free, and it will tell you not to pay:
A company can be covered for filings and empty for earnings — foreign issuers filing under IFRS, pre-revenue companies. Charging for a call that returns nothing is the fastest way to lose an automated buyer permanently, so the service says so before taking money.
packages/shared/src/pricing.ts is the single source of truth for the API surface.
The payment middleware, /probe, the MCP tool list and the OpenAPI document all
derive from it.
Payments are gated off by default, so paid routes serve openly in development.
Ingestion requires SEC_CONTACT_EMAIL — the SEC requires a contact in the
User-Agent and blocks requests without one. See .env.example
and infra/DEPLOY.md.
/health and /probe are always free, and
/probe never overstates coverage.MIT. Data is SEC EDGAR, public domain.
來源：README.md，提交 1d8f51b
Check coverage and pricing (free)
FREE — no payment required. Call this FIRST to check whether a ticker is covered and what it will cost before spending anything. Returns whether the company is in the corpus, how much data exists (filings / earnings periods / insider transactions), how fresh it is, and the exact price of every paid tool. If a ticker is not covered, the paid tools return no data — so check here instead of paying to find out.
tickerGet latest filings
Latest SEC filings for a US public company, as structured JSON: form type, filing date, period, accession number, and a direct link to the document. Pre-indexed, so this is one fast call instead of crawling EDGAR and parsing its index pages. Use it to answer 'what has this company filed recently?' or to locate a specific 10-K/10-Q/8-K before reading it. Price: $0.01 per call (x402 USDC on Base, or a Stripe API key). Check coverage first with probe_coverage (free).
formlimitticker必填Get earnings summary
Revenue, net income, and basic/diluted EPS by fiscal period for a US public company, normalized from SEC XBRL data. Handles the parts that are easy to get wrong: revenue tags changed over time, restated figures are reconciled to the latest value, and each period keeps the fiscal year/quarter from its ORIGINAL filing (prior-year comparatives inside later filings do not corrupt the labels). Every period carries its source accession number and filing date. Use it for trend analysis, growth rates, or a specific quarter's results. Price: $0.02 per call (x402 USDC on Base, or a Stripe API key). Check coverage first with probe_coverage (free).
periodticker必填Get insider transactions
Form 4 insider transactions for a US public company: who traded, their role (director/officer/10% owner), transaction code, share count, price, and shares held afterwards. Parsed from the raw ownership XML, including derivative transactions, so you get structured rows instead of one XML document per trade. Use it to detect insider buying/selling activity or check a specific executive. Price: $0.01 per call (x402 USDC on Base, or a Stripe API key). Check coverage first with probe_coverage (free).
sinceticker必填已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
# Free. Tells you what data exists before you spend anything.curl "https://api.agentfilings.com/probe?ticker=AAPL"{ "ticker_coverage": { "covered": true, "endpoints_with_data": ["/filings/latest", "/earnings/summary"], "empty_endpoints": ["/insiders"], "hint": "Partial coverage. /filings/latest and /earnings/summary will return data. /insiders would return an empty result, so do not pay for those." }}apps/api/ TypeScript / Hono — HTTP API + MCP server src/payments/ x402 v2: routes config, replay guard, idempotency, discovery src/billing/ Stripe rail: key issuance, subscription gate, checkout, webhook src/mcp/ MCP over streamable HTTP, paid tools src/repo/ Corpus access (Postgres in prod, local JSON in tests)apps/ingest/ Python 3.12 — SEC ingestion, XBRL + Form 4 parserspackages/shared/ Pricing table, x402 constants, response typesinfra/migrations/ SQL schemabenchmark/ Standalone, runnable SEC XBRL correctness measurementtests/ Cross-cutting, including the payment-security specpnpm installpnpm test # vitest — api + sharedpnpm typecheckpnpm lintpnpm dev # http://localhost:8080
curl localhost:8080/healthcurl "localhost:8080/probe?ticker=AAPL"