Skip to main content
Glama
wizkax

Alpaca MCP Server

by wizkax

Alpaca MCP Server v2 ya está aquí. Esta versión es una reescritura completa construida con FastMCP y OpenAPI. Si vas a actualizar desde v1, lee la Guía de actualización: los nombres de las herramientas, los parámetros y la configuración han cambiado.

Tabla de contenidos


Related MCP server: Alpaca MCP Server

Actualización desde V1

V2 es una reescritura completa construida con FastMCP y OpenAPI. Ninguna de las herramientas de V1 existe en V2 — los nombres de las herramientas, los parámetros y los esquemas han cambiado. No puedes usar V2 como reemplazo directo si tu configuración depende de nombres o parámetros específicos de V1.

Qué cambia

Aspecto

V1

V2

Nombres de herramientas

Diseñadas manualmente (p. ej. get_account_info)

Derivados de la especificación con anulaciones (p. ej. get_account_info — los nombres pueden coincidir pero los esquemas difieren)

Parámetros

Esquemas personalizados

Alineados con las especificaciones de la API de Alpaca

Configuración

.env + comando init

Variables de entorno solo en la configuración del cliente MCP

Filtrado de herramientas

No compatible

Variable de entorno ALPACA_TOOLSETS

Lista blanca

No compatible

Usa ALPACA_TOOLSETS para restringir herramientas

Cómo evitar el uso al estilo V1 en V2

Los clientes MCP descubren las herramientas dinámicamente desde el servidor. No hay un archivo de configuración donde se haga una "lista blanca" de nombres de herramientas: el cliente recibe las herramientas que el servidor expone. Para evitar que tu cliente o asistente de IA utilice V2 incorrectamente:

  1. No reutilices la configuración de V1 — Trata V2 como un servidor nuevo. Actualiza la configuración de tu cliente MCP con el nuevo comando/argumentos; elimina cualquier configuración basada en .env o init.

  2. Limpia las cachés de herramientas — Reinicia tu cliente MCP (Claude Desktop, Cursor, VS Code, etc.) después de cambiar para que cargue la nueva lista de herramientas en lugar de usar una desactualizada.

  3. Inicia un chat/sesión nuevo — Las conversaciones existentes pueden tener referencias en caché a nombres antiguos de herramientas. Inicia un chat nuevo para que el LLM vea las herramientas actuales de V2 y sus esquemas.

  4. Actualiza las instrucciones y reglas personalizadas — Si tienes reglas de Cursor, instrucciones de Claude u otros prompts que mencionen nombres específicos de herramientas V1 (p. ej. "usa get_account_info"), actualízalos para que coincidan con los nombres de V2 o elimina esas referencias y deja que el LLM descubra las herramientas desde el contexto.

  5. Restringe las herramientas con ALPACA_TOOLSETS — Si antes limitabas las capacidades que tu asistente podía usar, V2 admite filtrado en el servidor mediante la variable de entorno ALPACA_TOOLSETS. Consulta Configuración > Filtrado de conjuntos de herramientas para ver la lista de conjuntos de herramientas.

Resumen

Asume que no hay compatibilidad hacia atrás con V1. Reconfigura tu cliente MCP para V2, reinícialo y usa una sesión nueva. Consulta la sección Herramientas disponibles para ver la lista actual de herramientas.

Si tenías flujos de trabajo personalizados de V1

Si documentaste herramientas permitidas, escribiste scripts que llaman a las herramientas por nombre o creaste prompts basados en formas específicas de herramientas/parámetros de V1, considéralos obsoletos. Recrégalos usando las Herramientas disponibles que se enumeran a continuación y los esquemas de parámetros actuales que expone el servidor.

Seguir en V1

Si necesitas quedarte en V1, fija la última versión de V1 (p. ej. uvx alpaca-mcp-server==1.x.x serve) en la configuración de tu cliente MCP. V1 sigue disponible en PyPI para las configuraciones existentes.


Requisitos previos

Obtención de tus claves de API

  1. Visita el Alpaca Dashboard

  2. Crea una cuenta gratuita de paper trading

  3. Genera las claves de API desde el panel

Instalación

Añade el servidor a la configuración de tu cliente MCP y luego reinicia el cliente. No hay comando init, no hay archivos .env: las credenciales se establecen en un solo lugar.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) o %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

Alpaca no proporciona un servidor MCP remoto alojado. Para usar el servidor MCP en la aplicación móvil de Claude, alójalo de forma remota en un proveedor de nube y luego agrégalo como conector personalizado en Claude. El conector se sincroniza con la aplicación móvil una vez que te conectas en la web.

Para el alojamiento, el despliegue y la configuración del conector, consulta Cómo implementar el servidor MCP de Alpaca de forma remota en la aplicación móvil de Claude.

ChatGPT

Alpaca no proporciona un servidor MCP remoto alojado. Para usar el servidor MCP en ChatGPT, alójalo de forma remota en un proveedor de nube y luego agrégalo como conector.

Consulta Conectores en ChatGPT y la guía de implementación para Claude Mobile para conocer los pasos de alojamiento y configuración.

Cursor

Instala desde el Cursor Directory en unos pocos clics, o añádelo a ~/.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

Crea .vscode/mcp.json en la raíz de tu proyecto. Consulta la documentación oficial.

{
  "mcp": {
    "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

Consulta la guía oficial.

  1. Ve a Archivo → Configuración → Herramientas → Model Context Protocol (MCP)

  2. Añade un nuevo servidor:

  • Tipo: stdio

  • Comando: uvx

  • Argumentos: alpaca-mcp-server

  1. Establece las variables de entorno:

 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

Verifícalo con /mcp en la CLI de Claude Code.

Antigravity CLI

Consulta la documentación de MCP de Antigravity.

Añádelo a ~/.gemini/antigravity-cli/mcp_config.json (global) o .agents/mcp_config.json (espacio de trabajo):

{
  "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 .

Añádelo a la configuración de tu 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"
      ]
    }
  }
}

Configuración

Toda la configuración se realiza mediante variables de entorno establecidas en la configuración de tu cliente MCP. No se escribe ningún archivo en el disco.

Variable

Requerida

Predeterminado

Descripción

ALPACA_API_KEY

Tu clave de API de Alpaca

ALPACA_SECRET_KEY

Tu clave secreta de Alpaca

ALPACA_PAPER_TRADE

No

true

Establécelo en false para trading en vivo

ALPACA_TOOLSETS

No

todas

Lista separada por comas de conjuntos de herramientas para habilitar

Cambio a trading en vivo

Actualiza el bloque env en la configuración de tu cliente MCP y reinicia:

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

Filtrado de conjuntos de herramientas

De forma predeterminada, todas las herramientas están habilitadas. Para limitar el servidor a conjuntos de herramientas específicos, establece ALPACA_TOOLSETS:

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

Conjuntos de herramientas disponibles:

Toolset

Descripción

account

Información de cuenta, configuración, historial de cartera, actividades

trading

Órdenes, posiciones, ejercicio de opciones

watchlists

Operaciones CRUD de listas de seguimiento

assets

Búsqueda de activos, contratos de opciones, calendario, reloj

stock-data

Barras, cotizaciones, operaciones, instantáneas y screener de acciones

crypto-data

Barras, cotizaciones, operaciones, instantáneas y libros de órdenes de criptomonedas

options-data

Barras, cotizaciones, operaciones, instantáneas, cadena y códigos de intercambio de opciones

corporate-actions

Anuncios de acciones corporativas

news

Artículos de noticias para acciones y criptomonedas

fixed-income-data

Cotizaciones de renta fija (bonos/tesorería)

locates

Solicitudes y cotizaciones de localización de ventas en corto

Documentación MCP de ReadMe

La documentación está limitada a las especificaciones de la Trading API, Market Data API y Authentication API; la documentación de los endpoints de la Broker API está excluida intencionalmente de este servidor.

Si la búsqueda MCP de ReadMe falla, las respuestas de las herramientas incluyen enlaces de respaldo a la documentación pública de Alpaca, además de llms.txt y llms-full.txt.

Características

  • Datos de mercado — Cotizaciones, operaciones y barras de precios en tiempo real para acciones, criptomonedas y opciones. Datos históricos con marcos de tiempo flexibles. Griegos de opciones y volatilidad implícita.

  • Gestión de cuenta — Consulta saldos, poder de compra, estado de la cuenta e historial de cartera.

  • Gestión de órdenes — Coloca órdenes de mercado, límite, stop, stop-limit y trailing-stop para acciones, criptomonedas y opciones. Cancela órdenes individualmente o en bloque.

  • Trading de opciones — Busca contratos por vencimiento/strike/tipo. Coloca estrategias de una o varias patas. Obtén las últimas cotizaciones, griegos e IV.

  • Trading de criptomonedas — Órdenes de mercado, límite y stop-limit con GTC/IOC. Basadas en cantidad o en nocional.

  • Gestión de posiciones — Consulta, cierra o liquida posiciones. Ejerce contratos de opciones.

  • Noticias — Artículos de noticias filtrables por ticker y rango de fechas.

  • Estado del mercado — Horarios de apertura/cierre del mercado, calendario, acciones corporativas.

  • Listas de seguimiento — Crea, actualiza y gestiona listas de seguimiento.

  • Búsqueda de activos — Consulta detalles de acciones, ETFs, criptomonedas y opciones con filtrado.

Ejemplos de prompts

Trading básico

  1. ¿Cuál es mi saldo de cuenta actual y mi poder de compra en Alpaca?

  2. Muéstrame mis posiciones actuales en mi cuenta de Alpaca.

  3. Compra 5 acciones de AAPL a precio de mercado.

  4. Vende 5 acciones de TSLA con un precio límite de $300.

  5. Cancela todas las órdenes de acciones abiertas.

  6. Cancela la orden con ID abc123.

  7. Liquida toda mi posición en GOOGL.

  8. Cierra el 10% de mi posición en NVDA.

  9. Coloca una orden límite para comprar 100 acciones de MSFT a $450.

  10. Coloca una orden de mercado para vender 25 acciones de META.

Negociación de Criptomonedas

  1. Coloca una orden de mercado para comprar 0,01 ETH/USD.

  2. Coloca una orden límite para vender 0,01 BTC/USD a $110.000.

Negociación de Opciones

  1. Muéstrame los contratos de opciones disponibles para AAPL que vencen el próximo mes.

  2. Obtén la última cotización para la opción AAPL250613C00200000.

  3. Recupera la instantánea de la opción SPY250627P00400000.

  4. Liquida mi posición en 2 contratos de opciones call de QQQ que vencen la próxima semana.

  5. Coloca una orden de mercado para comprar 1 opción call sobre AAPL que vence el próximo viernes.

  6. ¿Cuáles son las griegas de la opción TSLA250620P00500000?

  7. Encuentra contratos de opciones de TSLA con precios de ejercicio dentro del 5% del precio de mercado actual.

  8. Obtén opciones call de SPY que vencen la semana del 16 de junio de 2025, dentro del 10% del precio de mercado.

  9. Coloca un spread alcista de calls usando las opciones de AAPL del 6 de junio: una con ejercicio de 190,00 y la otra con ejercicio de 200,00.

  10. Ejerce mi contrato de opción call de NVDA NVDA250919C001680.

Información de Mercado

Para acceder a los datos más recientes de 15 minutos, necesitas suscribirte al Algo Trader Plus Plan.

  1. ¿Cuáles son los horarios de apertura y cierre del mercado hoy?

  2. Muéstrame el calendario de mercado para la próxima semana.

  3. Muéstrame los dividendos en efectivo y los desdoblamientos de acciones recientes para AAPL, MSFT y GOOGL en los últimos 3 meses.

  4. Obtén todas las acciones corporativas para SPY, incluyendo dividendos, desdoblamientos y cualquier fusión en el último año.

  5. ¿Cuáles son las acciones corporativas programadas para SPY en los próximos 6 meses?

Datos Históricos y en Tiempo Real

  1. Muéstrame el historial de precios diario de AAPL de los últimos 5 días de negociación.

  2. ¿Cuál fue el precio de cierre de TSLA ayer?

  3. Obtén la última barra para GOOGL.

  4. ¿Cuál fue el último precio de negociación de NVDA?

  5. Muéstrame la última cotización de MSFT.

  6. Recupera las últimas 100 operaciones de AMD.

  7. Muéstrame las barras de 1 minuto de AMZN de las últimas 2 horas.

  8. Obtén barras intradía de 5 minutos para TSLA desde el martes pasado hasta el viernes pasado.

  9. Obtén una instantánea completa de la acción de AAPL que muestre la última cotización, la operación, la barra de minutos, la barra diaria y la barra diaria anterior, todo en una sola vista.

  10. Compara las instantáneas de mercado de TSLA, NVDA y MSFT para analizar sus spreads de oferta/demanda actuales, los últimos precios de negociación y el rendimiento diario.

Órdenes

  1. Muéstrame todas mis órdenes abiertas y ejecutadas de esta semana.

  2. ¿Qué órdenes tengo para AAPL?

  3. Lista todas las órdenes límite que coloqué en los últimos 3 días.

  4. Filtra todas las órdenes por estado: ejecutadas.

  5. Obtén el historial de órdenes de ayer.

Listas de Seguimiento

Por el momento, solo puedes ver y actualizar las listas de seguimiento de negociación creadas a través de la API de Trading de Alpaca mediante la propia API.

  1. Crea una nueva lista de seguimiento llamada "Tech Stocks" con AAPL, MSFT y NVDA.

  2. Actualiza mi lista de seguimiento "Tech Stocks" para incluir TSLA y AMZN.

  3. ¿Qué acciones hay en mi lista de seguimiento "Dividend Picks"?

  4. Elimina META de mi lista de seguimiento "Growth Portfolio".

  5. Lista todas mis listas de seguimiento existentes.

Información de Activos

  1. Busca detalles sobre el activo 'AAPL'.

  2. Muéstrame los 5 principales activos de criptomonedas negociables por volumen de negociación.

  3. Obtén todos los activos de renta variable estadounidense activos de NASDAQ y filtra los resultados para mostrar solo valores negociables.

Escenarios Combinados

  1. Obtén el reloj de mercado de hoy y muéstrame mi poder de compra antes de colocar una orden límite de compra para TSLA a $340.

  2. Coloca un spread alcista de calls con opciones de SPY del 3 de julio: vende una un 5% por encima y compra una un 3% por debajo del precio actual de SPY.

Herramientas Disponibles

Cuenta y Cartera

  • get_account_info — Saldo, margen y estado de la cuenta

  • get_account_config — Restricciones de negociación, ajustes de margen, comprobaciones de PDT

  • update_account_config — Actualiza los ajustes de configuración de la cuenta

  • get_portfolio_history — Patrimonio y P/L a lo largo del tiempo

  • get_account_activities — Ejecuciones, dividendos, transferencias

  • get_account_activities_by_type — Actividades filtradas por tipo

Negociación (Órdenes)

  • get_orders — Recupera órdenes con filtros

  • get_order_by_id — Una sola orden por ID

  • get_order_by_client_id — Una sola orden por ID de orden del cliente

  • replace_order_by_id — Reemplaza una orden abierta existente

  • cancel_order_by_id — Cancela una orden específica

  • cancel_all_orders — Cancela todas las órdenes abiertas

  • place_stock_order — Acciones/ETFs (mercado, límite, stop, stop-limit, trailing-stop, brackets)

  • place_crypto_order — Cripto (mercado, límite, stop-limit)

  • place_option_order — Opciones (de una sola pata o de varias patas)

Posiciones

  • get_all_positions — Todas las posiciones actuales

  • get_open_position — Detalles de una posición específica

  • close_position — Cierra una posición específica

  • close_all_positions — Liquida toda la cartera

  • exercise_options_position — Ejerce un contrato de opción en cartera

  • do_not_exercise_options_position — Instrucción de no ejercer

Listas de Seguimiento

  • create_watchlist — Crea una nueva lista de seguimiento

  • get_watchlists — Lista todas las listas de seguimiento

  • get_watchlist_by_id — Obtén una lista de seguimiento específica

  • update_watchlist_by_id — Actualiza una lista de seguimiento

  • delete_watchlist_by_id — Elimina una lista de seguimiento

  • add_asset_to_watchlist_by_id — Añade un activo a una lista de seguimiento

  • remove_asset_from_watchlist_by_id — Elimina un activo de una lista de seguimiento

Activos e Información de Mercado

  • get_all_assets — Lista activos con filtrado opcional

  • get_asset — Información detallada de un activo específico

  • get_option_contracts — Contratos de opciones para el/los símbolo(s) subyacente(s)

  • get_option_contract — Un solo contrato de opción por símbolo o ID

  • get_calendar — Calendario de mercado para un rango de fechas

  • get_clock — Estado actual del mercado y próxima apertura/cierre

  • get_corporate_action_announcements — Anuncios de acciones corporativas

  • get_corporate_action_announcement — Un solo anuncio por ID

Datos de Acciones

  • get_stock_bars — Barras OHLCV históricas

  • get_stock_quotes — Cotizaciones históricas de oferta/demanda

  • get_stock_trades — Operaciones históricas

  • get_stock_latest_bar — Última barra de minutos

  • get_stock_latest_quote — Última cotización

  • get_stock_latest_trade — Última operación

  • get_stock_snapshot — Instantánea completa

  • get_most_active_stocks — Más activas por volumen/número de operaciones

  • get_market_movers — Principales ganadores y perdedores

Datos de Criptomonedas

  • get_crypto_bars — Barras OHLCV históricas

  • get_crypto_quotes — Cotizaciones históricas

  • get_crypto_trades — Operaciones históricas

  • get_crypto_latest_bar — Última barra de minutos

  • get_crypto_latest_quote — Última cotización

  • get_crypto_latest_trade — Última operación

  • get_crypto_snapshot — Instantánea completa

  • get_crypto_latest_orderbook — Último libro de órdenes

Datos de Opciones

  • get_option_bars — Barras OHLCV históricas

  • get_option_trades — Operaciones históricas

  • get_option_latest_trade — Última operación

  • get_option_latest_quote — Última cotización con información de oferta/demanda y de bolsa

  • get_option_snapshot — Instantánea con griegas e IV

  • get_option_chain — Cadena de opciones completa para un subyacente

  • get_option_exchange_codes — Mapeo de códigos de bolsa a nombres

Acciones Corporativas

  • get_corporate_actions — Anuncios de acciones corporativas desde datos de mercado

Noticias

  • get_news — Artículos de noticias para acciones y criptomonedas

Datos de Renta Fija

  • get_fixed_income_latest_quotes — Últimas cotizaciones de valores de renta fija por ISIN

Locates (Venta en Corto)

  • get_locates — Lista solicitudes de locate filtradas por estado, símbolo o rango de fechas

  • create_locate — Crea una solicitud de locate para una venta en corto

  • get_locate — Obtén una sola solicitud de locate por ID

  • get_locate_quotes — Obtén disponibilidad de locate y precios para símbolos

Documentación

  • search_alpaca_docs — Busca páginas y guías de documentación de Alpaca

  • fetch_alpaca_doc — Obtén una página de documentación de Alpaca ReadMe por ID de página

  • search_alpaca_api_specs — Busca endpoints de referencia de la API de Alpaca por tema, ruta, parámetro o término de esquema

  • list_alpaca_api_endpoints — Lista endpoints para una especificación OpenAPI de Alpaca permitida

  • get_alpaca_endpoint_docs — Obtén documentación de referencia para un endpoint exacto de la API de Alpaca por método y ruta

Pruebas

El proyecto incluye una suite de pruebas multicapa que se ejecuta en CI en cada pull request:

  • Pruebas de integridad — Validan la coherencia entre las especificaciones OpenAPI, las definiciones de los conjuntos de herramientas y las sobrescrituras de nombres/descripciones de herramientas. No requieren red ni credenciales.

  • Pruebas de construcción del servidor — Compilan el servidor con credenciales simuladas y verifican que se exponga el número correcto de herramientas. No requieren red.

  • Pruebas de integración con la API de paper — Ejecutan llamadas reales contra la API de paper trading de Alpaca, cubriendo información de cuenta, datos de mercado, ciclo de vida de órdenes, listas de seguimiento, posiciones y más. Requiere ALPACA_API_KEY y ALPACA_SECRET_KEY.

  • Pruebas de integración de ReadMe — Ejecutan llamadas en vivo de consulta de documentación contra el ReadMe MCP de Alpaca. Requiere ALPACA_RUN_README_INTEGRATION=true cuando se ejecuta localmente.

Ejecuta la suite 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

Estructura del Proyecto

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)
├── AGENTS.md                 ← Instructions for coding agents
├── pyproject.toml
└── README.md

Solución de Problemas

  • uv/uvx no encontrado: Instala uv desde la guía oficial (https://docs.astral.sh/uv/getting-started/installation/) y luego reinicia tu terminal para que uv/uvx estén en el PATH.

  • Credenciales faltantes: Establece ALPACA_API_KEY y ALPACA_SECRET_KEY en el bloque env del cliente. El modo paper por defecto es ALPACA_PAPER_TRADE = True.

  • El cliente no detectó la nueva configuración: Reinicia el cliente (Cursor, Claude Desktop, VS Code) después de los cambios.

  • Conflictos de puerto HTTP: Si usas --transport streamable-http, cambia --port a un puerto libre.

Divulgación

La información generada por nuestro servidor MCP y los agentes de IA conectados tiene fines exclusivamente educativos e informativos y no debe tomarse como asesoramiento de inversión. Alpaca no recomienda ningún valor ni estrategia de inversión específicos. Realiza tu propia diligencia debida antes de tomar cualquier decisión. Todas las empresas mencionadas operan de forma independiente y no son responsables entre sí.

La negociación de opciones no es adecuada para todos los inversores debido a su alto riesgo inherente, que puede resultar potencialmente en pérdidas significativas. Lee Características y Riesgos de las Opciones Estandarizadas (Documento de Divulgación de Opciones) antes de invertir en opciones.

Alpaca no prepara, edita, respalda ni aprueba el Contenido de Terceros. Alpaca no garantiza la exactitud, la actualidad, la integridad ni la utilidad del Contenido de Terceros, y no es responsable de ningún contenido, publicidad, producto u otros materiales en sitios de terceros o disponibles desde ellos.

Todas las inversiones conllevan riesgo, y el rendimiento pasado de un valor o producto financiero no garantiza resultados o rentabilidades futuras. No hay garantía de que una estrategia de inversión alcance sus objetivos. Ten en cuenta que la diversificación no asegura ganancias ni protege contra pérdidas. Siempre existe la posibilidad de perder dinero al invertir en valores u otros productos financieros. Los inversores deben considerar cuidadosamente sus objetivos de inversión y los riesgos antes de invertir.

Los cálculos del algoritmo se basan en datos de mercado históricos y en tiempo real, pero pueden no tener en cuenta todos los factores del mercado, incluidos los movimientos repentinos de precios, las restricciones de liquidez o los retrasos en la ejecución. Los supuestos del modelo, como las estimaciones de volatilidad y el tratamiento de dividendos, pueden afectar al rendimiento y a la precisión. Las operaciones generadas por el algoritmo están sujetas a los procesos de ejecución del bróker, la liquidez del mercado, la prioridad de las órdenes y los retrasos de sincronización. Estos factores pueden provocar desviaciones en los precios o tiempos de ejecución esperados de las operaciones. Los usuarios son responsables de supervisar la actividad algorítmica y de comprender los riesgos implicados. Alpaca no se hace responsable de las pérdidas incurridas por el uso de este sistema.

Los resultados hipotéticos pasados de backtesting no garantizan rendimientos futuros, y los resultados reales pueden variar con respecto al análisis.

La API de Paper Trading es ofrecida por AlpacaDB, Inc. y no requiere dinero real ni permite al usuario realizar transacciones con valores reales en el mercado. Proporcionar el uso de la API de Paper Trading no constituye una oferta ni una solicitud para comprar o vender valores, derivados de valores o productos de futuros de ningún tipo, ni ningún tipo de asesoramiento, recomendación o estrategia de trading o inversión, ofrecido o respaldado de cualquier manera por AlpacaDB, Inc. o cualquier filial de AlpacaDB, Inc., y la información disponible a través de la API de Paper Trading no constituye una oferta ni una solicitud de ningún tipo en ninguna jurisdicción donde AlpacaDB, Inc. o cualquier filial de AlpacaDB, Inc. (colectivamente, "Alpaca") no esté autorizada para operar.

Los servicios de corretaje de valores son proporcionados por Alpaca Securities LLC ("Alpaca Securities"), miembro de FINRA/SIPC, una subsidiaria de propiedad total de AlpacaDB, Inc. La tecnología y los servicios son ofrecidos por AlpacaDB, Inc.

Los servicios de criptomonedas son proporcionados por Alpaca Crypto LLC ("Alpaca Crypto"), una empresa de servicios monetarios registrada ante FinCEN (NMLS # 2160858) y una subsidiaria de propiedad total de AlpacaDB, Inc. Alpaca Crypto no es miembro de SIPC ni de FINRA. Las criptomonedas no son acciones y sus inversiones en criptomonedas no están protegidas por FDIC ni SIPC. Los activos de criptomonedas son altamente volátiles y especulativos, conllevan un riesgo sustancial de pérdida y no están asegurados por la FDIC ni por ninguna agencia gubernamental. Los clientes deben ser conscientes de los diversos riesgos antes de utilizar estos servicios, incluida la posible pérdida del capital, consideraciones de ciberseguridad, desarrollos regulatorios y la naturaleza cambiante de la tecnología de activos digitales. Para obtener información adicional sobre los riesgos de las criptomonedas, haga clic aquí.

Esto no constituye una oferta, solicitud de oferta ni asesoramiento para comprar o vender valores o criptomonedas, ni para abrir una cuenta de corretaje o de criptomonedas en ninguna jurisdicción donde Alpaca Securities o Alpaca Crypto, respectivamente, no estén registradas o autorizadas, según corresponda.

Política de Privacidad

Para obtener información sobre cómo Alpaca gestiona sus datos, consulte:

Recopilación de Datos

  • Qué se recopila: La cadena de user agent (APCA-MCP-TRADING/<version>) para las llamadas a la API

  • Cómo se utiliza: Para identificar el uso del servidor MCP y mejorar la experiencia del usuario

  • Intercambio con terceros: No se comparte con terceros

  • Retención: Se conserva según la política de retención de datos estándar de Alpaca

  • Exclusión voluntaria: Establezca la variable de entorno ALPACA_MCP_USER_AGENT como una cadena vacía; no se enviará ningún encabezado User-Agent

Aviso de Seguridad

Este servidor puede realizar operaciones reales y acceder a su cartera. Trate sus claves de API como credenciales sensibles. Revise cuidadosamente todas las acciones propuestas por el LLM, especialmente en el caso de estrategias complejas de opciones u operaciones de múltiples patas.

Seguridad del transporte HTTP: Cuando se utiliza el transporte HTTP, el servidor se establece por defecto en localhost (127.0.0.1:8000) por seguridad. Para el acceso remoto, puede vincularse a todas las interfaces con --host 0.0.0.0, utilizar un túnel SSH (ssh -L 8000:localhost:8000 user@server) o configurar un proxy inverso con autenticación para un acceso seguro.

Soporte

Para problemas o preguntas, póngase en contacto con nosotros en support@alpaca.markets.

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

Metadatos del Registro MCP

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

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

0Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    Enables natural language trading operations through Alpaca's API, supporting stocks, options, crypto, portfolio management, and real-time market data with comprehensive order execution and account management capabilities.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language trading operations through AI assistants using Alpaca's Trading API. Supports stocks, options, crypto trading, portfolio management, and real-time market data access.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language trading operations for stocks, options, crypto, and portfolio management via Alpaca's Trading API through AI assistants.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides AI assistants with market screening, analysis, and scoring across stocks, crypto, and forex, enabling natural language queries for trading insights.
    4
    MIT

View all related MCP servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wizkax/alpaca-mcp-server-RFJq'

If you have feedback or need assistance with the MCP directory API, please join our Discord server