alpaca-mcp-server

O Alpaca MCP Server é um servidor oficial do Model Context Protocol para as APIs de Trading e Market Data da Alpaca. Ele permite que assistentes e IDEs compatíveis com MCP — incluindo Claude Desktop, Claude Code, Cursor, VS Code, PyCharm e Antigravity — descubram ferramentas da Alpaca e executem tarefas de negociação ou pesquisa por meio de solicitações em linguagem natural. A versão 2 é uma reescrita completa criada com FastMCP e OpenAPI. Ela não é retrocompatível com a v1: nomes de ferramentas, parâmetros, schemas e configuração mudaram; portanto, instalações atualizadas devem ser reconfiguradas, os clientes reiniciados e novas sessões iniciadas. A v1 pode permanecer fixada na última versão 1.x, se necessário. O servidor é executado localmente por stdio usando uvx, ou pode ser construído e executado com Docker. A configuração é fornecida por variáveis de ambiente na configuração do cliente MCP: ALPACA_API_KEY e ALPACA_SECRET_KEY são obrigatórias, ALPACA_PAPER_TRADE tem padrão true, e ALPACA_TOOLSETS pode restringir os recursos expostos. O README alerta contra expor o servidor diretamente à internet pública porque ele não fornece autenticação MCP remota por conta própria. Os recursos expostos são organizados em toolsets para informações de conta e portfólio, negociação, posições, watchlists, ativos e status de mercado, dados de ações, dados de criptomoedas, dados de opções, ações corporativas, notícias, dados de renda fixa e short-sale locates. Operações específicas incluem visualizar saldos e poder de compra, obter histórico do portfólio e atividades da conta, enviar ordens de ações/ETFs, criptomoedas e opções, substituir ou cancelar ordens, visualizar ou encerrar posições, exercer opções e gerenciar watchlists. As ferramentas de dados de mercado abrangem barras históricas e mais recentes, cotações, negociações, snapshots, livros de ordens, cadeias de opções, gregas, volatilidade implícita, calendários, relógios, anúncios de ações corporativas, notícias e cotações de renda fixa. O servidor também inclui ferramentas de consulta de documentação para guias da Alpaca e referências de endpoints OpenAPI. Alguns recursos de dados e locate dependem de assinatura da Alpaca ou de elegibilidade de conta real. O projeto documenta a configuração para vários clientes MCP, configuração de negociação real, filtragem de toolsets, prompts de exemplo e um conjunto de testes que contém verificações de integridade, testes de construção do servidor, testes de integração com a API paper e testes de integração de documentação.