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 集成