alpaca-mcp-server

Um servidor abrangente de Model Context Protocol (MCP) para a API de Trading da Alpaca. Habilite operações de trading em linguagem natural por meio de assistentes de IA como Claude, Cursor e VS Code. Suporta ações, opções, criptomoedas, gerenciamento de portfólio e dados de mercado em tempo real.

Alpaca MCP Server v2 está aqui. Esta versão é uma reescrita completa construída com FastMCP e OpenAPI. Se você está atualizando da v1, leia o Guia de Atualização — os nomes das ferramentas, parâmetros e configuração mudaram.

Sumário

• Atualizando da V1
• Pré-requisitos
• Obtendo Suas Chaves de API
• Configuração
• Configurações
• Recursos
• Exemplos de Prompts
• Ferramentas Disponíveis
• Testes
• Estrutura do Projeto
• Solução de Problemas
• Divulgação

---

Atualizando da V1

A V2 é uma reescrita completa construída com FastMCP e OpenAPI. Nenhuma das ferramentas da V1 existe na V2 — os nomes das ferramentas, parâmetros e esquemas mudaram. Você não pode usar a V2 como substituto direto se sua configuração depende de nomes ou parâmetros específicos da V1.

O que mudou

Aspecto	V1	V2
Nomes das ferramentas	Feitos à mão (ex.: get_account_info)	Derivados de especificações com substituições (ex.: get_account_info — os nomes podem se sobrepor, mas os esquemas diferem)
Parâmetros	Esquemas personalizados	Alinhados com as especificações da API da Alpaca
Configuração	Comando .env + init	Apenas variáveis de ambiente na configuração do cliente MCP
Filtragem de ferramentas	Não suportado	Variável de ambiente ALPACA_TOOLSETS
Lista de permissões	Não suportado	Use ALPACA_TOOLSETS para restringir ferramentas

Como evitar o uso no estilo V1 na V2

Os clientes MCP descobrem ferramentas dinamicamente a partir do servidor. Não há arquivo de configuração onde você "lista" nomes de ferramentas — o cliente obtém quaisquer ferramentas que o servidor expõe. Para evitar que seu cliente ou assistente de IA use a V2 incorretamente:

1. Não reutilize a configuração da V1 — Trate a V2 como um novo servidor. Atualize a configuração do seu cliente MCP com o novo comando/argumentos; remova qualquer configuração baseada em .env ou init.
2. Limpe os caches de ferramentas — Reinicie seu cliente MCP (Claude Desktop, Cursor, VS Code, etc.) após a troca para que ele busque a nova lista de ferramentas em vez de usar uma desatualizada.
3. Inicie uma nova conversa/sessão — Conversas existentes podem ter referências em cache a nomes antigos de ferramentas. Inicie uma nova conversa para que o LLM veja as ferramentas atuais da V2 e seus esquemas.
4. Atualize instruções personalizadas e regras — Se você tem regras do Cursor, instruções do Claude ou outros prompts que mencionam nomes específicos de ferramentas da V1 (ex.: "use get_account_info"), atualize-os para corresponder aos nomes da V2 ou remova essas referências e deixe o LLM descobrir as ferramentas pelo contexto.
5. Restrinja ferramentas com ALPACA_TOOLSETS — Se você anteriormente limitava quais capacidades seu assistente podia usar, a V2 suporta filtragem no lado do servidor por meio da variável de ambiente ALPACA_TOOLSETS. Veja Configurações > Filtragem de Conjunto de Ferramentas para a lista de conjuntos de ferramentas.

Resumo

Assuma nenhuma compatibilidade retroativa com a V1. Reconfigure seu cliente MCP para a V2, reinicie-o e use uma nova sessão. Verifique a seção Ferramentas Disponíveis para a lista atual de ferramentas.

Se você tinha fluxos de trabalho personalizados na V1

Se você documentou ferramentas permitidas, escreveu scripts que chamam ferramentas pelo nome ou criou prompts em torno de formatos específicos de ferramentas/parâmetros da V1 — trate-os como obsoletos. Recrie-os usando as Ferramentas Disponíveis listadas abaixo e os esquemas de parâmetros atuais expostos pelo servidor.

Permanecendo na V1

Se você precisa permanecer na V1, fixe a versão na última release da V1 (ex.: uvx alpaca-mcp-server==1.x.x serve) na configuração do seu cliente MCP. A V1 permanece disponível no PyPI para configurações existentes.

---

Pré-requisitos

• Python 3.10+ (guia de instalação)
• uv (guia de instalação)
• Chaves da API de Trading da Alpaca (conta gratuita de paper trading)
• Cliente MCP (Claude Desktop, Cursor, VS Code, etc.)

Obtendo Suas Chaves de API

1. Visite o Painel da Alpaca
2. Crie uma conta gratuita de paper trading
3. Gere as chaves de API no painel

Configuração

Adicione o servidor à configuração do seu cliente MCP e reinicie o cliente. Sem comando init, sem arquivos .env — as credenciais são definidas em apenas um lugar.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Claude Mobile

O Claude Mobile requer um servidor MCP remoto. Este pacote não configura autenticação MCP remota, portanto, não o exponha diretamente à internet pública com suas chaves de API da Alpaca. Use a configuração local stdio de um cliente desktop suportado.

ChatGPT

O ChatGPT requer um servidor MCP remoto. Este pacote não configura autenticação MCP remota, portanto, não o exponha diretamente à internet pública com suas chaves de API da Alpaca. Use a configuração local stdio de um cliente desktop suportado.

Cursor

Instale a partir do Diretório Cursor em poucos cliques, ou adicione ao ~/.cursor/mcp.json:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

VS Code

Crie .vscode/mcp.json na raiz do seu projeto. Veja a documentação oficial.

{
  "servers": {
    "alpaca": {
      "type": "stdio",
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

PyCharm

Veja o guia oficial.

1. Vá para File → Settings → Tools → Model Context Protocol (MCP)
2. Adicione um novo servidor:

• Tipo: stdio
• Comando: uvx
• Argumentos: alpaca-mcp-server

3. Defina as variáveis de ambiente:

 ALPACA_API_KEY=your_alpaca_api_key
 ALPACA_SECRET_KEY=your_alpaca_secret_key

Claude Code

claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
  --env ALPACA_API_KEY=your_alpaca_api_key \
  --env ALPACA_SECRET_KEY=your_alpaca_secret_key

Verifique com /mcp no CLI do Claude Code.

CLI do Antigravity

Veja a documentação MCP do Antigravity.

Adicione ao ~/.gemini/antigravity-cli/mcp_config.json (global) ou .agents/mcp_config.json (workspace):

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Docker

git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
docker build -t mcp/alpaca:latest .

Adicione à configuração do seu cliente MCP:

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ALPACA_API_KEY=your_key",
        "-e", "ALPACA_SECRET_KEY=your_secret",
        "-e", "ALPACA_PAPER_TRADE=true",
        "mcp/alpaca:latest"
      ]
    }
  }
}

Configurações

Toda a configuração é feita por meio de variáveis de ambiente definidas na configuração do seu cliente MCP. Nenhum arquivo é gravado em disco.

Variável	Obrigatória	Padrão	Descrição
ALPACA_API_KEY	Sim	—	Sua chave de API da Alpaca
ALPACA_SECRET_KEY	Sim	—	Sua chave secreta da Alpaca
ALPACA_PAPER_TRADE	Não	true	Defina como false para trading ao vivo
ALPACA_TOOLSETS	Não	all	Lista separada por vírgulas de conjuntos de ferramentas a habilitar

Alternando para Trading ao Vivo

Atualize o bloco env na configuração do seu cliente MCP e reinicie:

{
  "env": {
    "ALPACA_API_KEY": "your_live_api_key",
    "ALPACA_SECRET_KEY": "your_live_secret_key",
    "ALPACA_PAPER_TRADE": "false"
  }
}

Filtragem de Conjunto de Ferramentas

Por padrão, todas as ferramentas estão habilitadas. Para limitar o servidor a conjuntos de ferramentas específicos, defina ALPACA_TOOLSETS:

{
  "env": {
    "ALPACA_API_KEY": "...",
    "ALPACA_SECRET_KEY": "...",
    "ALPACA_TOOLSETS": "stock-data,crypto-data"
  }
}

Conjuntos de ferramentas disponíveis:

Conjunto de Ferramentas	Descrição
account	Informações da conta, configuração, histórico de portfólio, atividades
trading	Ordens, posições, exercício de opções
watchlists	Operações CRUD de listas de observação
assets	Consulta de ativos, contratos de opções, calendário, relógio
stock-data	Barras de ações, cotações, negociações, snapshots, filtros
crypto-data	Barras de cripto, cotações, negociações, snapshots, livros de ofertas
options-data	Barras de opções, cotações, negociações, snapshots, cadeia, códigos de bolsa
corporate-actions	Anúncios de ações corporativas
news	Artigos de notícias para ações e cripto
fixed-income-data	Renda fixa (cotações de títulos/tesouros)
locates	Solicitações e cotações de locate para vendas a descoberto

Docs MCP do ReadMe

Os documentos são limitados às especificações da API de Trading, API de Dados de Mercado e API de Autenticação; os documentos de endpoints da API de Corretora são intencionalmente excluídos deste servidor.

Se a consulta MCP do ReadMe falhar, as respostas das ferramentas incluem links de fallback para os documentos públicos da Alpaca, além de llms.txt e llms-full.txt.

Recursos

• Dados de Mercado — Cotações em tempo real, negociações e barras de preços para ações, cripto e opções. Dados históricos com períodos flexíveis. Gregas de opções e volatilidade implícita.
• Gerenciamento de Conta — Veja saldos, poder de compra, status da conta e histórico de portfólio.
• Gerenciamento de Ordens — Coloque ordens a mercado, limitadas, stop, stop-limit e trailing-stop para ações, cripto e opções. Cancele ordens individualmente ou em lote.
• Negociação de Opções — Pesquise contratos por vencimento/strike/tipo. Coloque estratégias de uma ou múltiplas pernas. Obtenha cotações, Gregas e IV mais recentes.
• Negociação de Cripto — Ordens a mercado, limitadas e stop-limit com GTC/IOC. Baseadas em quantidade ou nocional.
• Gerenciamento de Posições — Veja, feche ou liquide posições. Exerça contratos de opções.
• Notícias — Artigos de notícias filtráveis por ticker e intervalo de datas.
• Status do Mercado — Horários de abertura/fechamento do mercado, calendário, ações corporativas.
• Listas de Observação — Crie, atualize e gerencie listas de observação.
• Pesquisa de Ativos — Consulte detalhes de ações, ETFs, cripto e opções com filtragem.

Exemplos de Prompts

Trading Básico

1. Qual é meu saldo atual e poder de compra na Alpaca?
2. Mostre minhas posições atuais na minha conta da Alpaca.
3. Compre 5 ações da AAPL a preço de mercado.
4. Venda 5 ações da TSLA com preço limite de $300.
5. Cancele todas as ordens de ações em aberto.
6. Cancele a ordem com ID abc123.
7. Liquide toda a minha posição em GOOGL.
8. Feche 10% da minha posição em NVDA.
9. Coloque uma ordem limitada para comprar 100 ações da MSFT a $450.
10. Coloque uma ordem a mercado para vender 25 ações da META.

Negociação de Cripto

1. Coloque uma ordem a mercado para comprar 0.01 ETH/USD.
2. Coloque uma ordem limitada para vender 0.01 BTC/USD a $110.000.

Negociação de Opções

1. Mostre os contratos de opções disponíveis para AAPL com vencimento no próximo mês.
2. Obtenha a cotação mais recente para a opção AAPL250613C00200000.
3. Recupere o snapshot da opção para a opção SPY250627P00400000.
4. Liquide minha posição em 2 contratos de calls da QQQ com vencimento na próxima semana.
5. Coloque uma ordem a mercado para comprar 1 call da AAPL com vencimento na próxima sexta-feira.
6. Quais são as Gregas da opção para a opção TSLA250620P00500000?
7. Encontre contratos de opções da TSLA com preços de strike dentro de 5% do preço de mercado atual.
8. Obtenha calls da SPY com vencimento na semana de 16 de junho de 2025, dentro de 10% do preço de mercado.
9. Coloque um bull call spread usando opções da AAPL de 6 de junho: uma com strike de 190.00 e a outra com strike de 200.00.
10. Exerça meu contrato de call da NVDA NVDA250919C001680.

Informações de Mercado

Para acessar os dados mais recentes de 15 minutos, você precisa assinar o Plano Algo Trader Plus.

1. Quais são os horários de abertura e fechamento do mercado hoje?
2. Mostre-me o calendário do mercado para a próxima semana.
3. Mostre-me dividendos em dinheiro e desdobramentos de ações recentes para AAPL, MSFT e GOOGL nos últimos 3 meses.
4. Obtenha todas as ações corporativas para SPY, incluindo dividendos, desdobramentos e quaisquer fusões no último ano.
5. Quais são as ações corporativas futuras programadas para SPY nos próximos 6 meses?

Dados Históricos e em Tempo Real

1. Mostre-me o histórico de preços diários da AAPL nos últimos 5 dias de negociação.
2. Qual foi o preço de fechamento da TSLA ontem?
3. Obtenha a barra mais recente para GOOGL.
4. Qual foi o preço da última negociação para NVDA?
5. Mostre-me a cotação mais recente para MSFT.
6. Recupere as últimas 100 negociações para AMD.
7. Mostre-me barras de 1 minuto para AMZN das últimas 2 horas.
8. Obtenha barras intradiárias de 5 minutos para TSLA da terça-feira passada até a sexta-feira passada.
9. Obtenha um snapshot abrangente da ação AAPL mostrando a cotação mais recente, negociação, barra de minuto, barra diária e barra diária anterior em uma única visualização.
10. Compare snapshots de mercado para TSLA, NVDA e MSFT para analisar seus spreads atuais de compra/venda, preços das últimas negociações e desempenho diário.

Ordens

1. Mostre-me todas as minhas ordens abertas e preenchidas desta semana.
2. Quais ordens eu tenho para AAPL?
3. Liste todas as ordens limitadas que coloquei nos últimos 3 dias.
4. Filtre todas as ordens por status: preenchidas.
5. Obtenha o histórico de ordens de ontem.

Listas de Acompanhamento

Neste momento, você só pode visualizar e atualizar listas de acompanhamento de negociação criadas via API de Negociação da Alpaca através da própria API.

1. Crie uma nova lista de acompanhamento chamada "Ações de Tecnologia" com AAPL, MSFT e NVDA.
2. Atualize minha lista de acompanhamento "Ações de Tecnologia" para incluir TSLA e AMZN.
3. Quais ações estão na minha lista de acompanhamento "Escolhas de Dividendos"?
4. Remova META da minha lista de acompanhamento "Portfólio de Crescimento".
5. Liste todas as minhas listas de acompanhamento existentes.

Informações de Ativos

1. Pesquise detalhes sobre o ativo 'AAPL'.
2. Mostre-me os 5 principais ativos de criptomoedas negociáveis por volume de negociação.
3. Obtenha todos os ativos de ações dos EUA ativos da NASDAQ e filtre os resultados para mostrar apenas títulos negociáveis.

Cenários Combinados

1. Obtenha o relógio do mercado de hoje e mostre-me meu poder de compra antes de colocar uma ordem limitada de compra para TSLA a $340.
2. Coloque um spread de alta com opções da SPY de 3 de julho: venda uma 5% acima e compre uma 3% abaixo do preço atual da SPY.

Ferramentas Disponíveis

Conta e Portfólio

• get_account_info — Saldo, margem e status da conta
• get_account_config — Restrições de negociação, configurações de margem, verificações de PDT
• update_account_config — Atualizar configurações da conta
• get_portfolio_history — Patrimônio e P/L ao longo do tempo
• get_account_activities — Execuções, dividendos, transferências
• get_account_activities_by_type — Atividades filtradas por tipo

Negociação (Ordens)

• get_orders — Recuperar ordens com filtros
• get_order_by_id — Ordem individual por ID
• get_order_by_client_id — Ordem individual por ID de ordem do cliente
• replace_order_by_id — Substituir uma ordem aberta existente
• cancel_order_by_id — Cancelar uma ordem específica
• cancel_all_orders — Cancelar todas as ordens abertas
• place_stock_order — Ações/ETFs (mercado, limite, stop, stop-limit, trailing-stop, brackets)
• place_crypto_order — Criptomoedas (mercado, limite, stop-limit)
• place_option_order — Opções (perna única ou múltiplas pernas)

Posições

• get_all_positions — Todas as posições atuais
• get_open_position — Detalhes de uma posição específica
• close_position — Fechar uma posição específica
• close_all_positions — Liquidar todo o portfólio
• exercise_options_position — Exercer um contrato de opção mantido
• do_not_exercise_options_position — Instrução de não exercício

Listas de Acompanhamento

• create_watchlist — Criar uma nova lista de acompanhamento
• get_watchlists — Listar todas as listas de acompanhamento
• get_watchlist_by_id — Obter uma lista de acompanhamento específica
• update_watchlist_by_id — Atualizar uma lista de acompanhamento
• delete_watchlist_by_id — Excluir uma lista de acompanhamento
• add_asset_to_watchlist_by_id — Adicionar um ativo a uma lista de acompanhamento
• remove_asset_from_watchlist_by_id — Remover um ativo de uma lista de acompanhamento

Ativos e Informações de Mercado

• get_all_assets — Listar ativos com filtragem opcional
• get_asset — Informações detalhadas de um ativo específico
• get_option_contracts — Contratos de opções para símbolo(s) subjacente(s)
• get_option_contract — Contrato de opção individual por símbolo ou ID
• get_calendar — Calendário do mercado para um intervalo de datas
• get_clock — Status atual do mercado e próxima abertura/fechamento
• get_corporate_action_announcements — Anúncios de ações corporativas
• get_corporate_action_announcement — Anúncio individual por ID

Dados de Ações

• get_stock_bars — Barras OHLCV históricas
• get_stock_quotes — Cotações de compra/venda históricas
• get_stock_trades — Negociações históricas
• get_stock_latest_bar — Barra de minuto mais recente
• get_stock_latest_quote — Cotação mais recente
• get_stock_latest_trade — Negociação mais recente
• get_stock_snapshot — Snapshot abrangente
• get_most_active_stocks — Mais ativas por volume/contagem de negociações
• get_market_movers — Maiores altas e baixas

Dados de Criptomoedas

• get_crypto_bars — Barras OHLCV históricas
• get_crypto_quotes — Cotações históricas
• get_crypto_trades — Negociações históricas
• get_crypto_latest_bar — Barra de minuto mais recente
• get_crypto_latest_quote — Cotação mais recente
• get_crypto_latest_trade — Negociação mais recente
• get_crypto_snapshot — Snapshot abrangente
• get_crypto_latest_orderbook — Livro de ofertas mais recente

Dados de Opções

• get_option_bars — Barras OHLCV históricas
• get_option_trades — Negociações históricas
• get_option_latest_trade — Negociação mais recente
• get_option_latest_quote — Cotação mais recente com informações de compra/venda e bolsa
• get_option_snapshot — Snapshot com Gregas e IV
• get_option_chain — Cadeia completa de opções para um subjacente
• get_option_exchange_codes — Mapeamento de código de bolsa para nome

Ações Corporativas

• get_corporate_actions — Anúncios de ações corporativas de dados de mercado

Notícias

• get_news — Artigos de notícias para ações e criptomoedas

Dados de Renda Fixa

• get_fixed_income_latest_quotes — Cotações mais recentes para títulos de renda fixa por ISIN

Locates (Venda a Descoberto) — não disponível em negociação simulada (paper trading)

• get_locates — Listar solicitações de locate filtradas por status, símbolo ou intervalo de datas
• create_locate — Criar uma solicitação de locate para uma venda a descoberto
• get_locate — Obter uma solicitação de locate individual por ID
• get_locate_quotes — Obter disponibilidade e preços de locate para símbolos

Documentação

• search_alpaca_docs — Pesquisar páginas e guias da documentação da Alpaca
• fetch_alpaca_doc — Buscar uma página de documentação ReadMe da Alpaca por ID de página
• search_alpaca_api_specs — Pesquisar endpoints de referência da API da Alpaca por tópico, caminho, parâmetro ou termo de esquema
• list_alpaca_api_endpoints — Listar endpoints para uma especificação OpenAPI permitida da Alpaca
• get_alpaca_endpoint_docs — Buscar documentos de referência para um endpoint exato da API da Alpaca por método e caminho

Testes

O projeto inclui uma suíte de testes em múltiplas camadas que roda no CI em cada pull request:

• Testes de integridade — Validam a consistência entre especificações OpenAPI, definições de conjuntos de ferramentas e substituições de nomes/descrições de ferramentas. Não requerem rede ou credenciais.
• Testes de construção do servidor — Constroem o servidor com credenciais simuladas e verificam o número correto de ferramentas expostas. Não requerem rede.
• Testes de integração com a API de negociação simulada (Paper) — Executam chamadas reais contra a API de negociação simulada da Alpaca, cobrindo informações da conta, dados de mercado, ciclo de vida de ordens, listas de acompanhamento, posições e mais. Requer ALPACA_API_KEY e ALPACA_SECRET_KEY.
• Testes de integração ReadMe — Executam chamadas ao vivo de consulta de documentação contra o ReadMe MCP da Alpaca. Requer ALPACA_RUN_README_INTEGRATION=true quando executado localmente.

Execute a suíte completa localmente:

# Core tests (no credentials needed)
pytest tests/test_integrity.py tests/test_server_construction.py -v

# Integration tests (requires paper API keys)
ALPACA_API_KEY=... ALPACA_SECRET_KEY=... pytest tests/ -m integration -v

# ReadMe docs integration tests (requires network, no Alpaca credentials)
ALPACA_RUN_README_INTEGRATION=true pytest tests/test_readme_integration.py -v

Estrutura do Projeto

alpaca-mcp-server/
├── src/
│   └── alpaca_mcp_server/
│       ├── __init__.py
│       ├── cli.py            ← CLI entry point
│       ├── server.py         ← FastMCP server built from OpenAPI specs
│       ├── tool_registry.py  ← Tool names, descriptions, and output risk classifications
│       ├── toolsets.py       ← Toolset → operationId allowlists
│       ├── overrides.py      ← Hand-crafted tools for complex trading endpoints
│       ├── market_data_overrides.py ← Hand-crafted tools for historical data
│       ├── readme_docs.py    ← Read-only proxy tools for Alpaca ReadMe docs
│       └── specs/
│           ├── trading-api.json
│           └── market-data-api.json
├── tests/
│   ├── conftest.py           ← Shared fixtures and paper-account cleanup
│   ├── test_integrity.py     ← Spec ↔ toolset ↔ names consistency checks
│   ├── test_server_construction.py ← Server build verification
│   ├── test_readme_integration.py ← Live ReadMe docs MCP integration tests
│   └── test_paper_integration.py   ← Paper API integration tests
├── scripts/
│   └── sync-specs.sh        ← Download latest OpenAPI specs
├── .github/
│   └── workflows/
│       ├── ci.yml            ← CI pipeline (core + integration)
│       └── publish-pypi.yml  ← PyPI publish on GitHub Release
├── AGENTS.md                 ← Instructions for coding agents
├── pyproject.toml
└── README.md

Solução de Problemas

• uv/uvx não encontrado: Instale o uv a partir do guia oficial (https://docs.astral.sh/uv/getting-started/installation/) e reinicie seu terminal para que uv/uvx estejam no PATH.
• Credenciais ausentes: Defina ALPACA_API_KEY e ALPACA_SECRET_KEY no bloco env do cliente. O modo de negociação simulada (paper) padrão é ALPACA_PAPER_TRADE = True.
• O cliente não detectou a nova configuração: Reinicie o cliente (Cursor, Claude Desktop, VS Code) após as alterações.
• Conflitos de porta HTTP: Se estiver usando --transport streamable-http, altere --port para uma porta livre.

Divulgação

Os insights gerados pelo nosso servidor MCP e agentes de IA conectados são apenas para fins educacionais e informativos e não devem ser considerados como aconselhamento de investimento. A Alpaca não recomenda quaisquer títulos ou estratégias de investimento específicos. Faça sua própria diligência antes de tomar qualquer decisão. Todas as empresas mencionadas operam de forma independente e não são responsáveis umas pelas outras.

A negociação de opções não é adequada para todos os investidores devido ao seu alto risco inerente, que pode potencialmente resultar em perdas significativas. Leia as Características e Riscos das Opções Padronizadas (Documento de Divulgação de Opções) antes de investir em opções.

A Alpaca não prepara, edita, endossa ou aprova Conteúdo de Terceiros. A Alpaca não garante a precisão, pontualidade, integridade ou utilidade do Conteúdo de Terceiros e não é responsável por qualquer conteúdo, publicidade, produtos ou outros materiais em ou disponíveis em sites de terceiros.

Todos os investimentos envolvem risco, e o desempenho passado de um título ou produto financeiro não garante resultados ou retornos futuros. Não há garantia de que qualquer estratégia de investimento atingirá seus objetivos. Observe que a diversificação não garante lucro nem protege contra perdas. Sempre há o potencial de perda de dinheiro ao investir em títulos ou outros produtos financeiros. Os investidores devem considerar cuidadosamente seus objetivos de investimento e riscos antes de investir.

Os cálculos do algoritmo são baseados em dados de mercado históricos e em tempo real, mas podem não considerar todos os fatores de mercado, incluindo movimentos repentinos de preços, restrições de liquidez ou atrasos de execução. Premissas do modelo, como estimativas de volatilidade e tratamentos de dividendos, podem impactar o desempenho e a precisão. As negociações geradas pelo algoritmo estão sujeitas a processos de execução da corretora, liquidez do mercado, prioridade de ordens e atrasos de tempo. Esses fatores podem causar desvios dos preços ou horários de execução esperados. Os usuários são responsáveis por monitorar a atividade algorítmica e entender os riscos envolvidos. A Alpaca não é responsável por quaisquer perdas incorridas pelo uso deste sistema.

Resultados passados de backtests hipotéticos não garantem retornos futuros, e os resultados reais podem variar da análise.

A API de negociação simulada (Paper Trading) é oferecida pela AlpacaDB, Inc. e não requer dinheiro real nem permite que um usuário negocie títulos reais no mercado. O fornecimento do uso da API de negociação simulada não é uma oferta ou solicitação para comprar ou vender títulos, derivativos de títulos ou produtos futuros de qualquer tipo, nem qualquer tipo de aconselhamento, recomendação ou estratégia de negociação ou investimento, dado ou de qualquer forma endossado pela AlpacaDB, Inc. ou qualquer afiliada da AlpacaDB, Inc., e as informações disponibilizadas por meio da API de negociação simulada não são uma oferta ou solicitação de qualquer tipo em qualquer jurisdição onde a AlpacaDB, Inc. ou qualquer afiliada da AlpacaDB, Inc. (coletivamente, "Alpaca") não esteja autorizada a operar.

Os serviços de corretagem de títulos são fornecidos pela Alpaca Securities LLC ("Alpaca Securities"), membro FINRA/SIPC, uma subsidiária integral da AlpacaDB, Inc. Tecnologia e serviços são oferecidos pela AlpacaDB, Inc. Os serviços de criptomoedas são fornecidos pela Alpaca Crypto LLC ("Alpaca Crypto"), uma empresa de serviços monetários registrada na FinCEN (NMLS # 2160858) e subsidiária integral da AlpacaDB, Inc. A Alpaca Crypto não é membro da SIPC ou FINRA. Criptomoedas não são ações e seus investimentos em criptomoedas não são protegidos pelo FDIC ou SIPC. Ativos de criptomoedas são altamente voláteis e especulativos, envolvendo risco substancial de perda, e não são segurados pelo FDIC ou qualquer agência governamental. Os clientes devem estar cientes dos diversos riscos antes de utilizar esses serviços, incluindo possível perda de capital, considerações de segurança cibernética, desenvolvimentos regulatórios e a natureza evolutiva da tecnologia de ativos digitais. Para informações adicionais sobre os riscos das criptomoedas, clique aqui.

Esta não é uma oferta, solicitação de oferta ou aconselhamento para comprar ou vender valores mobiliários ou criptomoedas, ou abrir uma conta de corretagem ou conta de criptomoedas em qualquer jurisdição onde a Alpaca Securities ou a Alpaca Crypto, respectivamente, não estejam registradas ou licenciadas, conforme aplicável.

Política de Privacidade

Para informações sobre como a Alpaca lida com seus dados, revise:

• Política de Privacidade
• Biblioteca de Divulgações

Coleta de Dados

• O que é coletado: String do user agent (APCA-MCP-TRADING/<version>) para chamadas de API
• Como é usado: Para identificar o uso do servidor MCP e melhorar a experiência do usuário
• Compartilhamento com terceiros: Não é compartilhado com terceiros
• Retenção: Retido conforme a política padrão de retenção de dados da Alpaca
• Opt-out: Defina a variável de ambiente ALPACA_MCP_USER_AGENT como uma string vazia; nenhum cabeçalho User-Agent será enviado

Aviso de Segurança

Este servidor pode realizar negociações reais e acessar seu portfólio. Trate suas chaves de API como credenciais sensíveis. Revise cuidadosamente todas as ações propostas pelo LLM, especialmente para estratégias complexas de opções ou negociações de múltiplas pernas.

Segurança de Transporte HTTP: O HTTP transmissível (Streamable HTTP) usa como padrão localhost (127.0.0.1:8000) e valida os cabeçalhos Host e Origin. O Docker usa como padrão stdio. O Helm usa como padrão ClusterIP HTTP com ingress desativado. Vincular a 0.0.0.0 não fornece autenticação. Este pacote não configura OAuth do MCP, portanto, não o exponha diretamente à internet pública. Operadores que fornecem autenticação MCP baseada em padrões também devem definir o FASTMCP_HTTP_ALLOWED_HOSTS do FastMCP para os hostnames públicos exatos.

Suporte

Para problemas ou perguntas, entre em contato conosco em support@alpaca.markets.

Issues no GitHub: https://github.com/alpacahq/alpaca-mcp-server/issues Pull requests no GitHub: https://github.com/alpacahq/alpaca-mcp-server/pulls

Metadados do Registro MCP

mcp-name: io.github.alpacahq/alpaca-mcp-server