npm package: @rvry/mcp
Description: RVRY reasoning depth enforcement (RDE) engine client.
Latest version: 0.12.2

# @rvry/mcp

**Reasoning Depth Enforcement for LLMs.**

RVRY is an MCP server that improves AI reliability by forcing your model to finish thinking before it answers. When your AI raises a question, RVRY remembers it. When it makes an assumption, RVRY flags it. When it tries to wrap up while those are still unaddressed, RVRY doesn't let it.

## Quick Start

```bash
npx --yes --package @rvry/mcp@latest rvry-mcp setup
```

The wizard will:
1. Open your browser to sign in (or prompt for a token)
2. Auto-detect supported clients on your machine
3. Configure them automatically

Supported clients: **Claude Code**, **Claude Desktop**, **Cursor**, **Gemini CLI**, **Codex**, **Anti-Gravity**

Restart any running clients after setup, and RVRY is ready.

### Manual Configuration

For any MCP client that supports **stdio transport** (runs a local process), add this to your MCP config:

```json
{
  "rvry": {
    "command": "npx",
    "args": ["--yes", "--package", "@rvry/mcp@latest", "rvry-mcp"],
    "env": {
      "RVRY_TOKEN": "your_rvry_token"
    }
  }
}
```

Get your token at [rvry.ai/dashboard](https://rvry.ai/dashboard) after signing up.

### HTTP Transport (Web-Based Clients)

For clients that connect via HTTP URL (ChatGPT, Perplexity, etc.):

**MCP Server URL:** `https://engine.rvry.ai/mcp`

Authentication is handled via OAuth — you'll be prompted to sign in with Google when you first connect. No token configuration needed.

### Compatibility

RVRY supports both **stdio** and **HTTP** transports:

| Transport | Client | Setup |
|-----------|--------|-------|
| stdio | Claude Code, Claude Desktop, Cursor, Gemini CLI, Codex, Anti-Gravity | `npx --yes --package @rvry/mcp@latest rvry-mcp setup` |
| stdio | Any client with `command` + `args` config | Manual JSON config (see above) |
| HTTP | ChatGPT (custom GPTs), Perplexity, any HTTP MCP client | URL: `https://engine.rvry.ai/mcp` |

## Tools

| Tool | What it does | Tier |
|------|-------------|------|
| **`RVRY_deepthink`** | Extended multi-round analysis. Catches assumptions, tests them, and doesn't let your AI wrap up until it's dealt with what it found. | All |
| **`RVRY_think`** | Lighter single-session analysis for questions that need structure but not the full deepthink loop. | All |
| **`RVRY_problem_solve`** | Structured decision-making. Forces orientation, anticipation, and evaluation before committing to a recommendation. | Pro+ |
| **`RVRY_challenge`** | Adversarial stress-testing. Finds weaknesses, tests assumptions, and surfaces failure modes in a proposal before you commit. | Pro+ |
| **`RVRY_meta`** | Sustained metacognitive observation. Examines how your AI is thinking, not just what it's thinking. | Max |

### Parameters

All tools accept:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Your question (new session) or analysis (continuation) |
| `sessionId` | string | No | Session ID for continuing an existing session |
| `requiresCurrentData` | boolean | No | Set to `true` when the question involves facts, policies, prices, or events that may have changed. Seeds a verification constraint that persists across all rounds. |
| `skipShimmer` | boolean | No | Set to `true` to skip the self-observation priming phase and go directly to analysis. Default `false`. Not available on `RVRY_meta`. |

**When to use `requiresCurrentData`:** Any question about regulations, pricing, legal rulings, market conditions, API specifications, or current events. The engine will require the model to explicitly classify every cited fact as either verified-current or training-data-dependent before concluding.

**When to use `skipShimmer`:** If you want to minimize round count and have a well-scoped, specific question, skipping shimmer removes one round of priming. For exploratory or open-ended questions, leave shimmer enabled — the self-observation priming improves cold-start depth.

**SHIMMER display:** When shimmer runs, the model displays `RVRY SHIMMER` with the revery definition before its self-observation. This is the priming phase — the model observes its own processing before structured analysis begins.

## Slash Commands (Claude Code)

When you run `npx --yes --package @rvry/mcp@latest rvry-mcp setup` and select Claude Code, the wizard installs 4 slash commands:

| Command | Tool | What it does |
|---------|------|-------------|
| `/deepthink` | RVRY_deepthink | Deep multi-round analysis |
| `/problem-solve` | RVRY_problem_solve | Structured decision-making |
| `/challenge` | RVRY_challenge | Adversarial stress-testing |
| `/meta` | RVRY_meta | Metacognitive observation |

Usage: type `/deepthink [your question]` in Claude Code. Each command routes to the corresponding RVRY MCP tool and includes rendering instructions so analysis appears as visible markdown rather than hidden in tool calls.

**Updating commands:** Existing slash command files are never overwritten. To get the latest specs, delete the old files in `~/.claude/commands/` and re-run setup.

`RVRY_think` is available as a tool, but the setup wizard does not install a `/think` slash command. Use it from clients that show the full MCP tool list or invoke it manually.

Commands are installed to `~/.claude/commands/`. Existing files are never overwritten — re-running setup is safe.

## How it Works

Same model. Same question. Different answer.

Your AI already has the reasoning capacity. RVRY forces it to use that capacity by holding it accountable — when it raises a question, that question has to get answered. When it makes an assumption, that assumption has to get tested. It keeps working not because it was told to think harder, but because it hasn't finished what it started.

On hard questions, a smaller model with RVRY outperforms a bigger model without it. The bottleneck was never how smart the AI is. It was whether the AI finished thinking.

[Learn more →](https://rvry.ai/how-it-works)

## Pricing

| Plan | Sessions | Tools | Price |
|------|----------|-------|-------|
| Free | 5/month | deepthink | $0 |
| Pro | 21/month | deepthink, problem_solve, challenge | $20/mo |
| Max | Unlimited | All tools including meta | $99/mo |

Sign up at [rvry.ai](https://rvry.ai).