alpaca-mcp-server

Un servidor integral del Protocolo de Contexto de Modelos (MCP) para la API de Trading de Alpaca. Habilita operaciones de trading en lenguaje natural a través de asistentes de IA como Claude, Cursor y VS Code. Soporta acciones, opciones, criptomonedas, gestión de carteras y datos de mercado en tiempo real.

Alpaca MCP Server v2 ya está aquí. Esta versión es una reescritura completa construida con FastMCP y OpenAPI. Si estás actualizando 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

• Actualización desde V1
• Requisitos previos
• Cómo obtener tus claves API
• Configuración
• Configuración avanzada
• Características
• Ejemplos de indicaciones
• Herramientas disponibles
• Pruebas
• Estructura del proyecto
• Solución de problemas
• Divulgación

---

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 un reemplazo directo si tu configuración depende de nombres o parámetros específicos de V1.

Qué cambia

Aspecto	V1	V2
Nombres de herramientas	Hechos a mano (p. ej. get_account_info)	Derivados de especificaciones con anulaciones (p. ej. get_account_info — los nombres pueden superponerse pero los esquemas difieren)
Parámetros	Esquemas personalizados	Alineados con las especificaciones de la API de Alpaca
Configuración	.env + comando init	Solo variables de entorno 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 de estilo V1 en V2

Los clientes MCP descubren las herramientas dinámicamente desde el servidor. No hay un archivo de configuración donde "incluyas en lista blanca" los nombres de las herramientas — el cliente obtiene las herramientas que el servidor expone. Para evitar que tu cliente o asistente de IA use 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 obtenga la nueva lista de herramientas en lugar de usar una obsoleta.
3. Inicia una nueva conversación/sesión — Las conversaciones existentes pueden tener referencias en caché a nombres de herramientas antiguos. Inicia una nueva conversación 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 otras indicaciones que mencionen nombres específicos de herramientas V1 (p. ej. "usa get_account_info"), actualízalas para que coincidan con los nombres de herramientas V2 o elimina esas referencias y deja que el LLM descubra las herramientas desde el contexto.
5. Restringe herramientas con ALPACA_TOOLSETS — Si anteriormente limitabas qué capacidades podía usar tu asistente, V2 admite filtrado del lado del 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 sin compatibilidad retroactiva 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 en V1

Si documentaste herramientas permitidas, escribiste scripts que llaman herramientas por nombre o creaste indicaciones en torno a formas específicas de herramientas/parámetros de V1 — trátalos como obsoletos. Recréealos usando las Herramientas disponibles que se enumeran a continuación y los esquemas de parámetros actuales que expone el servidor.

Permanecer en V1

Si necesitas permanecer 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 configuraciones existentes.

---

Requisitos previos

• Python 3.10+ (guía de instalación)
• uv (guía de instalación)
• Claves de la API de Trading de Alpaca (cuenta gratuita de trading en papel)
• Cliente MCP (Claude Desktop, Cursor, VS Code, etc.)

Cómo obtener tus claves API

1. Visita el Panel de Alpaca
2. Crea una cuenta gratuita de trading en papel
3. Genera las claves API desde el panel

Configuración

Agrega el servidor a la configuración de tu cliente MCP y luego reinicia el cliente. Sin comando init, sin 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

Claude Mobile requiere un servidor MCP remoto. Este paquete no configura la autenticación MCP remota, así que no lo expongas directamente a Internet público con tus claves API de Alpaca. Usa la configuración local stdio de un cliente de escritorio compatible.

ChatGPT

ChatGPT requiere un servidor MCP remoto. Este paquete no configura la autenticación MCP remota, así que no lo expongas directamente a Internet público con tus claves API de Alpaca. Usa la configuración local stdio de un cliente de escritorio compatible.

Cursor

Instala desde el Directorio de Cursor con unos clics, o agrégalo 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.

{
  "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. Agrega un nuevo servidor:

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

3. 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

Verifica con /mcp en la CLI de Claude Code.

CLI de Antigravity

Consulta la documentación de MCP de Antigravity.

Agrega 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 .

Agrega 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 avanzada

Toda la configuración se realiza mediante variables de entorno establecidas en la configuración de tu cliente MCP. No se escriben archivos en el disco.

Variable	Obligatoria	Predeterminado	Descripción
ALPACA_API_KEY	Sí	—	Tu clave API de Alpaca
ALPACA_SECRET_KEY	Sí	—	Tu clave secreta de Alpaca
ALPACA_PAPER_TRADE	No	true	Establécelo en false para trading en vivo
ALPACA_TOOLSETS	No	all	Lista separada por comas de conjuntos de herramientas a 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:

Conjunto de herramientas	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 de acciones, cotizaciones, operaciones, instantáneas, filtros
crypto-data	Barras de criptomonedas, cotizaciones, operaciones, instantáneas, libros de órdenes
options-data	Barras de opciones, cotizaciones, operaciones, instantáneas, cadena, códigos de intercambio
corporate-actions	Anuncios de acciones corporativas
news	Artículos de noticias para acciones y criptomonedas
fixed-income-data	Renta fija (cotizaciones de bonos/tesoros)
locates	Solicitudes y cotizaciones de ubicación de venta en corto

MCP de documentos ReadMe

Los documentos están limitados a las especificaciones de la API de Trading, la API de Datos de Mercado y la API de Autenticación; los documentos de endpoints de la API de Broker están excluidos intencionalmente de este servidor.

Si la búsqueda de MCP de ReadMe falla, las respuestas de las herramientas incluyen enlaces de respaldo a los documentos públicos de Alpaca más 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. Griegas 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 stop móvil para acciones, criptomonedas y opciones. Cancela órdenes individualmente o en lote.
• Trading de opciones — Busca contratos por vencimiento/precio de ejercicio/tipo. Coloca estrategias de una sola pata o de múltiples patas. Obtén cotizaciones, Griegas e IV actualizados.
• Trading de criptomonedas — Órdenes de mercado, límite y stop-limit con GTC/IOC. Basadas en cantidad o 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 indicaciones

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 al 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.

Trading 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.

Trading de opciones

1. Muéstrame los contratos de opciones disponibles para AAPL que vencen el próximo mes.
2. Obtén la cotización más reciente para la opción AAPL250613C00200000.
3. Recupera la instantánea de la opción para la opción SPY250627P00400000.
4. Liquida mi posición en 2 contratos de calls de QQQ que vencen la próxima semana.
5. Coloca una orden de mercado para comprar 1 opción call de AAPL que vence el próximo viernes.
6. ¿Cuáles son las Griegas de la opción para 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 de compra alcista usando opciones de AAPL del 6 de junio: una con un precio de ejercicio de 190.00 y la otra con un precio de 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 del mercado para la próxima semana.
3. Muéstrame los dividendos en efectivo y divisiones de acciones recientes para AAPL, MSFT y GOOGL en los últimos 3 meses.
4. Obtén todas las acciones corporativas para SPY, incluyendo dividendos, divisiones 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 diarios 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 cotización más reciente de MSFT.
6. Recupera las últimas 100 operaciones de AMD.
7. Muéstrame barras de 1 minuto para 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 acciones para AAPL que muestre la última cotización, operación, barra de minutos, barra diaria y barra diaria anterior en una sola vista.
10. Compara instantáneas de mercado para TSLA, NVDA y MSFT para analizar sus diferenciales de oferta/demanda actuales, últimos precios de negociación y rendimiento diario.

Órdenes

1. Muéstrame todas mis órdenes abiertas y completadas de esta semana.
2. ¿Qué órdenes tengo para AAPL?
3. Enumera todas las órdenes limitadas que coloqué en los últimos 3 días.
4. Filtra todas las órdenes por estado: completadas.
5. Obtén el historial de órdenes de ayer.

Listas de Seguimiento

En este momento, solo puedes ver y actualizar 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 están en mi lista de seguimiento "Dividend Picks"?
4. Elimina META de mi lista de seguimiento "Growth Portfolio".
5. Enumera todas mis listas de seguimiento existentes.

Información de Activos

1. Busca detalles sobre el activo 'AAPL'.
2. Muéstrame los 5 principales activos criptográficos negociables por volumen de negociación.
3. Obtén todos los activos de capital activos de NASDAQ y filtra los resultados para mostrar solo valores negociables.

Escenarios Combinados

1. Obtén el reloj del mercado de hoy y muéstrame mi poder de compra antes de colocar una orden de compra limitada para TSLA a $340.
2. Coloca un spread de compra alcista con opciones de SPY del 3 de julio: vende una 5% por encima y compra una 3% por debajo del precio actual de SPY.

Herramientas Disponibles

Cuenta y Portafolio

• get_account_info — Saldo, margen y estado de la cuenta
• get_account_config — Restricciones de negociación, configuraciones de margen, verificaciones de PDT
• update_account_config — Actualizar configuraciones de la cuenta
• get_portfolio_history — Capital 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 — Recuperar órdenes con filtros
• get_order_by_id — Una sola orden por ID
• get_order_by_client_id — Una sola orden por ID de orden de cliente
• replace_order_by_id — Reemplazar una orden abierta existente
• cancel_order_by_id — Cancelar una orden específica
• cancel_all_orders — Cancelar todas las órdenes abiertas
• place_stock_order — Acciones/ETFs (mercado, límite, stop, stop-límite, trailing-stop, brackets)
• place_crypto_order — Cripto (mercado, límite, stop-límite)
• place_option_order — Opciones (de una sola pata o de múltiples patas)

Posiciones

• get_all_positions — Todas las posiciones actuales
• get_open_position — Detalles para una posición específica
• close_position — Cerrar una posición específica
• close_all_positions — Liquidar todo el portafolio
• exercise_options_position — Ejercer un contrato de opción mantenido
• do_not_exercise_options_position — Instrucción de no ejercer

Listas de Seguimiento

• create_watchlist — Crear una nueva lista de seguimiento
• get_watchlists — Listar todas las listas de seguimiento
• get_watchlist_by_id — Obtener una lista de seguimiento específica
• update_watchlist_by_id — Actualizar una lista de seguimiento
• delete_watchlist_by_id — Eliminar una lista de seguimiento
• add_asset_to_watchlist_by_id — Agregar un activo a una lista de seguimiento
• remove_asset_from_watchlist_by_id — Eliminar un activo de una lista de seguimiento

Activos e Información de Mercado

• get_all_assets — Listar activos con filtrado opcional
• get_asset — Información detallada para un activo específico
• get_option_contracts — Contratos de opciones para 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 de oferta/demanda históricas
• 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 activos por volumen/recuento de operaciones
• get_market_movers — Mayores ganadores y perdedores

Datos Cripto

• 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 bolsa
• get_option_snapshot — Instantánea con griegos y volatilidad implícita
• get_option_chain — Cadena completa de opciones para un subyacente
• get_option_exchange_codes — Mapeo de código de bolsa a nombre

Acciones Corporativas

• get_corporate_actions — Anuncios de acciones corporativas de datos de mercado

Noticias

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

Datos de Renta Fija

• get_fixed_income_latest_quotes — Cotizaciones más recientes para valores de renta fija por ISIN

Locates (Venta en Corto) — no disponible en negociación de papel

• get_locates — Listar solicitudes de locate filtradas por estado, símbolo o rango de fechas
• create_locate — Crear una solicitud de locate para una venta en corto
• get_locate — Obtener una sola solicitud de locate por ID
• get_locate_quotes — Obtener disponibilidad y precios de locate para símbolos

Documentación

• search_alpaca_docs — Buscar páginas y guías de documentación de Alpaca
• fetch_alpaca_doc — Obtener una página de documentación de Alpaca ReadMe por ID de página
• search_alpaca_api_specs — Buscar endpoints de referencia de la API de Alpaca por tema, ruta, parámetro o término de esquema
• list_alpaca_api_endpoints — Listar endpoints para una especificación OpenAPI permitida de Alpaca
• get_alpaca_endpoint_docs — Obtener 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 de múltiples capas que se ejecuta en CI en cada solicitud de extracción:

• Pruebas de integridad — Validan la consistencia entre las especificaciones OpenAPI, las definiciones de conjuntos de herramientas y las anulaciones de nombres/descripciones de herramientas. No requieren red ni credenciales.
• Pruebas de construcción del servidor — Construyen el servidor con credenciales simuladas y verifican que se exponga el número correcto de herramientas. No requieren red.
• Pruebas de integración de la API de papel — Ejecutan llamadas reales contra la API de negociación de papel 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 de búsqueda de documentación en vivo contra el MCP de ReadMe 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)
│       └── publish-pypi.yml  ← PyPI publish on GitHub Release
├── 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 PATH.
• Credenciales faltantes: Configura ALPACA_API_KEY y ALPACA_SECRET_KEY en el bloque env del cliente. El modo de papel predeterminado 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 puertos HTTP: Si usas --transport streamable-http, cambia --port a un puerto libre.

