ReNoUn MCP Server
Observabilidad estructural para conversaciones de IA. Detecta bucles, estados estancados y patrones de convergencia en 17 canales sin analizar contenido.
Documentación
ReNoUn
Telemetría de Riesgo Estructural para Mercados Cripto
Clasifica los regímenes estructurales del mercado cripto — acotado, activo o inestable — con 100% de precisión en regímenes acotados (128+ predicciones evaluadas, cero falsos positivos). Estima la vida media de estabilidad del régimen: cuántos minutos hasta que la estructura actual probablemente transicione. Cada predicción es pública, con marca de tiempo y evaluada — ningún otro servicio de señales cripto hace esto.
Una solicitud GET. Un campo de acción. Puerta de riesgo previa al trading para bots de trading, agentes autónomos y sistemas cuantitativos.
Inicio Rápido
1. Obtén una Clave (Gratis, Sin Tarjeta de Crédito)
curl -X POST https://web-production-817e2.up.railway.app/v1/keys/provision \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com", "agent_name": "my-bot"}'
Devuelve una clave rn_agent_. 50 llamadas gratis/día. $0.02/llamada después de eso.
2. Verifica un Régimen
curl https://web-production-817e2.up.railway.app/v1/regime/live/BTCUSDT \
-H "Authorization: Bearer rn_agent_YOUR_KEY"
3. Lee la Respuesta
{
"regime": "bounded",
"action": "proceed",
"dhs": 0.83,
"exposure": 0.95,
"constellation": "HIGH_SYMMETRY",
"envelope_pct": 1.5,
"description": "Tight equilibrium, <1.5% move expected",
"action_detail": "Structure healthy. Position size: 95% of intended.",
"stability": {
"halflife_minutes": 240,
"stability_score": 0.82,
"instability_risk": "low",
"time_horizon": "2-4 hours",
"urgency": "none"
},
"_meta": {
"provider": "renoun",
"version": "1.4.0",
"accuracy": "100% bounded regime accuracy, 128+ graded",
"provision_url": "https://web-production-817e2.up.railway.app/v1/keys/provision",
"docs": "https://harrisoncollab.com"
}
}
4. Úsalo
import requests
def check_regime(symbol="BTCUSDT", key="rn_agent_YOUR_KEY"):
r = requests.get(
f"https://web-production-817e2.up.railway.app/v1/regime/live/{symbol}",
headers={"Authorization": f"Bearer {key}"}
)
return r.json()
regime = check_regime("BTCUSDT")
if regime["action"] == "avoid":
pass # structure fragmenting — skip trade
elif regime["stability"]["urgency"] == "exit_now":
close_position() # regime degrading fast
elif regime["stability"]["urgency"] == "prepare_exit":
set_tight_stop() # regime softening
elif regime["action"] == "reduce":
execute(size=intended * regime["exposure"])
else:
execute(size=intended) # structure healthy, full size
Tipos de Régimen
| Régimen | Acción | Qué Significa |
|---|---|---|
bounded | proceed | Precio esperado dentro del envolvente. Opera a tamaño completo. |
active | reduce | Condiciones dinámicas. Escala la posición por el escalar exposure. |
unstable | avoid | Estructura fragmentándose. Omite esta operación. |
Vida Media de Estabilidad
Cada respuesta incluye un bloque stability que estima cuánto tiempo persistirá el régimen actual.
| Campo | Significado |
|---|---|
halflife_minutes | Minutos hasta 50% de probabilidad de transición de régimen |
stability_score | Estabilidad compuesta 0.0–1.0 (1.0 = máximamente estable) |
instability_risk | low / moderate / elevated / high |
time_horizon | Legible para humanos: "2-4 horas", "15-30 minutos", etc. |
urgency | none / watch / prepare_exit / exit_now |
exit_window_minutes | Ventana de salida segura (solo cuando la urgencia es prepare_exit o exit_now) |
Sin vida media, un agente sabe "el régimen está acotado, procede." Con vida media, el mismo agente sabe "el régimen está acotado, procede, Y esta estructura probablemente sea estable por 4 horas." O: "el régimen está activo, reduce, Y sal dentro de 15 minutos."
Endpoints de API
URL base: https://web-production-817e2.up.railway.app
| Endpoint | Método | Autenticación | Descripción |
|---|---|---|---|
/v1/regime/live/{symbol} | GET | Bearer | Régimen en vivo + estabilidad para un símbolo de Binance |
/v1/regime | POST | Bearer | Régimen desde tus propios klines OHLCV |
/v1/regime/batch | POST | Bearer | Régimen multi-activo + agregado de cartera (máx. 10) |
/v1/keys/provision | POST | Ninguna | Auto-aprovisiona una clave de API |
/v1/usage | GET | Bearer | Conteo de llamadas de hoy, gratis vs facturable |
/v1/webhooks/register | POST | Bearer | Regístrate para notificaciones de cambio de régimen |
/v1/webhooks | GET | Bearer | Lista webhooks registrados |
/v1/agents/leaderboard | GET | Ninguna | Tabla de clasificación de uso de agentes |
/v1/status | GET | Ninguna | Información de actividad + versión |
/docs | GET | Ninguna | Explorador OpenAPI interactivo |
Encabezados de Respuesta
Cada respuesta de régimen incluye encabezados legibles por máquina:
X-ReNoUn-Regime: bounded
X-ReNoUn-Action: proceed
X-ReNoUn-Stability: 0.82
X-ReNoUn-Halflife: 240
X-ReNoUn-Urgency: none
X-ReNoUn-Cache: HIT
X-RateLimit-Remaining: 47
Precios
| Nivel Agente (predeterminado) | Nivel Pro | |
|---|---|---|
| Llamadas gratis diarias | 50 | 1,000 |
| Precio por llamada (más allá de gratis) | $0.02 | Incluido |
| Límite de tasa | 1,000/hora, 10,000/día | 1,000/hora |
| Prefijo de clave | rn_agent_ | rn_live_ |
| Aprovisionamiento | Autoservicio (POST) | Suscríbete vía Stripe |
No se requiere tarjeta de crédito para el nivel agente. Los agentes aprovisionan sus propias claves.
Precisión
100% de precisión en regímenes acotados en 128+ predicciones evaluadas. Cuando ReNoUn clasifica un régimen como acotado (procede), el precio permanece dentro del envolvente predicho cada vez. Cero falsos positivos. Cada predicción es pública, con marca de tiempo y evaluada: @98lukehall en X. Ningún otro servicio de señales cripto publica cada llamada con una calificación de aprobado/reprobado.
Los regímenes activos (CONVERGENCIA, RUPTURA_DE_PATRÓN) se evalúan contra umbrales más estrictos y tienen menor precisión — recomiendan escalado de posición vía el escalar de exposición, no operaciones a tamaño completo.
Qué significa esto: cuando ReNoUn dice "acotado," puedes operar a tamaño completo con confianza. Cuando dice "activo," escala tu posición por el escalar de exposición. Cuando dice "inestable," mantente fuera.
Qué NO significa esto: ReNoUn no predice si el precio sube o baja. Mide estabilidad estructural. Úsalo como puerta de riesgo, no como señal.
Cómo Funciona
ReNoUn es un motor de análisis estructural de 17 canales. Mapea datos de velas OHLCV en tres dimensiones de medición:
Recurrencia (Re₁–Re₅) — ¿Está el mercado repitiendo patrones conocidos? Ritmos de precio, perfiles de volumen, persistencia de volatilidad, estructura de sesión, firmas de reversión a la media.
Novedad (No₁–No₆) — ¿Está sucediendo algo genuinamente nuevo? Rupturas de régimen, reversiones de flujo, picos de volatilidad, interrupciones de sesión, cambios de comportamiento, rareza entre señales.
Unidad (Un₁–Un₆) — ¿Se está manteniendo unido el mercado? Cohesión de tendencia, alineación volatilidad-precio, continuidad de sesión, estabilidad del marco de referencia, simetría estructural.
De estas 17 señales el motor calcula un Puntaje de Salud Dialéctica (DHS: 0.0–1.0) y detecta 8 patrones de constelación:
| Constelación | Régimen | Descripción |
|---|---|---|
CLOSED_LOOP | acotado | En rango, movimiento <2% esperado |
HIGH_SYMMETRY | acotado | Equilibrio ajustado, movimiento <1.5% esperado |
CONVERGENCE | activo | Tendencia activa, movimientos hasta 2.5% |
SURFACE_VARIATION | acotado | Volátil pero acotado, movimiento neto <2.5% |
DIP_AND_RECOVERY | activo | Régimen de recuperación, movimientos hasta 2.5% |
PATTERN_BREAK | activo | Cambio de régimen en curso, rango elevado |
SCATTERING | inestable | Estructura fragmentándose, riesgo elevado |
REPEATED_DISRUPTION | inestable | Régimen inestable, riesgo elevado |
La vida media de estabilidad se calcula a partir del impulso del DHS, tendencias del canal de unidad, presión de novedad, persistencia de constelación y secuencias conocidas desestabilizadoras/estabilizadoras.
Descubrimiento de Agentes
ReNoUn es descubrible por agentes de IA a través de protocolos estándar:
llms.txten harrisoncollab.com/llms.txt.well-known/mcp.jsonen harrisoncollab.com/.well-known/mcp.json- Bloque
_metaen cada respuesta de API con URL de aprovisionamiento y documentación - Encabezado
X-Agent-Compatible: trueen cada respuesta
Servidor MCP (Claude Desktop / Claude Code)
{
"mcpServers": {
"renoun": {
"command": "python3",
"args": ["-m", "server"],
"env": { "RENOUN_API_KEY": "rn_agent_YOUR_KEY" }
}
}
}
claude mcp add renoun python3 -m server
Prompt de Sistema para Tu Agente
Before any crypto trade, check the structural regime:
GET /v1/regime/live/{SYMBOL}
If action is "avoid" — skip the trade (structure unstable).
If action is "reduce" — multiply position by the exposure scalar.
If urgency is "exit_now" — close position immediately.
If urgency is "prepare_exit" — set tight stop loss.
If action is "proceed" — execute at intended size.
ReNoUn classifies structural regimes with 100% bounded accuracy.
It does not predict price direction.
Lote / Cartera
Verifica múltiples activos en una llamada con agregación de riesgo a nivel de cartera:
curl -X POST https://web-production-817e2.up.railway.app/v1/regime/batch \
-H "Authorization: Bearer rn_agent_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"symbols": ["BTCUSDT", "ETHUSDT", "SOLUSDT"], "timeframe": "1h"}'
Devuelve regímenes por activo más portfolio_action, portfolio_exposure y unstable_count.
Webhooks
Recibe notificaciones cuando cambian los regímenes:
curl -X POST https://web-production-817e2.up.railway.app/v1/webhooks/register \
-H "Authorization: Bearer rn_agent_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-bot.com/webhook",
"symbols": ["BTCUSDT"],
"events": ["regime_change"],
"secret": "your_hmac_secret"
}'
Los payloads de webhook están firmados con HMAC. Máx. 5 webhooks por clave.
Análisis de Conversación
ReNoUn también analiza conversaciones por turnos — detectando bucles atascados, variación superficial, convergencia y salud estructural. Las herramientas de conversación usan el mismo motor de 17 canales aplicado a turnos de hablante/texto en lugar de velas OHLCV.
| Herramienta | Propósito |
|---|---|
renoun_analyze | Análisis estructural completo de 17 canales |
renoun_health_check | Triage rápido — un puntaje, un patrón |
renoun_compare | Prueba estructural A/B entre conversaciones |
renoun_pattern_query | Historial de sesión longitudinal |
Consulta la documentación de API para endpoints de análisis de conversación.
Versión
- Servidor: 1.3.1
- Motor: 4.1
- Esquema: 1.1
- Protocolo: MCP 2024-11-05
Aviso de Patente
El motor de cómputo central es propietario y tiene patente pendiente (#63/923,592). El servidor MCP lo envuelve como una caja negra — los agentes llaman a la API y reciben resultados estructurados.
Licencia
Servidor MCP y envoltorio de API: MIT. Motor central: Propietario.
Harrison Collab · Documentación de API · Predicciones en Vivo en X