EDGAR MCP — SEC companyfacts, frames, Form 4, 13F

User-Agent로 SEC EDGAR에 연결하는 MCP 서버입니다. API 키는 없습니다. 재무 데이터는 FMP가 아니라 companyfacts / frames로 읽으며, XBRL 태그 매핑은 xbrl_map.py에 있습니다.

도구

Related MCP server: sec-edgar-mcp

설치

cd edgar-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

.env에서 EDGAR_USER_AGENT는 실명 + 이메일이어야 합니다. SEC는 일반적인 python-requests 에이전트를 403으로 차단합니다.

EDGAR_USER_AGENT=Your Name your.email@example.com
MCP_TRANSPORT=stdio

Cursor (stdio)

%USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "edgar": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "C:\\Users\\yunus\\Documents\\dev\\edgar-mcp",
      "env": {
        "MCP_TRANSPORT": "stdio",
        "EDGAR_USER_AGENT": "Your Name your.email@example.com"
      }
    }
  }
}

Railway → Claude (Streamable HTTP)

PORT가 있으면 기본 transport는 http이고 엔드포인트는 https://<railway-host>/mcp입니다. MCP_TRANSPORT=stdio를 설정하지 마세요 — 프로세스가 수신 대기하지 않아 Railway는 "online"으로 표시되지만 Claude는 연결할 수 없습니다.

변수

확인: https://<host>/health → {"ok": true, ...}

Claude (claude.ai / Desktop Connectors)

1. Customize → Connectors → Add custom connector

2. URL: https://<host>/mcp (끝에 /sse 아님)

3. OAuth 필드는 비워 두고 Individual sign-in은 끄세요

4. Add를 누른 뒤 채팅에서 + → Connectors로 여세요

Claude Code가 header를 보낼 수 있다면 MCP_AUTH_REQUIRED=true 및 Authorization: Bearer <token>을 사용하세요.

이전 /sse 방식은 MCP_TRANSPORT=sse로 설정하세요 (Claude connector에는 권장하지 않음).

테스트

python -m unittest tests.test_xbrl_map tests.test_form_parsers tests.test_http_auth tests.test_client_utils

참고 자료

• companyfacts / concept / frames: https://data.sec.gov

• submissions: https://data.sec.gov/submissions

• archives: https://www.sec.gov/Archives/edgar

• full-text: https://efts.sec.gov/LATEST/search-index

• Fair Access: https://www.sec.gov/os/webmaster-faq#code-support (최대 10 req/s, User-Agent 필수)

13F 값은 SEC 관례에 따라 천(千) USD 단위입니다. 13F는 주식이 아니라 기관이 제출합니다.