Divulgación

Los conocimientos generados por nuestro servidor MCP y los agentes de IA conectados son solo para fines educativos e informativos y no deben tomarse como asesoramiento de inversión. Alpaca no recomienda ningún valor o estrategia de inversión específica. 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 en pérdidas significativas. Lee las 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 Contenido de Terceros. Alpaca no garantiza la precisión, puntualidad, integridad o utilidad del Contenido de Terceros, y no es responsable ni se hace responsable de ningún contenido, publicidad, producto u otro material en o disponible desde sitios de terceros.

Todas las inversiones implican riesgo, y el rendimiento pasado de un valor o producto financiero no garantiza resultados o retornos futuros. No hay garantía de que cualquier estrategia de inversión logre sus objetivos. Ten en cuenta que la diversificación no asegura una ganancia 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 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 movimientos repentinos de precios, restricciones de liquidez o retrasos en la ejecución. Los supuestos del modelo, como las estimaciones de volatilidad y los tratamientos de dividendos, pueden afectar el rendimiento y la precisión. Las operaciones generadas por el algoritmo están sujetas a los procesos de ejecución del corredor, la liquidez del mercado, la prioridad de las órdenes y los retrasos de tiempo. Estos factores pueden causar desviaciones de los precios o tiempos de ejecución esperados. Los usuarios son responsables de monitorear la actividad algorítmica y comprender los riesgos involucrados. Alpaca no es responsable de ninguna pérdida incurrida a través del uso de este sistema.

