# SEC EDGAR MCP Server — Query Filings from Agents

> SEC EDGAR MCP Server lets agents query filings (10-K/10-Q/8-K) with exact numbers and source URLs. Verified 265★; Docker quickstart in ~5–10 minutes.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
# MCP config (docker stdio):
# command: docker
# args: ["run","-i","--rm","-e","SEC_EDGAR_USER_AGENT=Your Name (you@email.com)","stefanoamorelli/sec-edgar-mcp:latest"]
```

## Intro

SEC EDGAR MCP Server lets agents query filings (10-K/10-Q/8-K) with exact numbers and source URLs. Verified 265★; Docker quickstart in ~5–10 minutes.

**Best for:** Analysts and developers who want auditable EDGAR lookups inside an agent workflow

**Works with:** Any MCP client that can run Docker; optional Python streamable HTTP transport

**Setup time:** 5-10 minutes

### Key facts (verified)

- GitHub: 265 stars · 76 forks · pushed 2026-05-13.
- License: AGPL-3.0 · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `docker run -i --rm -e SEC_EDGAR_USER_AGENT='Your Name (you@email.com)' stefanoamorelli/sec-edgar-mcp:latest`.

## Main

- Use it when numeric fidelity matters: README positions the server as exact numeric SEC filing access and includes SEC URLs for verification.

- Start with Docker stdio as in README, then switch to streamable HTTP only on private networks (README warns there is no auth).

- If you run evals, README documents a Promptfoo-based test suite under `evals/` to measure tool reliability.

### Source-backed notes

- README provides a Docker-based MCP client config and notes `-i` is required for JSON-RPC communication.
- README states the project is not affiliated with the SEC and is built on the edgartools library.
- README documents streamable HTTP transport via `python -m sec_edgar_mcp.server --transport streamable-http --port 9870` with a warning about no authentication.

### FAQ

- **Do I need to set a User-Agent?**: Yes — README passes `SEC_EDGAR_USER_AGENT` for SEC-friendly requests.
- **Is streamable HTTP secure by default?**: No — README says there is no auth; run it only on private networks.
- **Does it include evals?**: Yes — README references a Promptfoo test suite under `evals/`.

## Source & Thanks

> Source: https://github.com/stefanoamorelli/sec-edgar-mcp
> License: AGPL-3.0
> GitHub stars: 265 · forks: 76

---

<!-- ZH -->

## Quick Use

```bash
# MCP config (docker stdio):
# command: docker
# args: ["run","-i","--rm","-e","SEC_EDGAR_USER_AGENT=Your Name (you@email.com)","stefanoamorelli/sec-edgar-mcp:latest"]
```

## Intro

SEC EDGAR MCP Server 让 agent 精确查询 10-K/10-Q/8-K 等申报，并返回可核对的来源链接。已验证 265★；用 Docker 大约 5–10 分钟可跑通。

**Best for:** 想把 EDGAR 查询纳入 agent 流程且可审计可复核的分析/研发团队

**Works with:** 任意可运行 Docker 的 MCP 客户端；也支持 Python 的 streamable HTTP 传输

**Setup time:** 5-10 minutes

### Key facts (verified)

- GitHub：265 stars · 76 forks；最近更新 2026-05-13。
- 许可证：AGPL-3.0；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`docker run -i --rm -e SEC_EDGAR_USER_AGENT='Your Name (you@email.com)' stefanoamorelli/sec-edgar-mcp:latest`。

## Main

- 适合“数值必须可靠”的场景：README 强调对申报数据的精确解析，并返回可核对的 SEC 链接。

- 先按 README 用 Docker stdio 跑通；需要 HTTP 时再切到 streamable HTTP，并仅在内网使用（README 提示无认证）。

- 想评估稳定性可参考 README：`evals/` 里有基于 Promptfoo 的测试套件。

### Source-backed notes

- README 给出 Docker 的 MCP 配置，并说明 JSON-RPC 需要 `-i` 交互模式。
- README 声明项目与 SEC 无隶属关系，并基于 edgartools 构建。
- README 提供 streamable HTTP 启动命令，并提醒该模式不含认证，仅建议私网使用。

### FAQ

- **需要配置 User-Agent 吗？**：需要。README 通过 `SEC_EDGAR_USER_AGENT` 传入标识，符合 SEC 访问要求。
- **HTTP 模式默认安全吗？**：不是。README 说明无认证，只建议在私网使用。
- **有评测/测试吗？**：有。README 指向 `evals/` 的 Promptfoo 测试套件。

## Source & Thanks

> Source: https://github.com/stefanoamorelli/sec-edgar-mcp
> License: AGPL-3.0
> GitHub stars: 265 · forks: 76


---
Source: https://tokrepo.com/en/workflows/sec-edgar-mcp-server-query-filings-from-agents
Author: MCP Hub