SEC EDGAR MCP
MCP-сервер к базе SEC EDGAR: отчетность компаний США, финансовые формы 10-K, 10-Q, 8-K, данные из XBRL и сделки инсайдеров
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Данные используются для финансовых решений, ошибки трактовки дорого стоят, это не инвестиционная рекомендация
- Ходит во внешний сервис SEC и требует корректной идентификации запросов
- HTTP-транспорт без аутентификации нельзя открывать в общую сеть
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/sec-edgar-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'SEC_EDGAR_USER_AGENT=<значение SEC_EDGAR_USER_AGENT>' sec-edgar-mcp -- docker run -i --rm -e SEC_EDGAR_USER_AGENT stefanoamorelli/sec-edgar-mcp:latestИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"sec-edgar-mcp","type":"stdio","command":"docker","args":["run","-i","--rm","-e","SEC_EDGAR_USER_AGENT","stefanoamorelli/sec-edgar-mcp:latest"],"env":{"SEC_EDGAR_USER_AGENT":"<значение SEC_EDGAR_USER_AGENT>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"sec-edgar-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add sec-edgar-mcp --env 'SEC_EDGAR_USER_AGENT=<значение SEC_EDGAR_USER_AGENT>' -- docker run -i --rm -e SEC_EDGAR_USER_AGENT stefanoamorelli/sec-edgar-mcp:latestИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.sec-edgar-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "SEC_EDGAR_USER_AGENT", "stefanoamorelli/sec-edgar-mcp:latest"]
env = { SEC_EDGAR_USER_AGENT = "<значение SEC_EDGAR_USER_AGENT>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"sec-edgar-mcp": {
"type": "local",
"command": [
"docker",
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"environment": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT",
"stefanoamorelli/sec-edgar-mcp:latest"
],
"env": {
"SEC_EDGAR_USER_AGENT": "<значение SEC_EDGAR_USER_AGENT>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEC_EDGAR_USER_AGENTобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь сервер в конфигурацию клиента через docker с переменной SEC_EDGAR_USER_AGENT в формате имя и почта. Другие способы установки (pip, uv) описаны в документации проекта.
Другие способы из описания автора
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "SEC_EDGAR_USER_AGENT=Your Name (your@email.com)", "stefanoamorelli/sec-edgar-mcp:latest"]
}
}
}Флаг -i обязателен для обмена по MCP. Укажите свои имя и почту.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает ИИ-ассистента к базе SEC EDGAR и открывает доступ к публичной отчетности компаний США. Инструменты сгруппированы по темам: поиск компании и ее CIK, сведения и факты о компании, получение форм 10-K, 10-Q, 8-K и извлечение разделов, финансовые отчеты из XBRL с точными числами (баланс, отчет о прибылях, движение денег), а также сделки инсайдеров по формам 3, 4, 5. Каждый ответ содержит ссылки на исходные документы SEC для проверки. Данные только на чтение, торговых операций нет.
Для кого. Для финансовых аналитиков, исследователей и юристов, которым нужна отчетность компаний США с точными цифрами.
Подходит, если
- Разбираете отчетность компании США по формам 10-K, 10-Q, 8-K
- Нужны точные числа из финансовых отчетов через XBRL
- Смотрите сделки инсайдеров по формам 3, 4, 5
Не подходит, если
- Нужны данные по компаниям вне периметра SEC
- Ожидаете инвестиционную рекомендацию, а не факты из отчетности
- Открываете HTTP-транспорт без аутентификации в общую сеть
Пример запроса к агенту
Найди последний 10-K компании Apple и покажи выручку с ссылкой на документОграничения
Нужно задать переменную SEC_EDGAR_USER_AGENT в формате имя и почта, этого требует API SEC. Проект не связан с SEC и не одобрен ею. HTTP-транспорт идет без аутентификации, авторы советуют использовать его только в частной сети. Данные носят информационный характер и не являются инвестиционной рекомендацией. Лицензия AGPL-3.0, для коммерческого использования нужна отдельная договоренность с автором.
Как отключить. Удалите запись sec-edgar-mcp из конфигурации MCP-клиента. При установке через docker удалите образ штатной командой, при установке через pip или uv удалите пакет.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| SEC_EDGAR_USER_AGENT обязательная | Имя и почта в формате Имя Фамилия (email), этого требует API SEC для идентификации запросов. |
Проверка безопасности
- Данные используются для финансовых решений, ошибки трактовки дорого стоят, это не инвестиционная рекомендация
- Ходит во внешний сервис SEC и требует корректной идентификации запросов
- HTTP-транспорт без аутентификации нельзя открывать в общую сеть
Коротко о README
README описывает MCP-сервер для доступа к отчетности SEC EDGAR с точными числами и ссылками на первоисточники. Дан быстрый старт через docker с обязательной переменной user agent, а также вариант HTTP-транспорта для платформ вроде Dify. Инструменты сгруппированы по компаниям, формам, финансам и сделкам инсайдеров. Проект построен на sec-edgar-toolkit, есть набор оценочных тестов, документация и указание на лицензию AGPL-3.0. Отмечено, что проект не связан с SEC.
Частые вопросы
Можно ли им торговать?
Нет. Сервер только читает публичную отчетность SEC. Торговых операций и доступа к счетам в нем нет.
Зачем переменная user agent?
Так требует API SEC: в запросах нужно указывать имя и почту, чтобы вас можно было идентифицировать.
Похожие
Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной