Kronos MCP

Pronósticos financieros multi-activo mediante micropagos x402 — 32 herramientas para criptomonedas, materias primas y acciones previas a la apertura del mercado

Ver en seshat.marketsPrueba este MCPPatrocinado

Documentación

Compila con Kronos

Usa la API gratuita para evaluar Kronos primero, luego permite que un agente pague por solicitud con x402. Kronos nunca crea, financia, recupera ni almacena una billetera de comprador — trae la tuya.

Comienza gratis

Descubre productos y prueba la salida BTC diferida sin cuenta, clave API ni billetera.

Pruébalo ahora

Gratis — catálogo y listado completo de productos

curl https://kronos.seshat.markets/api/feeds/kronos/catalog

Gratis — muestra BTC diferida (los 5 marcos temporales)

curl https://kronos.seshat.markets/api/feeds/kronos/sample/btc_usdt

curl https://kronos.seshat.markets/api/feeds/kronos/risk

Lee la especificación OpenAPI, el registro de agentes y la guía de inicio rápido para agentes para la referencia completa.

Cómo funciona x402

Tu agente solicita un endpoint de pago.
Kronos devuelve HTTP 402 con un requisito de pago firmado: precio, activo USDC, destino y red.
La billetera controlada por el comprador firma una autorización.
El cliente reintenta con el payload de pago y recibe el resultado.

No se requiere cuenta Kronos ni saldo Kronos prepagado. La billetera del comprador aún necesita suficiente USDC para los datos solicitados. Dependiendo del esquema de pago aceptado, el facilitador puede cubrir el gas de red; esto no cubre el precio de los datos.

Patrón SDK de Node / TypeScript

Usa una billetera de comprador que tú controles. La clave privada permanece en tu entorno de ejecución local y nunca debe ser confirmada, registrada ni pegada en un chat.

import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.BUYER_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:84532', client: new ExactEvmScheme(account) }],
});

const response = await fetchWithPayment(
  'https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt?timeframes=1h'
);
const forecast = await response.json();

Usa la red y el activo exactos anunciados en el desafío 402 en vivo. Nunca codifiques IDs de cadena ni direcciones de contrato — siempre léelos del requisito de pago devuelto por Kronos.

Python

Usa el SDK oficial de x402 para Python para el manejo automático de 402, o maneja el desafío manualmente con requests / httpx.

Con el SDK de x402 para Python (automático)

# pip install x402-requests
from x402.requests import wrap_requests_with_payment
import os

# Buyer wallet private key — keep secret, never commit
session = wrap_requests_with_payment(os.environ["BUYER_PRIVATE_KEY"])

response = session.get(
    "https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt",
    params={"timeframes": "1h"}
)
forecast = response.json()
print(forecast["consensus"]["direction"])  # "LONG" or "SHORT"

Manejo manual de 402 con requests

import requests

url = "https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt"
params = {"timeframes": "1h"}

# Step 1: request the endpoint — get 402 challenge
resp = requests.get(url, params=params)
if resp.status_code == 402:
    challenge = resp.json()
    # challenge contains: price, accepts (asset, network, scheme),
    # payTo (destination address), x402-version, etc.
    print(f"Payment required: {challenge['price']}")

    # Step 2: sign payment with your wallet (EVM or Solana)
    # Use web3.py (EVM) or solana.py (Solana) to sign
    payment_header = sign_payment(challenge)  # your signing logic

    # Step 3: retry with X-PAYMENT header
    resp = requests.get(url, params=params, headers={
        "X-PAYMENT": payment_header,
        "X-REQUEST-ID": resp.headers.get("X-REQUEST-ID", "")
    })

if resp.status_code == 200:
    forecast = resp.json()
    print(forecast["consensus"]["direction"])

curl — endpoint de pago de extremo a extremo

Flujo completo: solicitud inicial → desafío 402 → firmar pago → reintentar con el encabezado de pago.

# 1. Request the endpoint — receive 402 challenge
curl -s https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt?timeframes=1h \
  -D headers.txt -o challenge.json
# headers.txt contains X-REQUEST-ID, challenge.json has payment requirements

# 2. Sign payment (use x402 CLI, your wallet, or SDK)
#    This produces a base64-encoded payment header
PAYMENT=$(x402 sign --challenge challenge.json --key $BUYER_PRIVATE_KEY)
REQUEST_ID=$(grep -i X-REQUEST-ID headers.txt | awk '{print $2}' | tr -d '\r')

# 3. Retry with payment header
curl -s https://kronos.seshat.markets/api/feeds/kronos/predict/btc_usdt?timeframes=1h \
  -H "X-PAYMENT: $PAYMENT" \
  -H "X-REQUEST-ID: $REQUEST_ID" \
  -H "Content-Type: application/json" | jq .consensus.direction

Los endpoints gratuitos (catálogo, muestra, riesgo, vista previa de precisión, vista previa de régimen) no requieren pago — solo curl directamente.

Uso con MCP

No se requiere instalación local persistente ni servidor alojado por el usuario. Agrega la configuración a continuación y npx obtiene e inicia automáticamente el conector ligero kronos-mcp a través de stdio — no hay puerto, demonio ni infraestructura que el usuario deba mantener. Las herramientas gratuitas funcionan sin billetera: kronos_catalog, kronos_sample y kronos_risk. Las herramientas de pago pueden pagar automáticamente solo cuando el operador configura un firmante de comprador local.

{
  "mcpServers": {
    "kronos": {
      "command": "npx",
      "args": ["-y", "kronos-mcp"]
    }
  }
}

Para pagos x402 automatizados, establece una o ambas variables en el entorno del proceso MCP local: KRONOS_X402_EVM_PRIVATE_KEY para pagos EVM compatibles con Base y KRONOS_X402_SOLANA_PRIVATE_KEY para pagos de Solana. Estos son secretos del comprador; nunca se envían a Kronos como claves privadas.

Uso con A2A (Agente a Agente)

Kronos expone un endpoint A2A JSON-RPC 2.0 en POST https://kronos.seshat.markets/a2a. Cualquier agente compatible con A2A puede descubrir Kronos a través de a2aregistry.org o la tarjeta de agente e invocar pronósticos sin escribir código de integración REST personalizado.

Métodos compatibles

01 SendMessage / message/send

Envía un mensaje en lenguaje natural o estructurado. Kronos analiza la intención (endpoint + símbolo) y devuelve un Task con el pronóstico como un Artifact.

02 GetTask / tasks/get

Recupera el estado y los artefactos de una tarea creada previamente.

03 GetExtendedAgentCard

Devuelve la tarjeta de agente completa con habilidades, capacidades y configuración de pago.

Inicio rápido con curl

# Get the agent card
curl -X POST https://kronos.seshat.markets/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"GetExtendedAgentCard"}'

# Request a forecast (free endpoint example)
curl -X POST https://kronos.seshat.markets/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"Get risk state"}]}}}'

# Request a paid forecast (requires x402 payment)
curl -X POST https://kronos.seshat.markets/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"Predict BTC_USDT for next 24h"}]}}}'

Formato de respuesta

Las solicitudes exitosas devuelven un objeto Task con status.state = "completed" y el payload JSON de Kronos dentro de artifacts[0].parts[0].content:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "task": {
      "id": "uuid",
      "status": { "state": "completed" },
      "artifacts": [{
        "name": "kronos-risk",
        "parts": [{
          "kind": "data",
          "content": { /* Kronos JSON payload */ }
        }]
      }]
    }
  }
}

Pago para endpoints de pago

Cuando un mensaje se asigna a un endpoint de pago de Kronos (por ejemplo, predict, signals, accuracy), la tarea se devuelve con status.state = "auth-required" y la respuesta HTTP incluye los encabezados estándar payment-required y www-authenticate para x402. El llamador firma el pago USDC y reintenta con un encabezado payment-signature, que Kronos reenvía al endpoint subyacente.

Análisis de intención

Kronos extrae el endpoint y el símbolo del texto del mensaje. Ejemplos:

"Predict BTC_USDT for next 24h" → /api/feeds/kronos/predict/btc_usdt
"Get trading signals for ETH" → /api/feeds/kronos/agent/signals
"Get calibration metrics" → /api/feeds/kronos/accuracy
"Market regime detection" → /api/feeds/kronos/regime
JSON: {"endpoint":"predict","symbol":"sol_usdt"} → modo estructurado

Uso del SDK de A2A para Python

from a2a.sdk import A2AClient, Message, TextPart

client = A2AClient("https://kronos.seshat.markets/a2a")

# Get the agent card
card = await client.get_card()

# Send a forecast request
msg = Message(role="user", parts=[TextPart(text="Predict BTC_USDT for next 24h")])
response = await client.send_message(msg)

# Access the forecast artifact
task = response.task
if task.status.state == "completed":
    forecast = task.artifacts[0].parts[0].content
    print(forecast)

La tarjeta de agente se publica en /.well-known/agent.json.

Prepara una billetera de agente

Esta es una configuración operada por el comprador, no un servicio de Kronos. Usa una billetera o sistema de gestión de claves que ya controles.

01 Separa la billetera del agente

No des acceso a un agente autónomo a una billetera personal o de tesorería. Financia solo la cantidad que el operador esté dispuesto a permitir que el agente gaste.

02 Finánciala con el USDC aceptado

Kronos acepta USDC en Base y Solana — la red exacta está definida por el desafío 402 actual.

03 Mantén la clave local

Usa un almacén de secretos local o inyección de entorno. Nunca la confirmes, la agregues a archivos de configuración MCP rastreados por git, ni la proporciones al soporte de Kronos.

04 Prueba primero

Usa herramientas gratuitas antes de habilitar pagos automatizados.

Seguridad del agente

Revisa los precios de los endpoints en el catálogo antes de la automatización.
Usa una billetera dedicada y elige tú mismo su nivel de financiación; Kronos no impone un presupuesto diario restrictivo.
Ten en cuenta los límites de tasa de API existentes, especialmente para llamadas de playground de GPU.
Monitorea la actividad de la billetera del comprador de forma independiente y rota su clave si se sospecha compromiso.
Trata los pronósticos como señales de investigación, nunca como instrucciones de trading.

Reembolsos y disputas

Los pagos x402 son transferencias USDC en cadena liquidadas por el facilitador PayAI. Cada pago está vinculado a una solicitud específica a través del encabezado X-Request-Id reflejado en la respuesta.

Entrega exitosa: Si el endpoint devuelve HTTP 200 con datos válidos, el pago es definitivo. No hay reembolso para pronósticos que resulten incorrectos — Kronos proporciona señales de investigación, no garantías.
Fallo del manejador después del pago por adelantado: Si el endpoint devuelve HTTP 5xx después de que el pago se liquidó (flujo por adelantado), contacta al soporte con el X-Request-Id y el hash de transacción. Reembolsaremos el monto completo a la billetera del pagador dentro de 5 días hábiles.
Fallo de liquidación del facilitador: Si el facilitador PayAI no liquida, el cliente no es cobrado. La respuesta 402 incluye el motivo del fallo; no se necesita acción.
Cargos duplicados: Si el mismo hash de transacción se usa para múltiples solicitudes, nuestro sistema lo detecta y alerta al equipo. Contacta al soporte si crees que se te cobró dos veces por la misma solicitud.
Ventana de disputa: Las disputas deben presentarse dentro de los 30 días posteriores al pago. Incluye el X-Request-Id, hash de transacción y red (Solana o Base).

Los reembolsos son transferencias manuales en cadena. Kronos no puede revertir una transacción en cadena liquidada; en su lugar, enviamos una transferencia USDC equivalente de vuelta a la dirección del pagador.

Catálogo de errores

Cada respuesta de API usa códigos de estado HTTP estándar. Los cuerpos de error son JSON con error (código legible por máquina) y detail opcional (explicación legible por humanos).

Estado	Código de error	Cuándo	Cómo manejarlo
402	`payment_required`	Endpoint de pago solicitado sin pago válido. El cuerpo de la respuesta contiene el desafío x402: `price`, `accepts` (activo, red, esquema), `payTo` (destino), `x402-version`.	Analiza el desafío, firma un pago con tu billetera de comprador y reintenta la misma solicitud con los encabezados `X-PAYMENT` y `X-REQUEST-ID`. Usa `@x402/fetch` (JS) o `x402-requests` (Python) para automatizar esto.
429	`rate_limited`	Demasiadas solicitudes. Cada endpoint tiene su propio límite (ver tabla de límites de tasa). `detail` explica qué límite se alcanzó.	Retrocede y reintenta. El encabezado `Retry-After` (cuando está presente) indica segundos de espera. Para predict, usa respuestas en caché (omite `?refresh=true`) — el TTL de caché es de 5–15 min por marco temporal.
503	`kronos_disabled`	El servicio Kronos está deshabilitado en el servidor (`KRONOS_ENABLED=false`). Todos los endpoints de pago devuelven esto.	Reintenta más tarde. Este es un estado de configuración del servidor, no un error del cliente. Consulta /risk (gratis) para el estado operativo.
503	`forecast_unavailable`	No se pudo generar o recuperar un pronóstico. El símbolo puede no tener suficientes datos de velas en el exchange upstream.	Prueba con un símbolo diferente o espera a que el exchange upstream proporcione más datos. Los símbolos bajo demanda pueden necesitar que su primera predicción se active manualmente.
500	`kronos_error`	Error interno del servidor. Para endpoints de flujo de pago `upfront`, la respuesta incluye `retry_token` y `refund_reference`.	Si `retry_token` está presente, reintenta la misma solicitud con el encabezado `X-Retry-Token` (uso único, TTL de 1h). Si `refund_reference` está presente, contacta al soporte con ese hash de transacción para un reembolso.
404	`unknown_symbol`	El símbolo solicitado no está en el catálogo de Kronos y el descubrimiento bajo demanda falló (símbolo de Gate.io inválido o no compatible).	Consulta /catalog para símbolos compatibles. Para bajo demanda, asegúrate de que el símbolo exista en Gate.io.
400	`missing_text` / `missing_query` / `invalid_agent_id`	Parámetro requerido faltante o inválido. `detail` explica lo que se necesita.	Corrige los parámetros de la solicitud y reintenta. No se cobra ningún pago por errores 400.

Tokens de reintento (solo flujo por adelantado)

Cuando ocurre un error 5xx después de que se liquidó un pago upfront (predict, forecast-distribution, playground, market-brief, similar-markets, outcome-stats, behavioral-correlations, rationale-novelty), la respuesta incluye:

retry_token — token de uso único, TTL de 1h. Envía en el encabezado X-Retry-Token en tu próxima solicitud para omitir el pago.
refund_reference — hash de transacción en cadena del pago liquidado. Cítalo al solicitar un reembolso manual.

Para endpoints de flujo authorization (data/analysis), el pago solo se liquida en respuestas exitosas (2xx) — no se necesita reembolso en 5xx.

Páginas de referencia de API

Documentación detallada para cada endpoint y tema: