Conectar Alpha Vantage MCP con Gemini CLI

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Alpha Vantage, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Alpha Vantage + Gemini

Datos de mercado de Alpha Vantage: cotizaciones de acciones e historial diario o intradía de bolsas de todo el mundo, fundamentales y resultados de empresas, dividendos, participaciones de insiders e institucionales, perfiles de ETF, opciones, índices, divisas, cripto, materias primas, indicadores económicos de EE. UU., indicadores técnicos y noticias con sentimiento. Solo lectura; una clave de API gratuita permite 25 peticiones al día.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ALPHA_VANTAGE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva un minuto. Necesitas una clave de API de Alpha Vantage; para la gratuita basta con un correo electrónico.

1. Consigue una clave gratuita en https://www.alphavantage.co/support/#api-key.
2. Pégala en ALPHA_VANTAGE_API_KEY. Se envía como parámetro de consulta apikey.
3. Instala el conector y ejecuta alpha_vantage_get_market_status: muestra qué mercados de acciones, divisas y cripto están abiertos ahora y confirma la clave.

Planes: la clave gratuita permite 25 peticiones al día. Los planes premium (https://www.alphavantage.co/premium/) lo suben a 75 o más peticiones por minuto y desbloquean datos de EE. UU. en tiempo real, historial intradía, series diarias ajustadas, opciones y cotizaciones en bloque. Con 25 llamadas al día, la IA elige la herramienta que responde a la pregunta en lugar de probar varias.

Símbolos: los símbolos de EE. UU. van sin más (IBM); las demás bolsas llevan un sufijo, como TSCO.LON, SAP.DEX, RELIANCE.BSE o SHOP.TRT. Si no se conoce el símbolo exacto, la IA lo busca antes con alpha_vantage_search_symbols.

Qué lee:

• Precios: la última cotización de una acción o un ETF, cotizaciones en tiempo real de hasta 100 símbolos de EE. UU. a la vez (premium), historial diario, semanal y mensual de más de 20 años, sin ajustar o ajustado por splits y dividendos, y barras intradía de acciones de EE. UU. de 1 a 60 minutos. El estado de los mercados del mundo y los 20 valores de EE. UU. que más suben, más bajan y más se negocian en el día.
• Análisis de empresas: la visión general con sector, ratios de valoración, márgenes y precio objetivo de los analistas; cuentas de resultados, balances y flujos de caja anuales y trimestrales; beneficio por acción con sorpresas; estimaciones de BPA e ingresos de los analistas; acciones en circulación; dividendos y splits; operaciones de insiders; participaciones institucionales; transcripciones de las earnings calls desde 2010Q1.
• Fondos e índices: perfiles de ETF con posiciones y reparto por sectores, y el historial de más de 200 índices como SPX, NDX o VIX.
• Opciones (premium): la cadena de opciones de EE. UU. en tiempo real con griegas y volatilidad implícita, o la cadena de una sesión pasada desde 2008.
• Noticias: artículos sobre tickers o temas con sentimiento global y por ticker.
• Divisas y cripto: el tipo de cambio de cualquier par, tradicional o cripto, e historial diario, semanal o mensual (intradía con premium).
• Macro: PIB real de EE. UU., rendimientos del Tesoro, tipo de los fondos federales, IPC, inflación, desempleo, nóminas no agrícolas, ventas minoristas y pedidos de bienes duraderos; materias primas como WTI, Brent, gas natural, cobre, trigo y café; precio spot e historial del oro y la plata.
• Más de 50 indicadores técnicos, como SMA, EMA, RSI, MACD, bandas de Bollinger, ADX o ATR.

Formatos de datos: los números llegan como cadenas, a menudo con claves numeradas como "05. price". Las series temporales son objetos con la fecha (YYYY-MM-DD) o la marca de tiempo como clave, de la más reciente a la más antigua; las marcas intradía están en hora del este de EE. UU. Los fundamentales están en la divisa de los informes (reportedCurrency) y en unidades completas, y "None" significa no informado. Los datos diarios son de cierre, salvo con un entitlement premium. El sentimiento va de -1 (bajista) a 1 (alcista).

Volumen de datos, sin paginación: cada llamada devuelve su respuesta completa. outputsize compact (aquí el valor por defecto) devuelve los últimos 100 puntos; full puede devolver 20 años. Los indicadores técnicos cubren siempre todo el historial del intervalo, así que para periodos largos la IA usa datos semanales o mensuales. En opciones fija una expiration para que la cadena sea pequeña.

Solo lectura: todas las herramientas solo leen, así que no hay nada que confirmar y ninguna herramienta queda desactivada al instalar.

Errores frecuentes: Alpha Vantage responde HTTP 200 incluso cuando hay errores; el conector convierte esas respuestas en llamadas fallidas. Un mensaje de límite de frecuencia significa que se agotó la cuota diaria (25 con clave gratuita) o la cuota por minuto, o que las llamadas llegaron más rápido que una por segundo: espera o mejora el plan. Un mensaje premium significa que la función u opción necesita un plan de pago; las cotizaciones en bloque con clave gratuita devuelven datos de muestra y fallan. "Invalid API call" significa un símbolo o parámetro incorrecto. 401 significa que la clave fue rechazada.

El conector no usa los endpoints solo CSV (estado de cotización, calendario de resultados, calendario de OPV) ni los endpoints de analítica avanzada. Alpha Vantage tiene además un servidor MCP oficial en https://mcp.alphavantage.co.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Alpha Vantage.

Herramientas disponibles

Ejemplos de prompts

• "¿A cuánto cotiza Apple ahora mismo y cuánto se ha movido hoy?"
• "Compara los ingresos, el resultado operativo y el flujo de caja libre de Microsoft y Alphabet en los últimos cuatro ejercicios."
• "Muéstrame los cierres diarios de SAP en XETRA de las últimas 100 sesiones."
• "¿Cuál es el sentimiento de las últimas noticias sobre NVIDIA y qué artículos son los más alcistas?"
• "¿Cómo han evolucionado el rendimiento del bono del Tesoro de EE. UU. a 10 años y la inflación del IPC en los últimos dos años?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot