Alpaca MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Funciona con cuentas de prueba O cuentas reales a través de las mismas herramientas
Acciones, ETFs, criptomonedas y opciones soportadas
Barras históricas + cotizaciones en tiempo real desde Alpaca Market Data
Ciclo de vida completo de órdenes: crear, reemplazar, cancelar, verificar estado
Posiciones, patrimonio de cuenta y P/L disponibles como herramientas de primera clase

Demo en vivo

Cómo se ve en la práctica

alpaca.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "alpaca",
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "alpaca": {
      "command": {
        "path": "uvx",
        "args": [
          "alpaca-mcp-server"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add alpaca -- uvx alpaca-mcp-server

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Alpaca

Genera un resumen pre-mercado diario para tu cartera de vigilancia

👤 Operadores minoristas activos ⏱ ~10 min beginner

Cuándo usarlo: Quieres una verificación matutina de 30 segundos en tus 20 valores antes de la apertura — movimientos nocturnos, resultados, noticias obvias.

Requisitos previos

Cuenta Alpaca (prueba gratuita) — alpaca.markets → regístrate → claves API en el panel
Lista de vigilancia de símbolos — Lista simple como [AAPL, MSFT, NVDA, ...]

Flujo

Obtén datos de barras nocturnas

Para mi lista de vigilancia [symbols], obtén el cierre de ayer y la cotización pre-mercado más reciente. Calcula el % de brecha.✓ Copiado

→ Tabla: símbolo, cierre_anterior, apertura_pre, pct_brecha
Marca valores atípicos

¿Cuáles son los valores que abren con una brecha superior al 2% en cualquier dirección? Ordena por magnitud de brecha.✓ Copiado

→ Lista corta de 'necesita atención'
Añade contexto

Para cada valor atípico, obtén los últimos titulares de noticias del endpoint de noticias de Alpaca.✓ Copiado

→ Viñeta por valor con la causa probable

Resultado: Un resumen pre-mercado diario en 1 pantalla, con la misma forma cada día, sin clics manuales.

Errores comunes

Los datos de mercado gratuitos son solo IEX y tienen retraso; las cotizaciones pueden no coincidir con tu corredor — Está bien para análisis nocturno/EOD; si necesitas el feed SIP, actualiza al plan de datos pagado de Alpaca

Combinar con: notion

Comercia con dinero de prueba una estrategia simple basada en reglas

👤 Principiantes en comercio algorítmico ⏱ ~30 min intermediate

Cuándo usarlo: Tienes una regla como 'compra SPY cuando el retorno de 5 días < -3%, vende después de +2% o 5 días de operación' y quieres ejecutarla en dinero de prueba.

Requisitos previos

Claves de cuenta de prueba configuradas — Usa APCA_API_BASE_URL=https://paper-api.alpaca.markets
Una regla escrita — Entrada, salida, tamaño de posición, pérdida máxima — todo explícito antes de codificar nada

Flujo

Verifica la cuenta y las posiciones

Muestra el patrimonio de mi cuenta de prueba, poder de compra y posiciones abiertas actuales.✓ Copiado

→ Instantánea de cuenta limpia
Evalúa la condición de entrada hoy

Obtén las últimas 5 barras diarias de SPY. Calcula el retorno de 5 días. Si es < -3% y no tengo ya SPY, coloca una compra de mercado por $5000 nocional. Si no, no hagas nada.✓ Copiado

→ Ya sea un id de orden o un explícito 'sin acción'
Registra la decisión de hoy

Añade una fila a /trades/journal.csv: fecha, condición_cumplida, acción, id_orden, precio_ejecución.✓ Copiado

→ Fila de diario escrita

Resultado: Una ejecución diaria auditable de una estrategia simple con dinero de prueba, con un diario que puedas revisar.

Errores comunes

Ejecutar accidentalmente contra claves reales durante las pruebas — Mantén una verificación muy obvia al inicio: confirma que el número de cuenta coincida con tu cuenta de prueba antes de colocar cualquier orden
Claude olvida la posición de ayer y compra doble — Siempre obtén las posiciones actuales antes de evaluar la entrada; nunca confíes en la memoria

Combinar con: filesystem

Reequilibra una cartera hacia asignaciones objetivo

👤 Inversores DIY con una asignación objetivo ⏱ ~20 min intermediate

Cuándo usarlo: Trimestralmente: devuelve 60/30/10 (EE.UU./INTL/bonos) al objetivo sin calcular manualmente los conteos de acciones.

Requisitos previos

Asignación objetivo definida — p. ej. VTI 60%, VXUS 30%, BND 10%

Flujo

Mide la desviación

Obtén mis posiciones y precios actuales. Calcula el peso actual por símbolo vs objetivo [pega objetivos]. Muestra desviación en $ y %.✓ Copiado

→ Tabla de desviación por símbolo
Propón operaciones

Propón el conjunto mínimo de compras/ventas para llevar los pesos dentro del 1% del objetivo. Muestra comisiones esperadas (probablemente $0) y deslizamiento estimado.✓ Copiado

→ Plan de orden
Ejecuta con confirmación

Antes de colocar: resume el plan en 3 líneas y espera mi 'sí'. En sí, envía como órdenes de apertura de mercado.✓ Copiado

→ Órdenes colocadas con ids; el patrimonio coincide con el objetivo dentro del 1%

Resultado: Un reequilibrio trimestral limpio con un registro escrito de por qué ocurrió cada operación.

Errores comunes

Cuenta sujeta a impuestos: cada reequilibrio desencadena ganancias/pérdidas — Prefiere reequilibrio de nueva aportación o salidas conscientes de lotes de impuestos; ejecuta solo en IRA si no estás seguro

Combinar con: filesystem

Escanea una cadena de opciones para prima de put de corta duración

👤 Operadores de ingresos de opciones (puts asegurados en efectivo / llamadas cubiertas) ⏱ ~25 min advanced

Cuándo usarlo: Quieres encontrar el mejor put asegurado en efectivo para vender en valores que estarías feliz de poseer, semanalmente.

Requisitos previos

Cuenta Alpaca habilitada para opciones — Habilita en la configuración de la cuenta; el dinero de prueba funciona para aprender

Flujo

Obtén cadena + griegos

Obtén la cadena de opciones para [ticker] expirando el próximo viernes, solo puts, precios de ejercicio dentro del 5% del spot. Incluye bid, ask, mid, delta, IV.✓ Copiado

→ Tabla de cadena
Ordena por rendimiento anualizado

Calcula el retorno anualizado sobre efectivo para cada precio de ejercicio asumiendo asignación. Filtra delta entre -0.15 y -0.30. Ordena los 5 mejores.✓ Copiado

→ Lista corta ordenada
Coloca venta para abrir con un límite en el medio

Coloca una orden de límite de venta para abrir para 1 contrato del precio de ejercicio #1 en el medio. GTC, solo día.✓ Copiado

→ Se devuelve el id de la orden

Resultado: Una rutina de ingresos semanal repetible con una pantalla de riesgo conservadora.

Errores comunes

Vender puts en empresas que no querrías poseer — Regla dura: solo comercia esta estrategia en 10 valores que haya aprobado previamente como tenencias a largo plazo
Precios de ejercicio ilíquidos con enorme bid-ask — los llenados nunca ocurren en el medio — Filtra para interés abierto > 500 y diferencial < 5% del medio antes de ordenar

Combinar con: notion

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

alpaca + notion

Resumen pre-mercado diario entregado a una página de Notion

Ejecuta mi escaneo pre-mercado para mi lista de vigilancia y crea una página de Notion en 'Trading / Daily' con los resultados.✓ Copiado

alpaca + filesystem

Diario de operaciones: añade cada orden y razón a un CSV local

Después de cualquier place_order, añade {ts, symbol, side, qty, reason} a /trading/journal.csv.✓ Copiado

alpaca + postgres

Almacena la curva de patrimonio diaria para probar estrategias retrospectivamente

Cada noche, INSERTA el patrimonio de hoy en la tabla equity_curve.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
get_account		Primera llamada en cualquier sesión — confirma que estés en dinero de prueba vs real	gratuito
get_positions		Verifica las tenencias actuales antes de cualquier lógica de entrada	gratuito
get_bars	symbol, timeframe, start, end, limit?	OHLCV histórico para análisis y señales	gratuito (IEX) o pagado (SIP)
get_latest_quote	symbol	Precio en tiempo real antes de colocar una orden	gratuito
place_order	symbol, qty\|notional, side, type, time_in_force, limit_price?	Envía una orden nueva (siempre dinero de prueba primero)	gratuito (sin comisiones)
cancel_order	order_id	Cancela una orden abierta antes de que se ejecute	gratuito
get_options_chain	underlying, expiration, side?	Escanea precios de ejercicio para una estrategia de opciones	gratuito en Alpaca

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: 200 req/min en la API de datos (nivel gratuito); la API de operaciones es efectivamente sin límite a escala minorista
Tokens por llamada: Cuenta/posiciones: 200–500 tokens. Barras: se escala con el límite.
Monetario: Alpaca no tiene comisiones. Plan de datos de mercado pagado ~$9/mes para el feed SIP; el feed IEX gratuito está bien para la mayoría de uso minorista.
Consejo: Comercia con dinero de prueba cada estrategia nueva durante al menos 4 semanas antes de tocar dinero real. Es gratis.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Clave API de cuenta + secreto — Alpaca no tiene sub-alcances

Almacenamiento de credenciales: APCA_API_KEY_ID, APCA_API_SECRET_KEY, y APCA_API_BASE_URL en variables de entorno

Salida de datos: Todas las llamadas a api.alpaca.markets o paper-api.alpaca.markets

No conceder nunca: Compartir claves reales con ningún servicio de terceros, incluyendo hosts de código

Las claves LIVE pueden comprar y vender valores reales. Por defecto usa URLs de PRUEBA (paper-api.alpaca.markets) hasta que las estrategias estén probadas.
Sin 2FA en claves API — trátalas como una entrada del gestor de contraseñas y rota después de cualquier sospecha de fuga.

Resolución de problemas

Errores comunes y soluciones

403 prohibido.permisos-insuficientes

Tus claves son para el entorno incorrecto (real vs prueba). Coincide con APCA_API_BASE_URL al par de claves.

Verificar: curl -H 'APCA-API-KEY-ID: ...' -H 'APCA-API-SECRET-KEY: ...' $APCA_API_BASE_URL/v2/account

422 poder_de_compra insuficiente

Tu cuenta de prueba se reinició, o dimensionaste la operación más allá del efectivo. Llama a get_account y recalcula el tamaño de posición.

Las barras devuelven vacío para marca de tiempo reciente

El feed IEX tiene ~15 min de retraso en nivel gratuito, y no sirve cada símbolo. Usa SIP o espera.

Orden rechazada: mercado cerrado

TIF por defecto es día; las órdenes del mercado cerrado necesitan time_in_force='opg' o 'cls' o cambiar a horario extendido con extended_hours=true en órdenes de límite.

Alternativas

Alpaca vs otros

Alternativa	Cuándo usarla	Contrapartida
Interactive Brokers MCP	Necesitas mercados internacionales o futuros	Autenticación más compleja (aplicación de puerta de enlace requerida); curva de aprendizaje
Polygon.io MCP	Solo necesitas datos de mercado, sin operaciones	Sin ejecución de órdenes; pagado para cobertura completa

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills