MCP-сервер для Финама
Finam MCP Server
MCP-сервер для Finam TradeAPI: 18 инструментов для счета, заявок, рыночных данных и справочников биржи
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты могут выставлять и отменять биржевые заявки
- Токен дает доступ к реальному брокерскому счету
Установка
Ручная установка
{
"mcpServers": {
"finam": {
"command": "uvx",
"args": ["git+ssh://git@github.com/mdmeldon/finam-mcp.git"],
"env": {
"FINAM_API_TOKEN": "ваш_api_токен_finam",
"FINAM_ACCOUNT_ID": "ваш_account_id"
}
}
}
}Фрагмент из README для ~/.cursor/mcp.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает Finam TradeAPI в инструменты MCP по слоям чистой архитектуры: получение сведений о счете, истории сделок и транзакций, справочники инструментов, бирж и расписания торгов, выставление и отмену заявок, исторические бары, котировки, стакан и последние сделки. Авторизация идет через API-токен Финама, который сервер обменивает на короткоживущий JWT и обновляет автоматически. Запускается как обычный stdio MCP-сервер через uv или напрямую как пакет.
Для кого. Для трейдеров с брокерским счетом в Финаме, которые хотят получать рыночные данные и управлять заявками через агента.
Подходит, если
- Нужно посмотреть баланс, сделки и транзакции счета в Финаме из чата с агентом
- Нужны исторические бары, стакан и котировки по бумагам Финама
- Нужно выставить или отменить заявку без переключения в терминал
Не подходит, если
- Нет API-токена и ID счета Финама
- Не готовы давать агенту доступ к выставлению биржевых заявок
Пример запроса к агенту
Покажи последние сделки по моему счету в Финаме за неделю и текущую котировку SBERОграничения
Нужны Python 3.12 и менеджер uv, а также токен FINAM_API_TOKEN и FINAM_ACCOUNT_ID из личного кабинета Финама. README указывает ставить пакет из репозитория mdmeldon/finam-mcp той же кодовой базы, у самого проекта нет отдельного релиза в PyPI. Стабильность интерфейсов не гарантирована.
Как отключить. Удалите блок finam из конфигурации MCP клиента и отзовите API-токен в личном кабинете Финама.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| FINAM_API_TOKEN обязательная, секрет | API-токен Финама из личного кабинета |
| FINAM_ACCOUNT_ID обязательная | ID торгового счета |
Проверка безопасности
- Инструменты могут выставлять и отменять биржевые заявки
- Токен дает доступ к реальному брокерскому счету
Коротко о README
README на русском дает две формы установки: через MCP-конфигурацию с командой uvx и запуском из исходников через uv sync. Перечисляет все 18 инструментов по группам: аккаунт и портфель, справочные данные, заявки, рыночные данные. Показывает примеры вызова инструментов и поясняет, что токен используется только для получения короткоживущего JWT.
Частые вопросы
Нужен ли отдельный ключ для каждого инструмента?
Нет, токен и ID счета задаются один раз при настройке MCP-сервера и используются во всех 18 инструментах.
Как долго живет токен доступа?
API-токен обменивается на JWT примерно на 15 минут, клиент обновляет его автоматически.
Похожие
Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной