SkillFoxx

Начните вводить название, задачу или сервис

MCP-сервер FINAM Trade API

FINAM Trade API MCP Server

MCP-сервер биржевой торговли FINAM: котировки, стакан, размещение и отмена заявок, счета и история сделок

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Может размещать и отменять реальные биржевые заявки сразу по вызову инструмента
  • Токен API дает доступ к счету, сделкам и транзакциям пользователя
Все причины и проверки
Российский стек

mishgancheg/mcp-finam-trade-apiАвтор:mishgancheg

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/finam-trade-api-mcp-server

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'API_SECRET_TOKEN=<ваш API_SECRET_TOKEN>' --env 'ACCOUNT_ID=<значение ACCOUNT_ID>' finam -- npx -y mcp-finam-trade-api

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"finam","type":"stdio","command":"npx","args":["-y","mcp-finam-trade-api"],"env":{"API_SECRET_TOKEN":"<ваш API_SECRET_TOKEN>","ACCOUNT_ID":"<значение ACCOUNT_ID>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "finam": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add finam --env 'API_SECRET_TOKEN=<ваш API_SECRET_TOKEN>' --env 'ACCOUNT_ID=<значение ACCOUNT_ID>' -- npx -y mcp-finam-trade-api

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.finam]
command = "npx"
args = ["-y", "mcp-finam-trade-api"]
env = { API_SECRET_TOKEN = "<ваш API_SECRET_TOKEN>", ACCOUNT_ID = "<значение ACCOUNT_ID>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "finam": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-finam-trade-api"
      ],
      "environment": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<ваш API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<значение ACCOUNT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

API_SECRET_TOKENсекрет, обязательная
ACCOUNT_IDобязательная
RETURN_ASнеобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 73eb5ab.

Текст для агента

Сгенерируй API_SECRET_TOKEN на tradeapi.finam.ru/docs/tokens/, возьми ACCOUNT_ID в личном кабинете (только цифры, без КЛФ-), затем добавь сервер finam в конфигурацию Claude Desktop командой npx -y mcp-finam-trade-api с этими переменными окружения.

Другие способы из описания автора
{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": ["-y", "mcp-finam-trade-api"],
      "env": {
        "API_SECRET_TOKEN": "your_token",
        "ACCOUNT_ID": "your_account_id",
        "RETURN_AS": "string"
      }
    }
  }
}

Основной способ из README для Claude Desktop.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает FINAM Trade API 19 инструментами по пяти направлениям: авторизация и права токена, информация о счете со сделками и транзакциями, список инструментов, время сервера, параметры торгов и расписание, цепочки опционов, исторические свечи, текущая котировка, последние сделки и стакан заявок, а также размещение, просмотр, список и отмену заявок. Точный поиск инструмента по тикеру, ISIN или символу вынесен в отдельный инструмент. Кроме инструментов сервер отдает MCP-ресурсы со справочниками перечислений вроде типов заявок и статусов счета и готовый промпт trading-agent, который задает контекст торгового ассистента.

Для кого. Для трейдеров с брокерским счетом в FINAM, которые хотят проверять котировки и управлять заявками через агента.

Подходит, если

  • Нужно быстро проверить котировку, стакан или исторические свечи по инструменту
  • Нужно разместить, посмотреть или отменить заявку через агента
  • Нужна сводка по сделкам и транзакциям счета за период

Не подходит, если

  • Нет брокерского счета FINAM и API-токена для торгового API
  • Не хочется давать агенту право самостоятельно размещать заявки: у PlaceOrder нет отдельного режима подтверждения или предпросмотра
  • Нужен готовый продакшн-сервис, а не проект хакатона: README прямо предупреждает, что это учебный материал

Пример запроса к агенту

Покажи текущую котировку и стакан по инструменту SBER и размести лимитную заявку на покупку

Ограничения

Проект создан на хакатоне Finam AI Trade Hack, автор прямо пишет, что ПО предоставлено как есть для образовательных целей и торговля связана с риском. PlaceOrder размещает реальную заявку сразу по вызову, отдельного подтверждения или сухого прогона в инструментах нет. Для удаленного HTTP-подключения через mcp-remote в README отмечена особенность Windows-версии Claude Desktop с пробелами в заголовках.

Как отключить. Удалите запись finam из конфигурации Claude Desktop.

MCP

Транспорт
stdio, http
Авторизация
API-ключ
Переменные окружения
API_SECRET_TOKEN
обязательная, секрет		Токен FINAM Trade API, создается на tradeapi.finam.ru/docs/tokens/.
ACCOUNT_ID
обязательная		ID торгового счета, только цифры без префикса КЛФ-.
RETURN_AS
Формат ответа инструментов, например string или json.

Проверка безопасности

  • Может размещать и отменять реальные биржевые заявки сразу по вызову инструмента
  • Токен API дает доступ к счету, сделкам и транзакциям пользователя

Коротко о README

README на английском объясняет происхождение проекта на хакатоне Finam AI Trade Hack, дает быстрый старт для пользователей через npx и для разработчиков со сборкой из исходников, три способа подключения: локальный stdio, удаленный через mcp-remote и локальный Node, таблицы из 19 инструментов, 13 перечислений, двух схем и промпта trading-agent. В конце явное предупреждение о рисках торговли и образовательном назначении.

Частые вопросы

Может ли агент разместить заявку без подтверждения?

Да, инструмент PlaceOrder сразу создает реальную заявку по вызову, отдельного шага подтверждения в самом сервере нет.

Можно ли подключиться к серверу удаленно, а не локально?

Да, README описывает подключение через mcp-remote к удаленному HTTP или SSE адресу с заголовками авторизации.

Выбор редакции

Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици

СкиллСредний рискБез VPN16,6 тыс.
Официальный

Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта

MCP-серверВысокий рискНужен VPN1,8 тыс.
Официальный

Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке

MCP-серверВысокий риск995
Выбор редакции

Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной

СкиллНизкий рискРоссийский стекБез VPN4
Foxx AIMCP-сервер FINAM Trade API

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.