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

User-Agent で SEC EDGAR に接続する MCP サーバー。API キーは不要。財務データは FMP ではなく companyfacts / frames から読み取ります。XBRL タグのマッピングは xbrl_map.py にあります。

ツール

Related MCP server: edgarmcp

インストール

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 がある場合、デフォルトのトランスポートは http で、エンドポイントは https://<railway-host>/mcp です。MCP_TRANSPORT=stdio を設定しないでください — プロセスは待機せず、Railway は「オンライン」と表示されますが、Claude は接続できません。

変数

確認: https://<host>/health → {"ok": true, ...}

Claude（claude.ai / Desktop Connectors）

1. Customize → Connectors → Add custom connector

2. URL: https://<host>/mcp（末尾に /sse は付けない）

3. Request headers → Authorization = Bearer <MCP_AUTH_TOKEN>（Bearer のスペースを含む）

4. Add をクリックし、チャットで + → Connectors から開く

Claude Code

claude mcp add --transport http edgar https://<host>/mcp --header "Authorization: Bearer <MCP_AUTH_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 リクエスト/秒、User-Agent 必須）

13F の値は SEC の慣例に従い千米ドルです。13F は株式ではなく、機関が提出します。