Copia de trabajo de drasticstatic — Utilizado por el sistema de trading Fortuna. Este es un repositorio independiente creado a partir de un clon local de verygoodplugins/robinhood-mcp. El repositorio original se rastrea como un remoto para comparación voluntaria; los cambios se revisan antes de aplicarlos.

# Check for upstream updates (review before applying)
git fetch upstream && git log upstream/main --oneline

robinhood-mcp

Un servidor MCP de solo lectura para la investigación de carteras de Robinhood. Envuelve a robin_stocks para dar a los asistentes de IA acceso a los datos de tu cartera para su análisis.

⚠️ Solo herramienta de investigación - Este servidor proporciona acceso de solo lectura. No se expone ninguna funcionalidad de trading.

⚠️ API no oficial - Utiliza la API no oficial de robin_stocks. Puede dejar de funcionar sin previo aviso. Úsalo bajo tu propia responsabilidad.

¿Qué puedes hacer con esto?

Una vez conectado, puedes tener conversaciones naturales con Claude sobre tu cartera:

Revisión de salud de la cartera

"Hazme una revisión de salud de mi cartera. ¿Cuál es mi valor total, la concentración por sector y hay alguna posición que haya subido o bajado significativamente?"

Claude obtendrá tus posiciones, calculará la exposición sectorial, identificará tus mejores y peores resultados y señalará cualquier riesgo de concentración.

Investigación antes de comprar

"Estoy pensando en aumentar mi posición en NVDA. Muéstrame los fundamentos, noticias recientes, calificaciones de analistas y cómo se ha comportado durante el último año."

Obtén una investigación exhaustiva que combina el historial de precios, ratios P/E, fechas de ganancias y sentimiento de los analistas en una sola respuesta.

Comparar inversiones

"Compara las líneas de cruceros en mi cartera: muéstrame CCL, RCL y NCLH lado a lado con sus ratios P/E, capitalización de mercado y rendimiento en lo que va de año."

Evalúa rápidamente participaciones similares para identificar el valor relativo.

Análisis de dividendos

"¿Qué dividendos he recibido este año? ¿Cuáles de mis participaciones pagan dividendos y cuáles son sus rendimientos?"

Realiza un seguimiento de tus ingresos pasivos e identifica oportunidades de dividendos en tu cartera.

Evaluación de riesgos

"¿Cuál es mi exposición al sector energético? ¿Qué tan concentrado estoy en mis 5 principales participaciones?"

Analiza la concentración sectorial e identifica posiciones que podrían estar sobreponderadas.

Calendario de ganancias

"¿Cuáles de mis participaciones tienen ganancias próximamente en las próximas dos semanas?"

Mantente por delante de la volatilidad de las ganancias con un calendario personalizado.

Atribución de rendimiento

"Desglosa los rendimientos de mi cartera. ¿Qué está impulsando mis ganancias y pérdidas?"

Comprende qué posiciones están contribuyendo más a tu rendimiento.

Investigación de listas de seguimiento

"Obtén cotizaciones y fundamentos para todo lo que hay en mi lista de seguimiento. ¿Cuáles parecen interesantes en este momento?"

Investiga en bloque las acciones que estás siguiendo.

Related MCP server: Public.com MCP Server

Instalación

pip install robinhood-mcp

O ejecútalo directamente con uvx:

uvx robinhood-mcp

Configuración

Variables de entorno

export ROBINHOOD_USERNAME="your_email"
export ROBINHOOD_PASSWORD="your_password"
export ROBINHOOD_TOTP_SECRET="your_2fa_secret"  # Only if you use authenticator app

Nota: Si utilizas Face ID, Touch ID o inicio de sesión con código de acceso en Robinhood (sin aplicación de autenticación), no necesitas ROBINHOOD_TOTP_SECRET.

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "robinhood": {
      "command": "uvx",
      "args": ["robinhood-mcp"],
      "env": {
        "ROBINHOOD_USERNAME": "your_email",
        "ROBINHOOD_PASSWORD": "your_password"
      }
    }
  }
}

Claude Code

claude mcp add robinhood -- uvx robinhood-mcp

Herramientas disponibles

Ejemplos de conversaciones

Consultas simples:

• "¿Cuánto vale mi cartera ahora mismo?"

• "Muéstrame mis 5 principales participaciones por valor"

• "¿Ya poseo HIMS y cuál es mi posición actual?"

• "Obtén una cotización para AAPL"

Para preguntas de cartera sobre un solo símbolo, prefiere robinhood_get_position en lugar de robinhood_get_positions. La herramienta de un solo símbolo evita reconstruir cada participación y es mucho más rápida para preguntas como "¿Debería añadir más HIMS?"

