ZPL Engine MCP

Servidor MCP de ZPL Engine

Servidor de Protocolo de Contexto de Modelo (MCP) para el Zero Point Logic Engine — un sistema de análisis de estabilidad y neutralidad post-binario.

Conecta cualquier cliente de IA compatible con MCP (Claude Desktop, Claude Code, Cursor, Windsurf, etc.) a la API de ZPL Engine para detección de sesgo en tiempo real, puntuación de estabilidad y análisis de neutralidad en múltiples dominios.

69 herramientas (65 únicas + 4 alias de compatibilidad inversa) en 11 categorías: Core, Finanzas, Gaming, IA/ML, Seguridad, Cripto, Certificación, Avanzado, Universal, Meta y Evaluación de IA.

Aspectos destacados de la línea 4.x

Para ver qué cambió en la versión que estás instalando, consulta CHANGELOG.md.

Dos meses de trabajo incremental consolidados. 21 errores corregidos, 308 pruebas (259 unitarias + 49 de integración MCP en vivo), Windows + Linux verificados. Compatibilidad inversa: las claves heredadas zpl_u_<48hex> siguen funcionando, las 69 herramientas mantienen la misma forma de entrada.

Nuevos comandos

• npx zpl-engine-mcp setup — ahora con memoria. Detecta la configuración existente y ofrece conservar / reconfigurar / parchear solo en lugar de forzar un inicio de sesión nuevo. --force lo omite.
• npx zpl-engine-mcp whoami — muestra en qué cuenta está registrada esta instalación.
• npx zpl-engine-mcp repair — borra la configuración local y elimina la entrada de cada configuración de cliente MCP (Claude Desktop, Cursor, Windsurf). Conserva las entradas no relacionadas. --yes omite la confirmación.
• npx zpl-engine-mcp --help / --version — indicadores de uso y versión estándar POSIX.
• Herramienta MCP zpl_diagnose — informe de salud completo (configuración + clave + motor + autenticación) para informes de incidencias.

Correcciones críticas

• La expresión regular de claves API ahora acepta claves emitidas por el asistente con prefijos de tipo (zpl_u_mcp_, zpl_u_cli_, zpl_u_default_). Antes de la 4.0, la instalación del asistente fallaba silenciosamente.
• Respuestas HTML de Cloudflare explicadas — mensajes de error accionables con ID de cf-ray en lugar de un 403 genérico.
• Prueba de humo al final de la configuración — detecta el retraso de replicación entre la aprobación del asistente y la aceptación del motor.
• Sanitizador de secretos en el historial — ya no filtra claves ZPL con prefijo de asistente ni tokens completos de Anthropic sk-ant-* (la expresión regular truncaba en el primer guion).
• Límites de seguridad en variables de entorno numéricas — ZPL_RATE_LIMIT limitado a [1, 600], ZPL_MAX_RETRIES a [0, 5].

Correcciones de herramientas

• zpl_simulate resultado 0/0 en entradas positivas (cambiado a distributionBias + cortocircuito de entrada idéntica).
• zpl_liquidity desalineación de tabla/veredicto (el veredicto ahora cita recuentos por grupo).
• zpl_quota detección automática de plan desde config.toml (env > config > "free").
• zpl_quota + zpl_alert precisión de estimación de tokens — 22 herramientas ahora persisten el tokens_used real en lugar de una heurística fija.
• El fragmento de zpl_teach hacía referencia a un nombre de paquete @zeropointlogic/engine-mcp nunca publicado.
• Entradas duplicadas de Claude Desktop se deduplican automáticamente en setup.
• Variable de entorno de código muerto LANGUAGE eliminada.

Consulta CHANGELOG para ver la lista completa con las justificaciones.

Novedades en v3.7.0

• El asistente de configuración configura automáticamente Cursor y Windsurf, no solo Claude Desktop. Cada ejecución parchea claude_desktop_config.json, ~/.cursor/mcp.json y ~/.codeium/windsurf/mcp_config.json en una sola pasada. Los clientes que no están instalados se omiten silenciosamente; cada parche está aislado para que un cliente faltante nunca bloquee a los demás. Los archivos de configuración preexistentes vacíos (comunes en el stub {"mcpServers":{}} de Cursor) ahora se manejan correctamente.

Novedades en v3.6.1

• Cuota del plan gratuito corregida — todos los documentos/copias ahora muestran 5,000 tokens/mes (antes decía erróneamente "500 tokens / ~14 días" en un borrador temprano de migración). El motor ya tenía 5,000; esta versión solo sincroniza el MCP. Consulta CHANGELOG.

Novedades en v3.6.0

• npx zpl-engine-mcp setup — asistente de flujo de dispositivo en un solo comando: abre el navegador, autentica con tu cuenta ZPL, crea una clave API por máquina y parchea automáticamente claude_desktop_config.json. Sin más copiar y pegar.
• Solo clave de usuario — se eliminó el respaldo ZPL_SERVICE_KEY. MCP requiere una clave de usuario zpl_u_... para que los límites del plan se apliquen por cuenta.

Novedades en v3.4.3

• Corrección de desarrollo local — con ZPL_ENGINE_ALLOW_INSECURE_LOCAL=1, localhost / 127.0.0.1 / ::1 se aceptan como nombres de host del motor (no solo producción). Úsalo con http://127.0.0.1:PORT para un motor local.
• Versión desde package.json — el campo version del MCP, la comprobación de actualizaciones y los pies de página de informes ya no codifican cadenas semver.
• npm test — pruebas de regresión para la validación de URL del motor (npm run build && node --test test/engine-url.test.mjs).

Novedades en v3.4.2

• Refuerzo de URL del motor — la lista de permitidos predeterminada es solo engine.zeropointlogic.io. Motores autoalojados: establece ZPL_ENGINE_HOST_ALLOWLIST=your.hostname. HTTP local: ZPL_ENGINE_ALLOW_INSECURE_LOCAL=1 solo con http://127.0.0.1. El ZPL_ENGINE_DISABLE_URL_GUARD=1 opcional desactiva las comprobaciones de nombre de host (no recomendado). Todas las llamadas fetch del motor usan redirect: "error" para que las redirecciones no puedan llevar tu token Bearer a un nuevo origen.

Novedades en v3.4.1

• v3.4.1 — Correcciones de errores: se corrigió la inversión de sesgo de zpl_consistency_test (las respuestas inconsistentes ahora bajan correctamente el AIN), el doble conteo del presupuesto de sesión en las herramientas de evaluación de Claude (reserva anticipada en lugar de incremento posterior), el cálculo de presupuesto de zpl_alert que decía silenciosamente "OK" siempre (ahora usa la misma estimación que zpl_quota), el desbordamiento de pila de zpl_validate_input en arreglos muy grandes (bucle de reducción en lugar de Math.min(...values)), la caché de comprobación de versión que ignoraba su propia ventana de 24 h (nombre de archivo corregido en lugar de sufijo PID), cadenas de versión obsoletas en la salida de zpl_account/zpl_report. La tienda ahora respeta ZPL_STORE_PATH (documentado) además del heredado ZPL_STORE_DIR. La exportación CSV ahora escapa comas/comillas incrustadas. El formato de clave API se valida en el cliente (fallo rápido ante errores evidentes de pegado, evita filtrar accidentalmente secretos no relacionados en el encabezado Authorization). Se eliminó una referencia interna a un método del motor de la salida de zpl_check_response. El zpl_sweep y el zpl_analyze principales ahora respetan el limitador de velocidad por minuto.
• v3.4.0 — 8 nuevas herramientas de Evaluación de IA (zpl_consistency_test, zpl_sycophancy_score, zpl_refusal_balance, zpl_language_equity, zpl_persona_drift, zpl_safety_boundary, zpl_hallucination_consistency, zpl_emotional_stability) que ejecutan indicaciones a través de Claude y puntúan las distribuciones de respuestas con el motor ZPL. Requiere una variable de entorno ANTHROPIC_API_KEY separada. Límite de presupuesto de sesión de 100 llamadas a Claude por proceso para evitar gastos accidentales. Actualización multilingüe de detección de propaganda para zpl_news_bias / zpl_review_bias: listas de palabras clave EN + RO + FR + DE + ES + IT con una penalización de uniformidad simétrica (los textos 100% solo positivos O 100% solo negativos activan la misma bonificación).
• v3.3.0 — Se agregaron 4 alias más claros con prefijo "balance": zpl_balance_check (= zpl_decide), zpl_balance_compare (= zpl_versus), zpl_balance_pair (= zpl_compare), zpl_balance_rank (= zpl_rank). Tanto los nombres antiguos como los nuevos funcionan; los antiguos reciben una nota de OBSOLETO en su descripción. Los usuarios existentes siguen funcionando sin cambios.
• v3.2.0 — 4 nuevas herramientas: zpl_about (información del proyecto, sin autenticación), zpl_quota (tokens restantes), zpl_score_only (JSON mínimo para CI/CD), zpl_validate_input (validación gratuita). Comprobación automática de actualizaciones, mensaje de registro más amigable, avisos claros en herramientas de hipótesis/sesgo, advertencias de tamaño de muestra RNG, y las herramientas de sesgo reformuladas como "equilibrio de lenguaje" en lugar de "falso/sesgado".
• v3.1.0 — Se agregó la variable de entorno ZPL_MODE (pure | coach). El modo puro oculta las puntuaciones AIN a la IA en las herramientas de evaluación de texto (zpl_check_response, zpl_news_bias, zpl_review_bias) para prevenir el sesgo de reactividad / efecto observador.
• v3.0.0 (RUPTURA) — Se eliminaron 5 herramientas que creaban riesgo de falsa autoridad: zpl_ask, zpl_certify, zpl_certificate, zpl_predict, zpl_auto_certify. El AIN es una medida de ESTABILIDAD únicamente — nunca una predicción o recomendación.

Configuración (gratis, 15 segundos)

Ejecuta esto en tu terminal — te autentica, crea una clave API y escribe tu configuración de Claude Desktop por ti:

npx zpl-engine-mcp@latest setup

El asistente:

1. Abrirá tu navegador para aprobar la CLI (regístrate si no tienes cuenta — gratis, 5,000 tokens/mes, sin tarjeta de crédito)
2. Guardará la clave en ~/.zpl/config.toml (chmod 600)
3. Parcheará la configuración MCP de cada cliente compatible que esté instalado:
   • Claude Desktop — claude_desktop_config.json
   • Cursor — ~/.cursor/mcp.json
   • Windsurf — ~/.codeium/windsurf/mcp_config.json
4. Imprimirá qué clientes se configuraron y cuáles reiniciar.

Eso es todo. Los clientes que no están instalados se omiten silenciosamente. Si usas un cliente que no detectamos automáticamente (Claude Code, VS Code, Zed, ...), el asistente imprime el fragmento JSON exacto para pegar en la configuración MCP de ese cliente.

{
  "mcpServers": {
    "zpl-engine": {
      "command": "npx",
      "args": ["-y", "zpl-engine-mcp@latest"],
      "env": {
        "ZPL_API_KEY": "zpl_u_YOUR_KEY_HERE",
        "ZPL_MODE": "pure"
      }
    }
  }
}

¿Qué es ZPL Engine?

El ZPL Engine calcula el AIN (Índice de Neutralidad de IA) — una medida matemática de cuán estable o sesgado es un sistema. Funciona en:

