SEC EDGAR Filings MCP

io.github.stagproject由 GitHub 帳號 stagproject 發布v1.0.2更新於 Nov 2, 2026

SEC EDGAR MCP: search, preview, purchase filings. x402 USDC on Polygon. xpay + Cloud Run upstream.

發布方自己的服務：SEC Filings

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

遠端 MCP 伺服器，用於 SEC EDGAR 結構化申報文件：搜尋文件、預覽樣本，並以 Polygon 上的 USDC 購買完整文件。

可以做什麼
  • 在財務掛牌檢視中搜尋 SEC EDGAR 結構化申報文件
  • 購買前預覽文件樣本
  • 透過 x402 以 Polygon 上的 USDC 購買完整文件，並以交易雜湊重新遞送
  • 透過 MCP Streamable HTTP 對託管端點呼叫同一組工具
適用情境
當助理需要查詢 SEC EDGAR 申報文件，且願意為完整文件按次付費時使用；搜尋與樣本有免金鑰的試用途徑。
執行需求
遠端 streamable HTTP 端點；正式存取需要 xpay API 金鑰，透過 key 標頭（或 key 查詢參數）傳入。Cloud Run 上游與 Glama 沙箱可在無金鑰時進行搜尋與樣本呼叫。本機開發需要 Python 與 uv，並在 .env 中設定 Supabase 與 x402 憑證。
安裝前請注意
purchase_filing 會產生費用：透過 x402 以 Polygon 上的 USDC 付款，涉及錢包與資金。xpay 金鑰屬於機密，不應外流。文件資料來自由外部流程填入的 Supabase 檢視，請求會經過 xpay 與 Cloud Run 等第三方。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SEC EDGAR Filings MCP，將其新增到工作區。
  2. 連接 key 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.stagproject%2Fsec-filings-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "sec-edgar-filings": {
      "type": "http",
      "url": "https://sec-edgar-filings.mcp.xpay.sh/mcp",
      "headers": {
        "key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

sec-filings-mcp

[SEC EDGAR Filings MCP]

SEC EDGAR structured filing MCP for agents: search_filings, get_filing_sample, purchase_filing. Data lives in Supabase views (fi_listings_portfolio, fi_listings_portfolio_compact) populated by the finance-factory pipeline.

Read firstFile
Try without xpay keydocs/TRY_WITHOUT_XPAY.md — Glama sandbox or Cloud Run upstream
Distribution (you vs repo)docs/DISTRIBUTION.md · docs/HANDOFF.md
Build / handoffMCP_FINANCE_BUILD.md
Env template.env.example → copy to .env
Glamaglama.json (maintainers: stagproject); build fix: GLAMA_BUILD.md
A2A / x402docs/A2A.md — Agent Card + payment mapping
MCP Registryio.github.stagproject/sec-filings-mcp — docs/MCP_REGISTRY.md
Discovery URLsdocs/DISCOVERY.md

Template reference: mcp_server.py (patent MCP, unmodified). Runtime: mcp_server_finance.py.

Protocol stack (MCP + A2A + x402)

LayerHow to use
MCP (production)xpay URL below — tools/call on search_filings, get_filing_sample, purchase_filing
A2A (discovery)Agent Card on Cloud Run upstream (xpay blocks /.well-known/*): https://sec-filings-mcp-1065601264332.us-central1.run.app/.well-known/agent-card.json
x402 (payment)purchase_filing — 402 + Polygon USDC + tx_hash redelivery

Native A2A JSON-RPC task API is on the roadmap; today agents invoke via MCP Streamable HTTP. Details: docs/A2A.md.

Try first (no xpay API key)

PathURL / action
Glama sandboxOpen server → Try in Browser
Cloud Run trialhttps://sec-filings-mcp-1065601264332.us-central1.run.app/mcp — search_filings + get_filing_sample without ?key=

Details: docs/TRY_WITHOUT_XPAY.md.
xpay proxy always needs a key; per-tool $0 is allowed on xpay (docs) but is not the same as “no signup.”

Connect (production)

EndpointURL
xpay (billing + catalog)https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY
Cloud Run (upstream)https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp

Register / manage on xpay.tools. Slug: sec-edgar-filings.
Publisher checklist (finance collection, awesome list): docs/DISTRIBUTION.md.

Local dev

powershell
git clone https://github.com/stagproject/sec-filings-mcp.git
cd sec-filings-mcp
copy .env.example .env
# Edit .env with Supabase + x402 keys
uv sync
# Run once in Supabase SQL Editor: sql/fi_processed_transactions.sql
uv run python mcp_server_finance.py --sse
# MCP: http://127.0.0.1:8081/mcp  (PORT in .env)

Tests:

powershell
uv run python test_finance_mcp.py
uv run python test_finance_mcp.py --xpay-only --e2e

Cloud Run

powershell
gcloud run deploy sec-filings-mcp `
  --source . `
  --region us-central1 `
  --allow-unauthenticated `
  --port 8080

Set env vars from .env (not committed). Do not deploy .env.cloudrun.yaml to git.

Glama

Listed at glama.ai/mcp/servers/stagproject/sec-filings-mcp — use Try in Browser for a no-key sandbox; production traffic uses xpay or Cloud Run above.

MCP Registry

text
io.github.stagproject/sec-filings-mcp

Publish / update: docs/MCP_REGISTRY.md. Search: https://registry.modelcontextprotocol.io

License

MIT — see LICENSE.md.

來源：README.md，提交 0cc0dd8

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Filings 整合

SEC Filings

tools.filings官方發布者

讀取公開的 SEC EDGAR 申報文件、已揭露的 XBRL 財務資料與抽樣申報比較，並保留來源連結與 accession 編號。

Streamable HTTP可網頁執行
金融5 個工具Nov 7, 2026

SEC filings

由 GitHub 帳號 ladanyin 發布

遠端 MCP 伺服器，讓助理取得美國公司最新 10-K、10-Q 或 8-K 的摘錄，以及最新全年營收或淨利。

Streamable HTTP可網頁執行驗證方式
金融2 個工具Nov 6, 2026

getfilings: the Filings door

由 GitHub 帳號 allooloo 發布

遠端 MCP 路由服務，依日期區間回傳發行人的已簽章、附回執的監理申報與公告，並提供發行人查詢與市場節點清單。

Streamable HTTP可網頁執行
金融3 個工具Nov 5, 2026

US SEC EDGAR Filings, FDIC Bank Solvency & EPA/OSHA

由 GitHub 帳號 jesleytassili-glitch 發布

分析SEC EDGAR的10-K/8-K/Form 4檔案、FDIC銀行償付能力比率、EPA ECHO與OSHA違規記錄。AI 翻譯

Streamable HTTP可網頁執行驗證方式
需要憑證Nov 3, 2026

SEV — Company Discovery from SEC Filings

由 GitHub 帳號 ETSquareAI 發布

本機 MCP 伺服器，把研究問題轉成依相關度排序的公司，並附上經核實的 SEC 10-K/10-Q 段落與財務資料。

STDIO僅桌面
網頁搜尋與抓取未驗證 · 伺服器未能啟動Nov 1, 2026