Solicitudes de análisis:

• "Compara los fundamentos de GOOGL vs META"

• "¿Cuáles de mis acciones cotizan por debajo de su promedio de 52 semanas?"

• "Muéstrame el gráfico de precios de TSLA durante el último año"

• "¿Cuál es mi acción con mejor rendimiento? ¿Cuál es la peor?"

Flujos de trabajo de investigación:

• "Quiero entender la industria de los cruceros. Obtén datos sobre CCL, RCL y NCLH: compara sus fundamentos y rendimiento reciente."

• "Encuentra acciones en mi cartera con un P/E inferior a 15 y crecimiento de ganancias positivo"

• "Estoy perdiendo mucho en algunas posiciones. Muéstrame los fundamentos y noticias de mis peores resultados para ayudarme a decidir si debo mantener o cortar pérdidas."

Limitaciones

• Solo lectura: No se pueden realizar operaciones, modificar listas de seguimiento ni cambiar la configuración de la cuenta

• API no oficial: Robinhood puede cambiar su API en cualquier momento, rompiendo la funcionalidad

• Sin transmisión en tiempo real: Las cotizaciones son puntuales, no transmisiones en vivo

• Caducidad de sesión: Es posible que debas volver a autenticarte periódicamente

• Límites de tasa: El uso intensivo puede activar la limitación de tasa de Robinhood

Notas de seguridad

• Las credenciales solo se utilizan localmente para autenticarse con Robinhood

• Los tokens de sesión se almacenan en caché en ~/.tokens/robinhood.pickle por robin_stocks

• Nunca subas tu archivo .env ni expongas credenciales

• Esta herramienta no puede ejecutar operaciones: es de solo lectura por diseño

Desarrollo

git clone https://github.com/verygoodplugins/robinhood-mcp.git
cd robinhood-mcp
pip install -e ".[dev]"

# Lint
ruff check . && ruff format --check .

# Test
pytest

# Run locally
robinhood-mcp

Solución de problemas

Errores de "No iniciado sesión":

• Verifica que tu nombre de usuario y contraseña sean correctos

• Si tienes 2FA con una aplicación de autenticación, necesitas ROBINHOOD_TOTP_SECRET

• Intenta iniciar sesión a través de la aplicación Robinhood para asegurarte de que tu cuenta no esté bloqueada

Error de "Non-base32 digit found":

• Tu secreto TOTP contiene caracteres no válidos

• El secreto solo debe contener letras A-Z y dígitos 2-7

• Si no utilizas una aplicación de autenticación, elimina ROBINHOOD_TOTP_SECRET por completo

Limitación de tasa:

• robin_stocks no tiene limitación de tasa incorporada

• Si alcanzas los límites de tasa, espera unos minutos antes de volver a intentarlo

Licencia

MIT

Descargo de responsabilidad

Esta herramienta es solo para fines educativos y de investigación. Utiliza APIs no oficiales que pueden dejar de funcionar en cualquier momento. Los autores no son responsables de ninguna restricción de cuenta, inexactitud de datos o pérdidas financieras.

Este proyecto no está afiliado, respaldado ni conectado con Robinhood Markets, Inc.

Ejemplos de automatización

Revisión diaria de cartera con Claude Code

Configura un trabajo cron para obtener un resumen diario de la cartera:

# ~/.claude/commands/portfolio-review.md
---
description: "Daily portfolio health check"
---
Using the robinhood MCP tools:
1. Get my current portfolio value and day change
2. Identify my top 3 gainers and top 3 losers today
3. Flag any positions that are down more than 20% from cost basis
4. Check if any holdings have earnings in the next 7 days
5. Give me a 2-3 sentence summary I can read with my morning coffee

Ejecútalo diariamente:

# Add to crontab -e
0 7 * * 1-5 cd ~/Projects && claude -p "/portfolio-review" --dangerously-skip-permissions >> ~/portfolio-reports/$(date +\%Y-\%m-\%d).md

Resumen de investigación semanal

# ~/.claude/commands/weekly-research.md
---
description: "Weekly deep dive on portfolio"
---
For each of my top 10 holdings by value:
1. Pull current fundamentals and compare to sector averages
2. Get recent news and analyst rating changes
3. Flag any significant changes from last week
4. Identify 2-3 stocks from my watchlist that might be worth adding

Format as a markdown report I can review on the weekend.

Créditos

Creado con 🧡 por Jack Arturo en Very Good Plugins.

Desarrollado por robin_stocks y FastMCP.

Enlaces

• GitHub

• PyPI

• Very Good Plugins

• AutoMem - Infraestructura de memoria de IA

• Documentación de robin_stocks

• Protocolo de contexto de modelo