Twelve Data

Servidor MCP de Twelve Data

Conecta Claude, ChatGPT y otros asistentes de IA a la API financiera de Twelve Data: precios en tiempo real e históricos, más de 60 indicadores técnicos, fundamentales, ganancias, dividendos, ETF, noticias de empresas, valores destacados del mercado y 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 clave API para copiar y pegar. Cuando te conectas, 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 agregarlo

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. Agrega un nuevo conector con la URL https://mcp.twelvedata.com/mcp.
3. Cuando se te solicite, haz clic en Conectar / Iniciar sesión — se abre 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 difieren entre aplicaciones y versiones, pero el flujo es siempre el mismo: agrega la URL y luego inicia sesión mediante la ventana emergente del navegador.

El host MCP no emite tokens. La URL del conector es https://mcp.twelvedata.com/mcp. El cliente debe seguir los metadatos de recursos protegidos de esa URL hasta el servidor de autorización indicado allí. No apuntes un conector a la raíz del host (responde 404), ni a /register o /.well-known/oauth-authorization-server de este host.

Perplexity (conector remoto personalizado)

Los usuarios de Perplexity Pro, Max y Enterprise pueden agregar el servidor alojado como un conector remoto personalizado. Es una configuración por cuenta, no una lista en el directorio público curado de Perplexity.

1. En Perplexity, abre Configuración de cuenta → Conectores → + Conector personalizado y selecciona Remoto. En Enterprise, un administrador puede necesitar permitir conectores personalizados primero.
2. Establece Nombre como Twelve Data y URL del servidor MCP como https://mcp.twelvedata.com/mcp.
3. Elige OAuth para autenticación y HTTP transmisible para transporte. Deja el ID de cliente y el secreto de cliente en blanco para que Perplexity pueda usar el registro dinámico de clientes en el servidor de autorización indicado en los metadatos de recursos protegidos del servidor.
4. Acepta el reconocimiento de conector personalizado de Perplexity y haz clic en Agregar. Luego haz clic en la tarjeta del conector de Twelve Data para iniciar la autenticación, inicia sesión en tu cuenta de Twelve Data y autoriza el acceso.
5. Una vez que el conector esté habilitado, prueba estos mensajes:
   • "Usa Twelve Data para encontrar el símbolo de AAPL."
   • "Usa Twelve Data para obtener la cotización más reciente de AAPL, incluido precio y volumen."
   • "Usa Twelve Data para mostrar los últimos cinco precios de cierre diarios de AAPL."
   • "Usa Twelve Data para mostrar el RSI de AAPL."

Cada persona inicia sesión con su propia cuenta de Twelve Data. Si un administrador de Enterprise comparte el conector, exige autenticación individual para cada miembro. No pegues una clave API de Twelve Data en el campo de autenticación de clave API del conector.

Si la ventana de OAuth está bloqueada, el inicio de sesión falla o las herramientas se detienen después de un tiempo de inactividad, abre el conector de Twelve Data, desactívalo, actívalo nuevamente e inicia sesión. Reconéctate de esta manera en lugar de cambiar el conector a autenticación de clave API. Confirma que la URL sea exactamente https://mcp.twelvedata.com/mcp sin barra final y que el plan de Twelve Data incluya los datos solicitados. Consulta la guía de conectores remotos personalizados de Perplexity para ver las pantallas de configuración actuales.

Codex (CLI, escritorio e IDE)

Agrega el servidor MCP alojado a Codex sin instalar este repositorio ni copiar una clave API:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

El comando add inicia OAuth: completa el inicio de sesión de Twelve Data en tu navegador. Si necesitas autorizar nuevamente más tarde, ejecuta codex mcp login twelvedata. En Codex, usa /mcp para verificar la conexión y luego pregunta: "Usa Twelve Data para obtener la cotización más reciente de AAPL." y "Usa Twelve Data para mostrar el RSI de AAPL." Para desconectarte, ejecuta codex mcp remove twelvedata.

El repositorio público de complementos es https://github.com/MazeBraker/twelvedata-skills. Instala las habilidades y el mismo MCP alojado:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Opción 2 — Ejecútalo tú mismo con una clave API

¿Prefieres ejecutar el servidor en tu propia máquina? Solo necesitas tu clave API de Twelve Data — sin configuración de OAuth. Obténla en twelvedata.com → tu panel → Claves API.

1. Instalación

Requiere Python 3.10+ (se recomienda 3.12; en macOS brew install python@3.12 o make python-install).

make install

2. Agrega tu clave API

Crea un archivo .env en la raíz del proyecto con tu clave, legible solo por ti:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

El servidor lee la clave de .env y cada solicitud la usa. No se necesita paso de inicio de sesión.

3. Conéctate a través de stdio

Claude Desktop — agrega a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

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

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Conéctate a través de HTTP

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Ejecútalo en Docker

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file mantiene la clave fuera del historial de tu shell. Conéctate a http://localhost:8000/mcp como en el paso 4. El inicio de sesión OAuth no es compatible con Docker.

6. Seguridad

• make run y Docker sirven /mcp sin autenticación, en 0.0.0.0 de forma predeterminada.
• Cada llamada se sirve bajo tu credencial.
• Cualquiera que alcance el puerto puede llamar a auth_status y oauth_configure. Eso incluye una página web que abras, mediante rebinding de DNS, porque el enlace predeterminado no verifica ni el encabezado Host ni el Origin.
• MCP_HOST=127.0.0.1 make run mantiene el servidor local y activa la verificación de Host y Origin del SDK de MCP.
• Con MCP_HOST=127.0.0.1, ngrok solo funciona cuando se inicia con --host-header=rewrite.

7. Solución de problemas

Llama a auth_status desde tu cliente primero. Muestra si hay una clave API configurada, el token almacenado, el host detectado y la URI de redirección — generalmente es suficiente para ver qué falta.

---

Lo que puedes preguntar

• Precios — acciones, ETF, forex, criptomonedas, materias primas (tiempo real e histórico)
• Indicadores técnicos — RSI, MACD, SMA, BBANDS, ATR y más de 60 más
• Fundamentales — estados financieros, ganancias, dividendos, divisiones de acciones, perfiles de empresas, capitalización de mercado, estadísticas clave, calendario de OPI
• Fondos — perfiles de ETF y fondos mutuos, rendimiento, tenencias, riesgo
• Noticias — noticias de empresas y comunicados de prensa
• Inteligencia de mercado — valores destacados, tipos de cambio, calificaciones de analistas, objetivos de precio
• Regulatorio — presentaciones SEC/EDGAR, transacciones de información privilegiada, tenencias 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 socio — contáctanos en twelvedata.com y te proporcionaremos la guía de configuración y las credenciales OAuth.