• Finanzas — estabilidad del mercado, sesgo de cartera, concentración de riesgo, pares forex, miedo y codicia
• Gaming — equilibrio económico, equidad de botín, emparejamiento, auditoría de gacha, equilibrio PvP
• IA/ML — equidad de modelos, sesgo de predicción, equilibrio de conjuntos de datos, pruebas de indicaciones, puntos de referencia
• Seguridad — distribución de vulnerabilidades, matriz de riesgos, puntuación de cumplimiento
• Cripto — concentración de ballenas, riesgo DeFi, análisis de liquidez, tokenómica
• Certificación — verificación de equilibrio de lenguaje en texto, equilibrio de debates, equilibrio de noticias, autenticidad de reseñas
• Universal — decisiones rápidas, comparación estructurada, clasificación AIN, verificación de equilibrio de respuestas

Un motor, múltiples dominios. El motor no sabe qué representan tus datos — los "lentes" de dominio traducen tus datos específicos al marco matemático universal.

Lectura de los números

• ain — devuelto por el motor en una escala 0.0 – 1.0 con 6 decimales. La salida legible de la herramienta lo muestra en una escala de 0 – 100 conservando sus decimales (93.24/100), nunca redondeado a un número entero. zpl_score_only devuelve el valor bruto del motor sin modificar.
• ain_status — calidad del equilibrio: CERTIFIED_NEUTRAL, HIGHLY_NEUTRAL, NEUTRAL, MODERATE_BIAS, SIGNIFICANT_BIAS, HIGH_BIAS.
• status — un campo diferente: el régimen de estabilidad, STABLE, ACTIVE, INHIBITED_HIGH, INHIBITED_LOW. No existe un valor INHIBITED simple. Los pasos de barrido llevan status, no ain_status.

Modos (ZPL_MODE)

ZPL Engine MCP admite dos modos para cómo se devuelven los resultados de evaluación de texto:

Por qué esto importa: la puntuación de estabilidad solo funciona si la medición no cambia lo que mide. Si una IA ve "AIN = 42" y luego escribe el siguiente párrafo, su lenguaje deriva naturalmente para justificar la puntuación. El modo puro rompe ese bucle de retroalimentación.

Configúralo mediante env: "ZPL_MODE": "pure" o "ZPL_MODE": "coach".

Instalación

Mediante npm (recomendado):

npm install zpl-engine-mcp

O clona y compila:

git clone https://github.com/cicicalex/zpl-engine-mcp.git
cd zpl-engine-mcp
npm install
npm run build

Configuraciones alternativas de cliente

CLI de Claude Code (.claude/settings.json)

{
  "mcpServers": {
    "zpl-engine": {
      "command": "npx",
      "args": ["-y", "zpl-engine-mcp@latest"],
      "env": {
        "ZPL_API_KEY": "zpl_u_YOUR_KEY_HERE",
        "ZPL_MODE": "pure"
      }
    }
  }
}

Compilación local

{
  "mcpServers": {
    "zpl-engine": {
      "command": "node",
      "args": ["/path/to/engine-mcp/dist/index.js"],
      "env": {
        "ZPL_API_KEY": "zpl_u_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor / Windsurf

Agrégalo a tu configuración de MCP siguiendo la documentación del IDE correspondiente, con la misma estructura de comando/argumentos/variables de entorno.

Categorías de herramientas (69 herramientas)

69 herramientas en 11 categorías: 65 nombres únicos más 4 alias de compatibilidad hacia atrás (los pares zpl_balance_*, que reutilizan el manejador de otra herramienta). Cada fila a continuación es un registro activo, por lo que la tabla suma el mismo total de 69.

Nuevo en v3.2: Herramientas Meta

Herramientas eliminadas en v3.0.0 (y por qué)

Ejemplos rápidos

> Analyze my crypto portfolio for balance: BTC 40%, ETH 25%, SOL 15%, AVAX 10%, DOT 10%

> Check if this loot table is fair: Common 60%, Uncommon 25%, Rare 10%, Legendary 5%

> Is my ML model output balanced? Class A: 1200 predictions, Class B: 300 predictions

> Check this AI response for language balance

> Compare React vs Vue across 5 criteria

Planes de precios

Todos los planes de pago ofrecen 20% de descuento con facturación anual.

Costo de tokens

El costo de tokens depende del nivel de dimensión:

Gestión de claves API

• Las claves se generan en zeropointlogic.io/dashboard/api-keys
• Formato: zpl_u_ + 48 caracteres hexadecimales (claves de usuario). v3.5.0+: el MCP solo acepta claves de usuario. Las claves de servicio (zpl_s_...) son solo de motor a motor — del lado del servidor, restringidas por IP, no utilizables en MCP.
• Las claves se procesan con hash SHA-256 del lado del servidor — el texto plano se muestra una vez al crearlas
• Para rotar una clave: crea una nueva clave, actualiza tu configuración de MCP, reinicia Claude y luego elimina la clave anterior
• Si una clave se ve comprometida, elimínala inmediatamente desde el panel — se invalida al instante

Variables de entorno

Arquitectura

Your AI Client (Claude, Cursor, etc.)
    |
    v (MCP Protocol — stdio)
ZPL Engine MCP Server (this package)
    |
    +-- Tool modules (data -> engine params)
    |   +-- finance, gaming, ai-ml, security, crypto
    |   +-- certification, advanced, universal, meta
    |
    v (HTTPS — Bearer auth)
ZPL Engine API (engine.zeropointlogic.io)
    |
    v (Post-binary computation)
    AIN Result (0.0-1.0, 6 decimals)

El servidor MCP nunca ve ni contiene la fórmula del motor. Envía (d, bias, samples) y recibe (ain, deviation, status). Todo el cálculo ocurre del lado del servidor.

Seguridad

• Todas las entradas se validan mediante esquemas Zod con límites estrictos de maxLength
• Las claves API nunca se registran ni se almacenan en texto plano localmente
• Lista de permitidos de URL del motor — las solicitudes solo van a engine.zeropointlogic.io a menos que agregues hosts con ZPL_ENGINE_HOST_ALLOWLIST. Rechaza información de usuario incrustada en ZPL_ENGINE_URL (usa variables de entorno para las claves). fetch(..., { redirect: "error" }) evita seguir redirecciones HTTP que podrían enviar tu token Bearer a otro lugar.
• Limitación de velocidad en memoria (configurable)
• Reintento con retroceso exponencial para fallos transitorios del motor (solo 5xx, no 4xx)
• Inicio rápido con fallo si ZPL_API_KEY no está definido (excepto para herramientas sin autenticación)
• El historial local sanitiza los prefijos de claves API antes de escribir

Protección de propiedad intelectual (v3.0.0+)

El método de cálculo del ZPL Engine es un secreto comercial de Zero Point Logic. Este MCP se ha reforzado para nunca exponerlo:

• Las salidas de las herramientas devuelven solo puntuación AIN + estado + tokens utilizados. No se exponen sesgo, desviación, salida p, dimensión ni valores de sincronización.
• El MCP nunca recibe ni procesa la fórmula del motor — envía (d, bias, samples) al servidor y recibe (ain, status) de vuelta.
• Todo el cálculo ocurre del lado del servidor en el motor propietario. El código del lado del cliente no contiene secretos algorítmicos.
• v3.0 eliminó herramientas que permitían presentar puntuaciones proporcionadas por el usuario como mediciones AIN oficiales (riesgo de autoridad falsa).

Licencia

MIT (cubre solo el código del cliente MCP). El algoritmo de cálculo del ZPL Engine, la fórmula AIN y el procesamiento del lado del servidor son secretos comerciales propietarios de Zero Point Logic y NO están cubiertos por esta licencia.

Editor

Zero Point Logic

Enlaces

• ZPL Engine — Sitio principal
• Finance Monitor — Análisis financiero en vivo
• Documentación de API — Referencia completa de la API
• Precios — Planes y claves API
• Registro Smithery — Descubrimiento de MCP

Consulta CHANGELOG.md para el historial completo de versiones.