Los resultados pasados de backtesting hipotético no garantizan retornos futuros, y los resultados reales pueden variar del análisis.

La API de Negociación de Papel es ofrecida por AlpacaDB, Inc. y no requiere dinero real ni permite a un usuario transaccionar valores reales en el mercado. Proporcionar el uso de la API de Negociación de Papel no es una oferta ni 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 negociación o inversión, dado o respaldado de alguna manera por AlpacaDB, Inc. o cualquier afiliado de AlpacaDB, Inc., y la información disponible a través de la API de Negociación de Papel no es una oferta ni solicitud de ningún tipo en ninguna jurisdicción donde AlpacaDB, Inc. o cualquier afiliado de AlpacaDB, Inc. (colectivamente, "Alpaca") no esté autorizado para hacer negocios.

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 en 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 por SIPC. Los activos de criptomonedas son altamente volátiles y especulativos, implicando un riesgo sustancial de pérdida, y no están asegurados por FDIC ni por ninguna agencia gubernamental. Los clientes deben ser conscientes de los diversos riesgos antes de utilizar estos servicios, incluyendo 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 es 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 cualquier jurisdicción donde Alpaca Securities o Alpaca Crypto, respectivamente, no estén registrados o licenciados, según corresponda.

Política de Privacidad

Para obtener información sobre cómo Alpaca maneja sus datos, revise:

• Política de Privacidad
• Biblioteca de Divulgaciones

Recopilación de Datos

• Qué se recopila: Cadena de agente de usuario (APCA-MCP-TRADING/<version>) para llamadas a la API
• Cómo se utiliza: Para identificar el uso del servidor MCP y mejorar la experiencia del usuario
• Compartición con terceros: No se comparte con terceros
• Retención: Se retiene según la política estándar de retención de datos de Alpaca
• Exclusión voluntaria: Establezca la variable de entorno ALPACA_MCP_USER_AGENT a una cadena vacía; no se enviará ningún encabezado de 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 para estrategias complejas de opciones u operaciones de múltiples patas.

Seguridad del Transporte HTTP: HTTP Streamable tiene como valor predeterminado localhost (127.0.0.1:8000) y valida los encabezados Host y Origin. Docker tiene como valor predeterminado stdio. Helm tiene como valor predeterminado HTTP ClusterIP con ingress desactivado. Vincular a 0.0.0.0 no proporciona autenticación. Este paquete no configura OAuth de MCP, por lo que no debe exponerse directamente a la internet pública. Los operadores que proporcionan autenticación MCP basada en estándares también deben configurar FASTMCP_HTTP_ALLOWED_HOSTS de FastMCP a los nombres de host públicos exactos.

Soporte

Para problemas o preguntas, contáctenos en support@alpaca.markets.

Problemas de GitHub: https://github.com/alpacahq/alpaca-mcp-server/issues Solicitudes de extracción de GitHub: https://github.com/alpacahq/alpaca-mcp-server/pulls

Metadatos del Registro MCP

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