{
  "markdown": "<p align=\"center\">\n  <h1 align=\"center\">ReNoUn</h1>\n  <p align=\"center\"><strong>Structural Risk Telemetry for Crypto Markets</strong></p>\n  <p align=\"center\">\n    <a href=\"https://web-production-817e2.up.railway.app/v1/status\"><img src=\"https://img.shields.io/badge/API-live-brightgreen\" alt=\"API Live\"></a>\n    <a href=\"#accuracy\"><img src=\"https://img.shields.io/badge/bounded_accuracy-100%25-7C9A6E\" alt=\"100% bounded accuracy\"></a>\n    <a href=\"https://web-production-817e2.up.railway.app/docs\"><img src=\"https://img.shields.io/badge/docs-OpenAPI-orange\" alt=\"API Docs\"></a>\n    <a href=\"https://github.com/98lukehall/renoun-mcp/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"License\"></a>\n    <img src=\"https://img.shields.io/badge/patent_pending-%2363%2F923%2C592-lightgrey\" alt=\"Patent Pending #63/923,592\">\n  </p>\n</p>\n\nClassifies crypto market structural regimes — **bounded**, **active**, or **unstable** — with **100% bounded regime accuracy** (128+ graded predictions, zero false positives). Estimates **regime stability half-life**: how many minutes until the current structure is likely to transition. Every prediction is public, timestamped, and graded — no other crypto signal service does this.\n\nOne GET request. One action field. Pre-trade risk gate for trading bots, autonomous agents, and quant systems.\n\n## Quick Start\n\n### 1. Get a Key (Free, No Credit Card)\n\n```bash\ncurl -X POST https://web-production-817e2.up.railway.app/v1/keys/provision \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\", \"agent_name\": \"my-bot\"}'\n```\n\nReturns an `rn_agent_` key. 50 free calls/day. $0.02/call after that.\n\n### 2. Check a Regime\n\n```bash\ncurl https://web-production-817e2.up.railway.app/v1/regime/live/BTCUSDT \\\n  -H \"Authorization: Bearer rn_agent_YOUR_KEY\"\n```\n\n### 3. Read the Response\n\n```json\n{\n  \"regime\": \"bounded\",\n  \"action\": \"proceed\",\n  \"dhs\": 0.83,\n  \"exposure\": 0.95,\n  \"constellation\": \"HIGH_SYMMETRY\",\n  \"envelope_pct\": 1.5,\n  \"description\": \"Tight equilibrium, <1.5% move expected\",\n  \"action_detail\": \"Structure healthy. Position size: 95% of intended.\",\n  \"stability\": {\n    \"halflife_minutes\": 240,\n    \"stability_score\": 0.82,\n    \"instability_risk\": \"low\",\n    \"time_horizon\": \"2-4 hours\",\n    \"urgency\": \"none\"\n  },\n  \"_meta\": {\n    \"provider\": \"renoun\",\n    \"version\": \"1.4.0\",\n    \"accuracy\": \"100% bounded regime accuracy, 128+ graded\",\n    \"provision_url\": \"https://web-production-817e2.up.railway.app/v1/keys/provision\",\n    \"docs\": \"https://harrisoncollab.com\"\n  }\n}\n```\n\n### 4. Use It\n\n```python\nimport requests\n\ndef check_regime(symbol=\"BTCUSDT\", key=\"rn_agent_YOUR_KEY\"):\n    r = requests.get(\n        f\"https://web-production-817e2.up.railway.app/v1/regime/live/{symbol}\",\n        headers={\"Authorization\": f\"Bearer {key}\"}\n    )\n    return r.json()\n\nregime = check_regime(\"BTCUSDT\")\n\nif regime[\"action\"] == \"avoid\":\n    pass  # structure fragmenting — skip trade\nelif regime[\"stability\"][\"urgency\"] == \"exit_now\":\n    close_position()  # regime degrading fast\nelif regime[\"stability\"][\"urgency\"] == \"prepare_exit\":\n    set_tight_stop()  # regime softening\nelif regime[\"action\"] == \"reduce\":\n    execute(size=intended * regime[\"exposure\"])\nelse:\n    execute(size=intended)  # structure healthy, full size\n```\n\n## Regime Types\n\n| Regime | Action | What It Means |\n|--------|--------|---------------|\n| `bounded` | `proceed` | Price expected within envelope. Trade at full size. |\n| `active` | `reduce` | Dynamic conditions. Scale position by `exposure` scalar. |\n| `unstable` | `avoid` | Structure fragmenting. Skip this trade. |\n\n## Stability Half-Life\n\nEvery response includes a `stability` block estimating how long the current regime will persist.\n\n| Field | Meaning |\n|-------|---------|\n| `halflife_minutes` | Minutes until 50% probability of regime transition |\n| `stability_score` | 0.0–1.0 composite stability (1.0 = maximally stable) |\n| `instability_risk` | `low` / `moderate` / `elevated` / `high` |\n| `time_horizon` | Human-readable: \"2-4 hours\", \"15-30 minutes\", etc. |\n| `urgency` | `none` / `watch` / `prepare_exit` / `exit_now` |\n| `exit_window_minutes` | Safe exit window (only when urgency is `prepare_exit` or `exit_now`) |\n\nWithout half-life, an agent knows \"the regime is bounded, proceed.\" With half-life, the same agent knows \"the regime is bounded, proceed, AND this structure is likely stable for 4 hours.\" Or: \"the regime is active, reduce, AND exit within 15 minutes.\"\n\n## API Endpoints\n\nBase URL: `https://web-production-817e2.up.railway.app`\n\n| Endpoint | Method | Auth | Description |\n|----------|--------|------|-------------|\n| `/v1/regime/live/{symbol}` | GET | Bearer | Live regime + stability for a Binance symbol |\n| `/v1/regime` | POST | Bearer | Regime from your own OHLCV klines |\n| `/v1/regime/batch` | POST | Bearer | Multi-asset regime + portfolio aggregate (max 10) |\n| `/v1/keys/provision` | POST | None | Self-provision an API key |\n| `/v1/usage` | GET | Bearer | Today's call count, free vs billable |\n| `/v1/webhooks/register` | POST | Bearer | Register for regime change notifications |\n| `/v1/webhooks` | GET | Bearer | List registered webhooks |\n| `/v1/agents/leaderboard` | GET | None | Agent usage leaderboard |\n| `/v1/status` | GET | None | Liveness + version info |\n| `/docs` | GET | None | Interactive OpenAPI explorer |\n\n### Response Headers\n\nEvery regime response includes machine-readable headers:\n\n```\nX-ReNoUn-Regime: bounded\nX-ReNoUn-Action: proceed\nX-ReNoUn-Stability: 0.82\nX-ReNoUn-Halflife: 240\nX-ReNoUn-Urgency: none\nX-ReNoUn-Cache: HIT\nX-RateLimit-Remaining: 47\n```\n\n## Pricing\n\n| | Agent Tier (default) | Pro Tier |\n|---|------|------|\n| Daily free calls | 50 | 1,000 |\n| Price per call (beyond free) | $0.02 | Included |\n| Rate limit | 1,000/hr, 10,000/day | 1,000/hr |\n| Key prefix | `rn_agent_` | `rn_live_` |\n| Provisioning | Self-serve (POST) | [Subscribe via Stripe](https://harrisoncollab.com) |\n\nNo credit card required for the agent tier. Agents provision their own keys.\n\n## Accuracy\n\n**100% bounded regime accuracy** across 128+ graded predictions. When ReNoUn classifies a regime as bounded (proceed), price stays within the predicted envelope every time. Zero false positives. Every prediction is public, timestamped, and graded: [@98lukehall on X](https://x.com/98lukehall). No other crypto signal service publishes every call with a pass/fail grade.\n\nActive regimes (CONVERGENCE, PATTERN_BREAK) are graded against tighter thresholds and have lower accuracy — they recommend position scaling via the exposure scalar, not full-size trades.\n\n**What this means:** when ReNoUn says \"bounded,\" you can trade at full size with confidence. When it says \"active,\" scale your position by the exposure scalar. When it says \"unstable,\" stay out.\n\n**What this does NOT mean:** ReNoUn does not predict whether price goes up or down. It measures structural stability. Use it as a risk gate, not a signal.\n\n## How It Works\n\nReNoUn is a 17-channel structural analysis engine. It maps OHLCV candle data onto three measurement dimensions:\n\n**Recurrence (Re₁–Re₅)** — Is the market repeating known patterns? Price rhythms, volume profiles, volatility persistence, session structure, mean-reversion signatures.\n\n**Novelty (No₁–No₆)** — Is something genuinely new happening? Regime breaks, flow reversals, volatility spikes, session disruptions, behavioral shifts, cross-signal rarity.\n\n**Unity (Un₁–Un₆)** — Is the market holding together? Trend cohesion, volatility-price alignment, session continuity, reference-frame stability, structural symmetry.\n\nFrom these 17 signals the engine computes a **Dialectical Health Score** (DHS: 0.0–1.0) and detects **8 constellation patterns**:\n\n| Constellation | Regime | Description |\n|---------------|--------|-------------|\n| `CLOSED_LOOP` | bounded | Range-bound, <2% move expected |\n| `HIGH_SYMMETRY` | bounded | Tight equilibrium, <1.5% move expected |\n| `CONVERGENCE` | active | Trend-active, moves up to 2.5% |\n| `SURFACE_VARIATION` | bounded | Choppy but bounded, <2.5% net move |\n| `DIP_AND_RECOVERY` | active | Recovery regime, moves up to 2.5% |\n| `PATTERN_BREAK` | active | Regime shift underway, elevated range |\n| `SCATTERING` | unstable | Structure fragmenting, risk elevated |\n| `REPEATED_DISRUPTION` | unstable | Unstable regime, risk elevated |\n\nThe stability half-life is computed from DHS momentum, unity channel trends, novelty pressure, constellation persistence, and known destabilizing/stabilizing sequences.\n\n## Agent Discovery\n\nReNoUn is discoverable by AI agents through standard protocols:\n\n- **`llms.txt`** at [harrisoncollab.com/llms.txt](https://harrisoncollab.com/llms.txt)\n- **`.well-known/mcp.json`** at [harrisoncollab.com/.well-known/mcp.json](https://harrisoncollab.com/.well-known/mcp.json)\n- **`_meta` block** in every API response with provisioning URL and docs\n- **`X-Agent-Compatible: true`** header on every response\n\n### MCP Server (Claude Desktop / Claude Code)\n\n```json\n{\n  \"mcpServers\": {\n    \"renoun\": {\n      \"command\": \"python3\",\n      \"args\": [\"-m\", \"server\"],\n      \"env\": { \"RENOUN_API_KEY\": \"rn_agent_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n```bash\nclaude mcp add renoun python3 -m server\n```\n\n### System Prompt for Your Agent\n\n```\nBefore any crypto trade, check the structural regime:\n  GET /v1/regime/live/{SYMBOL}\nIf action is \"avoid\" — skip the trade (structure unstable).\nIf action is \"reduce\" — multiply position by the exposure scalar.\nIf urgency is \"exit_now\" — close position immediately.\nIf urgency is \"prepare_exit\" — set tight stop loss.\nIf action is \"proceed\" — execute at intended size.\nReNoUn classifies structural regimes with 100% bounded accuracy.\nIt does not predict price direction.\n```\n\n## Batch / Portfolio\n\nCheck multiple assets in one call with portfolio-level risk aggregation:\n\n```bash\ncurl -X POST https://web-production-817e2.up.railway.app/v1/regime/batch \\\n  -H \"Authorization: Bearer rn_agent_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbols\": [\"BTCUSDT\", \"ETHUSDT\", \"SOLUSDT\"], \"timeframe\": \"1h\"}'\n```\n\nReturns per-asset regimes plus `portfolio_action`, `portfolio_exposure`, and `unstable_count`.\n\n## Webhooks\n\nGet notified when regimes change:\n\n```bash\ncurl -X POST https://web-production-817e2.up.railway.app/v1/webhooks/register \\\n  -H \"Authorization: Bearer rn_agent_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://your-bot.com/webhook\",\n    \"symbols\": [\"BTCUSDT\"],\n    \"events\": [\"regime_change\"],\n    \"secret\": \"your_hmac_secret\"\n  }'\n```\n\nWebhook payloads are HMAC-signed. Max 5 webhooks per key.\n\n## Conversation Analysis\n\nReNoUn also analyzes turn-based conversations — detecting stuck loops, surface variation, convergence, and structural health. The conversation tools use the same 17-channel engine applied to speaker/text turns instead of OHLCV candles.\n\n| Tool | Purpose |\n|------|---------|\n| `renoun_analyze` | Full 17-channel structural analysis |\n| `renoun_health_check` | Quick triage — one score, one pattern |\n| `renoun_compare` | Structural A/B test between conversations |\n| `renoun_pattern_query` | Longitudinal session history |\n\nSee the [API docs](https://web-production-817e2.up.railway.app/docs) for conversation analysis endpoints.\n\n## Version\n\n- Server: 1.3.1\n- Engine: 4.1\n- Schema: 1.1\n- Protocol: MCP 2024-11-05\n\n## Patent Notice\n\nThe core computation engine is proprietary and patent-pending (#63/923,592). The MCP server wraps it as a black box — agents call the API and receive structured results.\n\n## License\n\nMCP server and API wrapper: MIT. Core engine: Proprietary.\n\n---\n\n<p align=\"center\">\n  <a href=\"https://harrisoncollab.com\">Harrison Collab</a> · <a href=\"https://web-production-817e2.up.railway.app/docs\">API Docs</a> · <a href=\"https://x.com/98lukehall\">Live Predictions on X</a>\n</p>\n",
  "bytes": 11862,
  "sha": "34f821a05bf158c2bcc628aae02878ed5439a39b2bbb966caa3966c9d8d98ed4",
  "repo_slug": "98lukehall/renoun-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_98lukehall_renoun_d3a89a49/readme"
}