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

MCP-сервер, подключающийся к SEC EDGAR через User-Agent. Без 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 должен содержать настоящее имя + email. 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, endpoint — 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 может отправлять заголовок, используйте MCP_AUTH_REQUIRED=true и Authorization: Bearer <token>.

Для старого /sse установите MCP_TRANSPORT=sse (не выбирайте для коннектора Claude).

Тест

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 (max 10 req/s, User-Agent обязателен)

Значения 13F указаны в тысячах USD по конвенции SEC. 13F подаёт учреждение, а не акция.