ReNoUn MCP Server
Observabilidade estrutural para conversas de IA. Detecta loops, estados travados e padrões de convergência em 17 canais sem analisar conteúdo.
Documentação
ReNoUn
Telemetria de Risco Estrutural para Mercados de Criptomoedas
Classifica regimes estruturais do mercado de criptomoedas — limitado, ativo ou instável — com 100% de precisão em regimes limitados (128+ previsões avaliadas, zero falsos positivos). Estima a meia-vida de estabilidade do regime: quantos minutos até a estrutura atual provavelmente transicionar. Cada previsão é pública, carimbada com data/hora e avaliada — nenhum outro serviço de sinais de criptomoedas faz isso.
Uma requisição GET. Um campo de ação. Portão de risco pré-negociação para bots de trading, agentes autônomos e sistemas quantitativos.
Início Rápido
1. Obtenha uma Chave (Grátis, Sem Cartão 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"}'
Retorna uma chave rn_agent_. 50 chamadas grátis/dia. $0,02/chamada após isso.
2. Verifique um Regime
curl https://web-production-817e2.up.railway.app/v1/regime/live/BTCUSDT \
-H "Authorization: Bearer rn_agent_YOUR_KEY"
3. Leia a Resposta
{
"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. Use
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 Regime
| Regime | Ação | O Que Significa |
|---|---|---|
bounded | proceed | Preço esperado dentro do envelope. Negocie com tamanho total. |
active | reduce | Condições dinâmicas. Dimensione a posição pelo escalar exposure. |
unstable | avoid | Estrutura fragmentando. Pule esta negociação. |
Meia-Vida de Estabilidade
Cada resposta inclui um bloco stability estimando por quanto tempo o regime atual persistirá.
| Campo | Significado |
|---|---|
halflife_minutes | Minutos até 50% de probabilidade de transição de regime |
stability_score | Estabilidade composta 0,0–1,0 (1,0 = maximamente estável) |
instability_risk | low / moderate / elevated / high |
time_horizon | Legível para humanos: "2-4 horas", "15-30 minutos", etc. |
urgency | none / watch / prepare_exit / exit_now |
exit_window_minutes | Janela de saída segura (somente quando a urgência é prepare_exit ou exit_now) |
Sem a meia-vida, um agente sabe "o regime é limitado, prossiga." Com a meia-vida, o mesmo agente sabe "o regime é limitado, prossiga, E esta estrutura provavelmente está estável por 4 horas." Ou: "o regime é ativo, reduza, E saia dentro de 15 minutos."
Endpoints da API
URL Base: https://web-production-817e2.up.railway.app
| Endpoint | Método | Autenticação | Descrição |
|---|---|---|---|
/v1/regime/live/{symbol} | GET | Bearer | Regime ao vivo + estabilidade para um símbolo Binance |
/v1/regime | POST | Bearer | Regime a partir de seus próprios candles OHLCV |
/v1/regime/batch | POST | Bearer | Regime multi-ativo + agregado de portfólio (máx. 10) |
/v1/keys/provision | POST | Nenhum | Auto-provisionamento de chave de API |
/v1/usage | GET | Bearer | Contagem de chamadas de hoje, grátis vs. cobráveis |
/v1/webhooks/register | POST | Bearer | Registrar para notificações de mudança de regime |
/v1/webhooks | GET | Bearer | Listar webhooks registrados |
/v1/agents/leaderboard | GET | Nenhum | Ranking de uso de agentes |
/v1/status | GET | Nenhum | Informações de atividade + versão |
/docs | GET | Nenhum | Explorador OpenAPI interativo |
Cabeçalhos de Resposta
Cada resposta de regime inclui cabeçalhos legíveis 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
Preços
| Nível Agente (padrão) | Nível Pro | |
|---|---|---|
| Chamadas grátis diárias | 50 | 1.000 |
| Preço por chamada (além do grátis) | $0,02 | Incluído |
| Limite de taxa | 1.000/hora, 10.000/dia | 1.000/hora |
| Prefixo da chave | rn_agent_ | rn_live_ |
| Provisionamento | Autoatendimento (POST) | Assine via Stripe |
Sem cartão de crédito necessário para o nível agente. Agentes provisionam suas próprias chaves.
Precisão
100% de precisão em regimes limitados em 128+ previsões avaliadas. Quando o ReNoUn classifica um regime como limitado (prossiga), o preço permanece dentro do envelope previsto todas as vezes. Zero falsos positivos. Cada previsão é pública, carimbada com data/hora e avaliada: @98lukehall no X. Nenhum outro serviço de sinais de criptomoedas publica cada chamada com uma nota de aprovado/reprovado.
Regimes ativos (CONVERGENCE, PATTERN_BREAK) são avaliados contra limites mais rígidos e têm menor precisão — eles recomendam dimensionamento de posição via o escalar de exposição, não negociações de tamanho total.
O que isso significa: quando o ReNoUn diz "limitado," você pode negociar com tamanho total com confiança. Quando diz "ativo," dimensione sua posição pelo escalar de exposição. Quando diz "instável," fique de fora.
O que isso NÃO significa: o ReNoUn não prevê se o preço sobe ou desce. Ele mede estabilidade estrutural. Use-o como um portão de risco, não como um sinal.
Como Funciona
O ReNoUn é um motor de análise estrutural de 17 canais. Ele mapeia dados de candles OHLCV em três dimensões de medição:
Recorrência (Re₁–Re₅) — O mercado está repetindo padrões conhecidos? Ritmos de preço, perfis de volume, persistência de volatilidade, estrutura de sessão, assinaturas de reversão à média.
Novidade (No₁–No₆) — Algo genuinamente novo está acontecendo? Quebras de regime, reversões de fluxo, picos de volatilidade, interrupções de sessão, mudanças comportamentais, raridade de sinais cruzados.
Unidade (Un₁–Un₆) — O mercado está se mantendo coeso? Coesão de tendência, alinhamento volatilidade-preço, continuidade de sessão, estabilidade de referencial, simetria estrutural.
A partir desses 17 sinais, o motor calcula um Índice de Saúde Dialética (DHS: 0,0–1,0) e detecta 8 padrões de constelação:
| Constelação | Regime | Descrição |
|---|---|---|
CLOSED_LOOP | limitado | Em faixa, movimento <2% esperado |
HIGH_SYMMETRY | limitado | Equilíbrio apertado, movimento <1,5% esperado |
CONVERGENCE | ativo | Tendência ativa, movimentos até 2,5% |
SURFACE_VARIATION | limitado | Oscilante mas limitado, movimento líquido <2,5% |
DIP_AND_RECOVERY | ativo | Regime de recuperação, movimentos até 2,5% |
PATTERN_BREAK | ativo | Mudança de regime em andamento, faixa elevada |
SCATTERING | instável | Estrutura fragmentando, risco elevado |
REPEATED_DISRUPTION | instável | Regime instável, risco elevado |
A meia-vida de estabilidade é calculada a partir do momentum do DHS, tendências do canal de unidade, pressão de novidade, persistência da constelação e sequências conhecidas de desestabilização/estabilização.
Descoberta por Agentes
O ReNoUn é descoberto por agentes de IA através de protocolos padrão:
llms.txtem harrisoncollab.com/llms.txt.well-known/mcp.jsonem harrisoncollab.com/.well-known/mcp.json- Bloco
_metaem cada resposta da API com URL de provisionamento e documentação - Cabeçalho
X-Agent-Compatible: trueem cada resposta
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 Seu 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 / Portfólio
Verifique múltiplos ativos em uma única chamada com agregação de risco em nível de portfólio:
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"}'
Retorna regimes por ativo mais portfolio_action, portfolio_exposure e unstable_count.
Webhooks
Seja notificado quando os regimes mudarem:
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"
}'
Os payloads dos webhooks são assinados com HMAC. Máximo de 5 webhooks por chave.
Análise de Conversas
O ReNoUn também analisa conversas baseadas em turnos — detectando loops travados, variação de superfície, convergência e saúde estrutural. As ferramentas de conversação usam o mesmo motor de 17 canais aplicado a turnos de falante/texto em vez de candles OHLCV.
| Ferramenta | Propósito |
|---|---|
renoun_analyze | Análise estrutural completa de 17 canais |
renoun_health_check | Triagem rápida — uma pontuação, um padrão |
renoun_compare | Teste A/B estrutural entre conversas |
renoun_pattern_query | Histórico longitudinal de sessão |
Consulte a documentação da API para endpoints de análise de conversas.
Versão
- Servidor: 1.3.1
- Motor: 4.1
- Esquema: 1.1
- Protocolo: MCP 2024-11-05
Aviso de Patente
O motor de computação central é proprietário e com pedido de patente pendente (#63/923,592). O servidor MCP o envolve como uma caixa preta — agentes chamam a API e recebem resultados estruturados.
Licença
Servidor MCP e wrapper da API: MIT. Motor central: Proprietário.
Harrison Collab · Documentação da API · Previsões ao Vivo no X