Saltar al contenido principal
@kleros/agentkit es una herramienta de línea de comandos y un servidor MCP para leer datos de Kleros. Pueden usarla tanto agentes de IA como personas. Una sola interfaz cubre los tribunales, las disputas, las evidencias, las políticas de tribunales y de disputas y los stakes de los jurados en Kleros V1 y V2.
Versión actual: v0.3.0 (septiembre de 2026). La CLI es de solo lectura y anterior a la 1.0, por lo que sus comandos pueden cambiar entre versiones menores. Las operaciones de escritura (staking, votación, creación de disputas, envío de evidencias, apelaciones) todavía no están disponibles.

Qué puede hacer

  • Explorar tribunales, disputas y la actividad de los jurados
  • Resolver las políticas de los tribunales y de las disputas: las reglas que se pide aplicar a los jurados
  • Recorrer los envíos de evidencias, incluidos los adjuntos alojados en IPFS
  • Clasificar contratos arbitrables y obtener un resumen combinado de la disputa en una sola llamada
  • Clasificar a los jurados por PNK en staking
La salida usa por defecto TOON, un formato compacto que usa menos tokens que JSON. También hay salida en tabla y en JSON. Cada respuesta incluye un bloque cta que sugiere el siguiente comando lógico.

Cadenas compatibles

Un comando de listado ejecutado sin --chain recorre Ethereum, Gnosis y, después, Arbitrum One. V1 y V2 no entienden lo mismo por ruled, así que cada fila de dispute list incluye un marcador ruledSemantics. Usa dispute get cuando necesites un fallo leído en directo del contrato árbitro.
Actualización desde 0.2.x: la v0.3.0 introduce cambios incompatibles. Se retira el slug arbitrum-sepolia sin más: usa arbitrum-sepolia-testnet en su lugar. La variable de entorno correspondiente KLEROS_RPC_URL_ARBITRUM_SEPOLIA también cambia de nombre y falla sin avisar si se deja con el nombre antiguo.

Inicio rápido

Requiere Node.js 22 o posterior. Ejecútalo sin instalarlo:
O instálalo globalmente y usa el comando kleros:
Guarda una cadena predeterminada para no tener que pasar --chain cada vez:

Úsalo como servidor MCP

Registra la CLI como servidor de herramientas MCP para que los agentes de Claude Code, Cursor y otros clientes MCP puedan llamar directamente a las consultas de disputas:
Si la CLI está instalada globalmente, kleros mcp add la registra para Claude Code y Cursor. Los nombres de las herramientas siguen el patrón group_command, por ejemplo dispute_list, court_get y juror_info. Pasa un argumento chain en cualquier llamada a una herramienta para elegir la cadena de esa llamada. Para el descubrimiento por parte de los agentes, kleros --llms imprime un manifiesto compacto de los comandos y kleros --llms-full imprime los argumentos completos y los esquemas de salida. kleros skills add instala la skill de agente incluida.
Es una herramienta distinta del servidor MCP de la documentación. Ese servidor permite a un asistente buscar en esta documentación, mientras que la Kleros CLI lee datos del protocolo en directo.

Uso en producción

Los endpoints RPC predeterminados son públicos y gratuitos, y pueden limitar las solicitudes con tráfico real. Para un uso fiable, apunta las variables KLEROS_RPC_URL_<CHAIN> (por ejemplo, KLEROS_RPC_URL_ARBITRUM_ONE) a un proveedor de confianza. En Ethereum, usa un endpoint con capacidad de archivo, porque resolver las políticas antiguas requiere registros históricos.

Recursos

Paquete de npm

Versiones y README de @kleros/agentkit

Kleros Skills

Paquetes de conocimiento sobre Kleros legibles por agentes

Notifica un problema

Los comentarios van al repositorio público kleros-skills

Endpoints del subgraph

Las fuentes de datos que lee la CLI