Luzia Crypto API

@luziadev/mcp-server

Servidor del Model Context Protocol (MCP) para datos de precios de criptomonedas. Proporciona a asistentes de IA como Claude acceso en tiempo real a precios de tickers, información de intercambios e historial OHLCV desde la API de Luzia.

Características

• Precios de tickers en tiempo real de múltiples intercambios (Binance, Coinbase, Kraken, OKX, Bybit)
• Datos históricos de velas OHLCV para análisis técnico
• Información de mercado y pares de trading
• Estado y disponibilidad de los intercambios

Requisitos

• Una clave de API de Luzia (obtén una aquí)

Conexión remota (recomendada)

La forma más rápida de usar Luzia con tu asistente de IA es conectarte a nuestro servidor MCP alojado en https://mcp.luzia.dev/mcp. No requiere instalación. Solo pega la URL y tu clave de API.

Consola web de Claude.ai / Anthropic

Configuración → Integraciones → Añadir MCP personalizado:

• URL: https://mcp.luzia.dev/mcp
• Autenticación: Token Bearer — pega tu clave de API (lz_...)

Claude Desktop (vía mcp-remote)

El soporte nativo de MCP remoto de Claude Desktop aún se está implementando, por lo que la vía más fácil hoy es el shim mcp-remote, que conecta un MCP HTTP remoto con la interfaz stdio de Claude Desktop.

Edita tu configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.luzia.dev/mcp",
        "--header",
        "Authorization:Bearer lz_your_api_key"
      ]
    }
  }
}

Reinicia Claude Desktop (Cmd+Q en macOS) y comienza a hacer preguntas.

VS Code, Cursor, Cline, Continue.dev

Pega la URL y el encabezado de Autorización en la configuración de MCP de tu herramienta:

• URL: https://mcp.luzia.dev/mcp
• Encabezado: Authorization: Bearer lz_your_api_key

MCP Inspector

npx @modelcontextprotocol/inspector

Luego apunta el inspector a https://mcp.luzia.dev/mcp y añade el encabezado Authorization: Bearer lz_....

Instalación local (avanzado)

¿Prefieres ejecutar el servidor localmente? @luziadev/mcp-server todavía se distribuye en npm y funciona sobre stdio.

# Run directly with npx (no install needed)
LUZIA_API_KEY=lz_your_api_key npx -y @luziadev/mcp-server --stdio

Configuración de Claude Desktop (stdio local)

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Configuración de Claude Code (stdio local)

Añade a .claude/settings.json:

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Herramientas Disponibles

Herramienta	Descripción
get_ticker	Obtener el precio actual de un par de trading específico
get_tickers	Obtener precios de múltiples pares o de todos los pares en un intercambio
get_history	Obtener datos históricos de velas OHLCV para un par de trading
get_exchanges	Listar los intercambios admitidos (CEX y DEX) y su estado
get_markets	Listar pares de trading en un intercambio, incluidos los metadatos de pools DEX
get_tokens	Listar activos canónicos y tokens en cadena, con filtros de búsqueda y cadena
get_token	Buscar un token individual por id compuesto (crypto:SYMBOL o {chain}:SYMBOL)
get_fiat_currencies	Listar monedas fiduciarias ISO 4217 referenciadas por los mercados

Prompts Disponibles

Los prompts son plantillas de análisis predefinidas que obtienen datos y generan información estructurada. Están disponibles en clientes que admiten prompts de MCP (por ejemplo, Claude Desktop a través del menú /).

Nota: Claude Code no admite prompts de MCP directamente — usa lenguaje natural en su lugar (por ejemplo, "Analiza el movimiento de precios de BTC/USDT en Binance") y llamará automáticamente a las herramientas subyacentes.

Prompt	Descripción
analyze_price_movement	Analizar movimientos y tendencias de precios para un par de trading
analyze_ohlcv	Analizar datos de velas OHLCV con análisis técnico
compare_exchanges	Comparar precios entre intercambios para oportunidades de arbitraje

Ejemplos de Prompts

analyze_price_movement

Obtiene datos actuales de ticker y analiza el spread bid-ask, estadísticas de 24h y volumen.

Argumentos:

• exchange (obligatorio): p. ej., "binance", "coinbase"
• symbol (obligatorio): p. ej., "BTC/USDT", "ETH/USD"

Claude Desktop: Escribe / → selecciona analyze_price_movement → completa exchange: binance, symbol: BTC/USDT

Lenguaje natural (cualquier cliente): "Analiza el movimiento actual de precios de BTC/USDT en Binance"

analyze_ohlcv

Obtiene datos históricos de velas y solicita análisis técnico que incluye tendencias, soporte/resistencia, patrones de volumen y patrones de velas.

Argumentos:

• exchange (obligatorio): p. ej., "binance"
• symbol (obligatorio): p. ej., "BTC/USDT"
• interval (opcional): "1m", "5m", "15m", "1h", "1d" (por defecto: "1h")
• period (opcional): p. ej., "24h", "7d", "30d" (por defecto: "24h")

Claude Desktop: Escribe / → selecciona analyze_ohlcv → completa exchange: binance, symbol: BTC/USDT, interval: 1h

Lenguaje natural (cualquier cliente): "Analiza velas OHLCV de BTC/USDT en Binance con intervalo de 1h durante los últimos 7 días"

compare_exchanges

Obtiene datos de ticker de múltiples intercambios y compara precios, spreads y liquidez para análisis de arbitraje.

Argumentos:

• symbol (obligatorio): p. ej., "BTC/USDT"
• exchanges (opcional): lista separada por comas, p. ej., "binance,coinbase,kraken" (por defecto: "binance,coinbase,kraken")

Claude Desktop: Escribe / → selecciona compare_exchanges → completa symbol: BTC/USDT

Lenguaje natural (cualquier cliente): "Compara precios de BTC/USDT en todos los intercambios"

Límites de Tasa

Hereda de tu nivel de suscripción de Luzia:

• Gratis: 25 solicitudes/minuto, 1,000/día
• Pro: 1,000 solicitudes/minuto, 20,000/día

Solución de Problemas

Errores de "No autorizado"

• Remoto: verifica que tu encabezado Authorization: Bearer lz_... esté configurado y que la clave comience con lz_.
• Stdio: verifica que LUZIA_API_KEY esté configurado en la configuración de tu cliente MCP y que la clave no haya sido revocada.

Errores de sesión remota

• Si tu cliente informa "Unknown session id", el servidor se reinició o tu sesión expiró (30 min de inactividad). Reconéctate y el cliente se reinicializará automáticamente.

Claude Desktop no puede encontrar el servidor (stdio)

• Verifica que claude_desktop_config.json sea JSON válido.
• Asegúrate de que Node.js 20+ esté instalado (node --version).
• Reinicia Claude Desktop por completo (Cmd+Q en macOS).

Licencia

MIT - consulta LICENSE para más detalles.