Cómo conectar Finnhub a Cursor vía MCP

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

Finnhub + Cursor

Dale a tu IA datos de mercado en vivo de Finnhub: cotizaciones de acciones, divisas y criptomonedas, perfiles de empresa e indicadores clave, noticias de empresas y de mercado, recomendaciones de analistas, calendarios de resultados y de salidas a bolsa, operaciones de directivos, documentos presentados ante la SEC y estado del mercado. Funciona con el plan gratuito de Finnhub; solo lectura.

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:

FINNHUB_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva alrededor de 1 minuto. Necesitas una clave de API de Finnhub; el plan gratuito cubre todas las herramientas salvo el historial de precios en velas.

1. Regístrate en finnhub.io/register. Es gratis.
2. Abre el Dashboard en finnhub.io/dashboard y copia la clave de API que aparece ahí.
3. Pega solo la clave en FINNHUB_API_KEY, sin token= ni espacios. El conector la envía en la cabecera X-Finnhub-Token, nunca en la URL.
4. Instala el conector y ejecuta finnhub_get_market_status con la bolsa US: te dice si el mercado de EE. UU. está abierto ahora y en qué sesión está.

Qué lee: cotizaciones de acciones, ETF, divisas y cripto; perfiles de empresa con capitalización y acciones en circulación; indicadores como máximo y mínimo de 52 semanas, beta, PER, P/VC, BPA, márgenes, ROE y rentabilidad por dividendo; noticias de empresas y de mercado (general, divisas, cripto, fusiones); empresas comparables; recomendaciones mensuales de analistas; sorpresas en beneficios y el calendario de resultados; el calendario de salidas a bolsa; operaciones y sentimiento de los directivos; estados financieros tal como se presentaron ante la SEC y la lista de documentos SEC; estado del mercado y festivos; y las listas de símbolos de proveedores de divisas y exchanges cripto.

Primero el símbolo: la IA busca el ticker con finnhub_search_symbols, por nombre de empresa, símbolo, ISIN o CUSIP. Los tickers de EE. UU. van sin sufijo, como AAPL; otras bolsas llevan sufijo, como SAP.DE o VOD.L. Las cotizaciones de divisas y cripto usan el símbolo del exchange, como OANDA:EUR_USD o BINANCE:BTCUSDT, que la IA consulta con finnhub_list_forex_symbols o finnhub_list_crypto_symbols.

Cómo leer los números: los campos de la cotización son cortos: c actual, d variación, dp variación porcentual, h máximo, l mínimo, o apertura, pc cierre anterior, t hora en segundos Unix. La capitalización y las acciones en circulación van en millones. Las fechas son AAAA-MM-DD. Los estados financieros presentados son respuestas grandes, así que la IA acota finnhub_get_financials_reported con una fecha de inicio y de fin.

Plan gratuito: todas las herramientas funcionan salvo finnhub_get_stock_candles (historial de precios), que necesita un plan de pago y responde 403 con claves gratuitas; en ese caso la IA usa finnhub_get_quote y los valores de 52 semanas de finnhub_get_basic_financials. Con claves gratuitas algunos datos llegan menos atrás: noticias de empresa un año, sorpresas en beneficios los últimos 4 trimestres y el calendario de resultados un mes más las fechas próximas. Las cotizaciones en tiempo real cubren acciones de EE. UU.; otros mercados necesitan un plan de pago.

Solo lectura: todas las herramientas solo leen. El conector no envía órdenes ni mueve dinero, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Límites: el plan gratuito permite 60 llamadas por minuto y 30 por segundo. Tras un 429 la IA espera un minuto, y prefiere una llamada precisa a muchas genéricas.

Errores comunes: 401 significa que Finnhub rechazó la clave: cópiala otra vez desde el dashboard. 403 "You don't have access to this resource" significa que la clave funciona, pero esos datos no están en tu plan. 429 significa que se alcanzó el límite por minuto.

No es asesoramiento financiero: los datos de mercado son información. Si preguntas qué comprar o vender, la IA te muestra los números y te recuerda que no es asesoramiento financiero.

El conector no opera en bolsa, no envía órdenes, no se conecta a una cuenta de valores y no lee tu cartera.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Finnhub.

Herramientas disponibles

Ejemplos de prompts

• "¿A cuánto cotiza Inditex ahora mismo, y cuánto se ha movido hoy?"
• "Compara el PER, los márgenes y la rentabilidad por dividendo de Santander, BBVA e Iberdrola."
• "¿Qué empresas presentan resultados la semana que viene, y qué BPA esperan los analistas?"
• "¿Han comprado o vendido acciones los directivos de Nvidia en los últimos tres meses?"
• "Dame las últimas noticias de Tesla y lo que han recomendado los analistas en los últimos meses."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT