Quick Start

Option 1: One-Click Connect (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot)

Clients that support MCP OAuth can connect with no API key setup required. Add the server URL and the client handles the rest - you'll be prompted to sign in or create a free account, and your API key is provisioned automatically.

{
  "mcpServers": {
    "prereason": {
      "type": "http",
      "url": "https://api.prereason.com/api/mcp"
    }
  }
}

No Authorization header needed - OAuth handles it.

Option 2: Direct HTTP with API Key (Claude Code, scripts, cron jobs)

For CLI tools or when you want to use an existing API key:

# Claude Code (CLI one-liner)
claude mcp add prereason --transport http https://api.prereason.com/api/mcp

Or with an explicit key in your MCP config:

{
  "mcpServers": {
    "prereason": {
      "type": "http",
      "url": "https://api.prereason.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Option 3: stdio bridge (Claude Desktop and other stdio-only clients)

Requires Node.js 18+

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "prereason": {
      "command": "npx",
      "args": ["-y", "@prereason/mcp"],
      "env": {
        "PREREASON_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart your MCP client after editing the config. PreReason should appear with 5 tools.

Get an API Key

1. Sign up at prereason.com/signup
2. Go to Dashboard > Settings > API Keys
3. Copy your key (starts with pr_live_)

5 MCP Tools

Tool	Auth	Description
list_briefings	Open	List all 17 pre-reasoned market briefings with tier requirements
list_metrics	Open	List all 30 available metrics across bitcoin, macro, and calculated categories
get_health	Open	API health check, version, account tier
get_context	Required	Fetch a pre-reasoned market briefing (markdown or JSON)
get_metric	Required	Fetch a single metric with trend/signal/percentile

17 Market Briefings

Free (6 briefings)

Briefing	Description
btc.quick-check	Minimal fast context: BTC + Net Liquidity + correlation
btc.context	BTC + liquidity + hash ribbon + difficulty + momentum
macro.snapshot	Fed balance, M2, treasury yields, VIX, net liquidity
cross.correlations	BTC correlation matrix vs macro indicators
btc.pulse	Volume, fees, mempool analysis
btc.grid-stress	Epoch pace and difficulty adjustment forecast

Basic - $19.99/mo (5 briefings)

Briefing	Description
btc.momentum	200D MA support/resistance with 7d/30d/90d momentum and YTD percentiles
macro.liquidity	Liquidi

... View full README on GitHub