Renoun MCP

What 98lukehall/renoun-mcp MCP server does

The 98lukehall/renoun-mcp MCP server exposes ReNoUn’s structural analysis for crypto markets. Its primary result classifies market conditions as bounded, active, or unstable, and pairs that classification with an operational action: proceed, reduce, or avoid.

The service is intended for trading bots, autonomous agents, and quantitative systems that need a pre-trade risk check. It does not predict whether an asset will rise or fall. Instead, it evaluates whether the current market structure appears stable, changing, or fragmented.

Responses include a Dialectical Health Score from 0.0 to 1.0, an exposure scalar, an expected movement envelope, a constellation label, and a stability block. The stability block can include a half-life in minutes, a stability score, an instability level, a human-readable time horizon, and an urgency such as watch, prepare_exit, or exit_now.

How it works

ReNoUn analyzes OHLCV candle data through 17 channels grouped into Recurrence, Novelty, and Unity measurements. These channels consider characteristics such as repeated price or volume behavior, regime changes, volatility disruptions, trend cohesion, and structural alignment.

The resulting measurements contribute to the Dialectical Health Score and to one of eight named constellations. Examples include CLOSED_LOOP and HIGH_SYMMETRY for bounded conditions, CONVERGENCE and PATTERN_BREAK for active conditions, and SCATTERING or REPEATED_DISRUPTION for unstable conditions. Stability estimates use factors including score momentum, channel trends, novelty pressure, constellation persistence, and stabilizing or destabilizing sequences.

Setup and configuration

The 98lukehall/renoun-mcp MCP server’s documented HTTP API is hosted at https://web-production-817e2.up.railway.app. A client can request an agent key by sending an email and agent name to /v1/keys/provision. The response supplies a key with the rn_agent_ prefix. Requests to protected endpoints use that key as a bearer token.

The default agent tier includes 50 calls per day at no charge. Calls beyond that allowance cost $0.02 each. The README also describes a paid Pro tier with 1,000 daily free calls and included usage, but it does not provide MCP client configuration in the supplied excerpt.

Tools and capabilities

Documented API operations include:

• Querying live regime and stability data for a Binance symbol with GET /v1/regime/live/{symbol}.
• Submitting custom OHLCV klines to POST /v1/regime.
• Requesting multi-asset results and a portfolio aggregate through POST /v1/regime/batch, for up to 10 assets.
• Checking daily usage through GET /v1/usage.
• Registering and listing regime-change webhooks.
• Checking service liveness and version information through /v1/status.
• Viewing the interactive OpenAPI documentation at /docs.

Regime responses also provide machine-readable X-ReNoUn-* headers for the regime, action, stability score, half-life, urgency, and cache status.

Limitations and notes

The service is a structural risk gate, not a directional trading signal. The README reports 100% bounded-regime accuracy across more than 128 graded predictions, but also states that active regimes have lower accuracy and are intended for position scaling rather than full-size trades. Results should therefore be interpreted according to the returned action and exposure fields.

The supplied README excerpt begins an MCP section referring to Claude Desktop, but does not include the server command, package name, transport details, or client configuration. It therefore does not establish a directly executable local MCP installation method. The documented API is authenticated, rate-limited, and subject to the stated free-call and per-call pricing rules.