Twelve Data MCP Server

Servidor MCP de Twelve Data

Conecta Claude, ChatGPT y otros asistentes de IA a la API financiera de Twelve Data: precios históricos y en tiempo real, más de 60 indicadores técnicos, fundamentales, ganancias, dividendos, ETFs, noticias de empresas, líderes del mercado y mucho más.

Necesitas una cuenta de Twelve Data. Regístrate en twelvedata.com.

Hay dos formas de usarlo. La mayoría de las personas deberían usar el servidor en la nube (Opción 1): no hay nada que instalar.

---

Opción 1 — Usa nuestro servidor en la nube (recomendado)

Conecta tu asistente de IA a nuestro servidor alojado:

https://mcp.twelvedata.com/mcp

Eso es todo. Sin instalación, sin necesidad de copiar y pegar una clave API. Al conectarte, se abre una ventana del navegador e inicias sesión con tu cuenta de Twelve Data; tu clave API personal se vincula automáticamente y permanece asociada a tu cuenta.

Cómo añadirlo

Claude (Escritorio / Web) y ChatGPT admiten conectores personalizados / servidores MCP:

1. Abre la configuración de Conectores (o Integraciones / Servidores MCP) de tu asistente.
2. Añade un nuevo conector con la URL https://mcp.twelvedata.com/mcp.
3. Cuando se te solicite, haz clic en Conectar / Iniciar sesión: se abrirá una página de inicio de sesión de Twelve Data en tu navegador.
4. Autoriza y listo. Pregunta cosas como "¿Cuál es el RSI de AAPL?" o "Muéstrame las últimas ganancias de TSLA."

Los nombres exactos de los menús varían entre aplicaciones y versiones, pero el flujo siempre es el mismo: añade la URL y luego inicia sesión mediante la ventana emergente del navegador.

---

Opción 2 — Ejecútalo localmente con tu clave API

¿Prefieres ejecutar el servidor en tu propia máquina (por ejemplo, para Claude Desktop mediante stdio)? Solo necesitas tu clave API de Twelve Data, sin configuración OAuth.

1. Obtén tu clave API

Inicia sesión en twelvedata.com → tu panel → API Keys. Copia tu clave.

2. Instalación

Requiere Python 3.10+ (se recomienda 3.12; en macOS brew install [email protected] o make python-install).

make install

3. Añade tu clave API

Crea un archivo .env en la raíz del proyecto con tu clave:

TWELVE_DATA_API_KEY=your_api_key_here

4. Conéctate a Claude Desktop

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

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": ["/path/to/twelve-data-mcp/src/server.py"]
    }
  }
}

Usa la ruta .venv/bin/python (no el Python del sistema: macOS incluye la versión 3.9 y este servidor necesita 3.10+). Reinicia Claude Desktop después de editar la configuración.

Eso es todo: el servidor lee tu clave API de .env y cada solicitud la utiliza. No se requiere ningún paso de inicio de sesión.

---

Lo que puedes preguntar

• Precios — acciones, ETFs, forex, criptomonedas, materias primas (en tiempo real e históricos)
• Indicadores técnicos — RSI, MACD, SMA, BBANDS, ATR y más de 60 más
• Fundamentales — estados financieros, ganancias, dividendos, splits, perfiles de empresa, capitalización bursátil, estadísticas clave, calendario de OPI
• Fondos — perfiles de ETF y fondos de inversión, rendimiento, participaciones, riesgo
• Noticias — noticias de empresas y comunicados de prensa
• Inteligencia de mercado — líderes del mercado, tipos de cambio, calificaciones de analistas, precios objetivo
• Regulación — presentaciones ante la SEC/EDGAR, transacciones de iniciados, participaciones institucionales

Formatos de símbolos: acciones AAPL, criptomonedas BTC/USD, forex EUR/USD.

---

Socios

¿Estás ejecutando tu propia instancia pública o configurando un inicio de sesión OAuth dedicado? Eso es un acuerdo de asociación: contáctanos en twelvedata.com y te proporcionaremos la guía de configuración y las credenciales OAuth.