Alpaca MCP Server
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- В боевом режиме выставляет реальные заявки, риск денежных потерь
- Обязательно проверять режим paper или live перед работой
- Требует секретных ключей API и доступа к портфелю
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/alpaca-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'ALPACA_API_KEY=<ваш ALPACA_API_KEY>' --env 'ALPACA_SECRET_KEY=<ваш ALPACA_SECRET_KEY>' alpaca-mcp-server -- uvx alpaca-mcp-server==2.3.2Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"alpaca-mcp-server","type":"stdio","command":"uvx","args":["alpaca-mcp-server==2.3.2"],"env":{"ALPACA_API_KEY":"<ваш ALPACA_API_KEY>","ALPACA_SECRET_KEY":"<ваш ALPACA_SECRET_KEY>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"alpaca-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add alpaca-mcp-server --env 'ALPACA_API_KEY=<ваш ALPACA_API_KEY>' --env 'ALPACA_SECRET_KEY=<ваш ALPACA_SECRET_KEY>' -- uvx alpaca-mcp-server==2.3.2Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.alpaca-mcp-server]
command = "uvx"
args = ["alpaca-mcp-server==2.3.2"]
env = { ALPACA_API_KEY = "<ваш ALPACA_API_KEY>", ALPACA_SECRET_KEY = "<ваш ALPACA_SECRET_KEY>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'ALPACA_API_KEY=<ваш ALPACA_API_KEY>' -e 'ALPACA_SECRET_KEY=<ваш ALPACA_SECRET_KEY>' alpaca-mcp-server uvx alpaca-mcp-server==2.3.2Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"alpaca-mcp-server": {
"type": "local",
"command": [
"uvx",
"alpaca-mcp-server==2.3.2"
],
"environment": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"alpaca-mcp-server": {
"command": "uvx",
"args": [
"alpaca-mcp-server==2.3.2"
],
"env": {
"ALPACA_API_KEY": "<ваш ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ваш ALPACA_SECRET_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ALPACA_API_KEYсекрет, обязательная- Alpaca Trading API key
ALPACA_SECRET_KEYсекрет, обязательная- Alpaca Trading API secret key
ALPACA_TOOLSETSнеобязательная- Comma-separated list of toolsets to enable (e.g. account,trading,stock-data). All enabled by default.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Заведи бесплатный бумажный счет Alpaca и получи ключи. Добавь сервер в Claude Code: claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server --env ALPACA_API_KEY=ключ --env ALPACA_SECRET_KEY=секрет. Бумажный режим включен по умолчанию, проверь его перед реальными сделками.
Другие способы из описания автора
{
"mcpServers": {
"alpaca": {
"command": "uvx",
"args": ["alpaca-mcp-server"],
"env": {
"ALPACA_API_KEY": "your_alpaca_api_key",
"ALPACA_SECRET_KEY": "your_alpaca_secret_key"
}
}
}
}Бумажный режим включен по умолчанию.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает ИИ-клиента к торговому API Alpaca и дает управлять счетом на естественном языке. Через инструменты доступны выставление рыночных, лимитных, стоп и трейлинг-заявок по акциям, ETF, крипте и опционам, отмена заявок, просмотр и закрытие позиций, история портфеля, списки наблюдения, справочник активов, календарь рынка, корпоративные события и новости. Отдельный блок это рыночные данные: котировки, сделки, бары и снимки, включая греки и подразумеваемую волатильность по опционам. По умолчанию включен бумажный режим, для реальных сделок его нужно явно выключить.
Для кого. Для трейдеров и разработчиков со счетом Alpaca, кто строит торговые сценарии и аналитику через агента.
Подходит, если
- Тестируете торговые идеи на бумажном счете Alpaca
- Нужны рыночные данные и снимки по акциям, крипте и опционам
- Управляете заявками и позициями через ИИ-клиент
Не подходит, если
- Не готовы к риску реальных сделок и денежных потерь при live-режиме
- Нет проверки, включен ли бумажный или боевой режим
- Планируете выставить сервер в интернет с ключами без защиты
Пример запроса к агенту
Покажи баланс и покупательную способность на бумажном счете, затем последнюю котировку AAPLОграничения
Нужны ключи API Alpaca, они настраиваются в конфигурации MCP-клиента. Флаг ALPACA_PAPER_TRADE по умолчанию true, для реальных сделок его выставляют в false, поэтому режим надо проверять перед работой. Сервер может выставлять реальные заявки и видит портфель, ключи это чувствительные данные. Пакет не настраивает удаленную аутентификацию MCP, публиковать его в интернет с ключами нельзя. Доступность счета Alpaca зависит от юрисдикции.
Как отключить. Удалите запись alpaca из конфигурации MCP-клиента и перезапустите его. Ключи API отзываются в панели Alpaca.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ALPACA_API_KEY обязательная, секрет | Ключ API счета Alpaca. |
| ALPACA_SECRET_KEY обязательная, секрет | Секретный ключ счета Alpaca. |
| ALPACA_PAPER_TRADE | По умолчанию true, бумажный режим. Значение false включает реальную торговлю. |
| ALPACA_TOOLSETS | Список наборов инструментов через запятую, чтобы ограничить доступные операции. |
Проверка безопасности
- В боевом режиме выставляет реальные заявки, риск денежных потерь
- Обязательно проверять режим paper или live перед работой
- Требует секретных ключей API и доступа к портфелю
Коротко о README
README описывает вторую версию сервера на FastMCP и OpenAPI, отличия от первой версии и способы установки для Claude Desktop, Cursor, VS Code, PyCharm, Claude Code и Docker. Конфигурация идет только через переменные окружения: ключи, флаг бумажного режима и фильтр наборов инструментов. Перечислены возможности по счету, заявкам, позициям, спискам наблюдения, активам и рыночным данным, а также большой список примеров запросов и инструментов. Отдельно даны разделы про безопасность, дисклеймер о рисках и то, что live-режим включается явно.
Частые вопросы
Может ли сервер потратить реальные деньги?
Да, если выключить бумажный режим. По умолчанию ALPACA_PAPER_TRADE равен true, для реальных сделок его ставят в false, поэтому режим важно проверять.
Это официальный сервер Alpaca?
Да. Репозиторий принадлежит alpacahq, пакет публикуется на PyPI и запускается через uvx.
Похожие
Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной
Официальный MCP ЮKassa: агент создает ссылки на оплату и счета, проверяет статусы и возвраты, но сам деньги не переводит