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	Liquidity indicators with momentum analysis
btc.on-chain	Hash rate, difficulty, fees, mempool health
cross.breadth	Cross-asset breadth with SPY, DXY, VIX
btc.miner-survival	Hashprice thermometer with miner stress scoring

Pro - $49.99/mo (6 briefings)

Briefing	Description
btc.full	Complete market intelligence with all metrics and analysis
btc.factors	Multi-factor attribution for BTC price movements
cross.regime	Regime classification (risk-on/risk-off/transition) with USDT.D risk sentiment
fx.liquidity	FX environment with DXY, treasury, and global liquidity
btc.energy	Production cost model with gas input pressure
btc.treasury	Corporate Bitcoin treasury intelligence from SEC filings

Example Prompts

Once connected, try prompts like:

• "What's the current BTC regime?"
• "Show me the macro snapshot"
• "What does the full context briefing say about market conditions?"
• "Get the bitcoin price metric with trend analysis"
• "What's the hash ribbon signal right now?"
• "List available briefings"

Troubleshooting

"Server disconnected" error

• Ensure Node.js 18+ is installed: node --version
• Check your API key starts with pr_live_
• Fully quit Claude Desktop (system tray > Quit) and reopen

Tools not appearing

• Restart Claude Desktop after editing config
• Verify JSON syntax: node -e "JSON.parse(require('fs').readFileSync('path/to/config','utf8'))"

Windows: "'C:\Program' is not recognized"

If you still see this error, ensure you're using the env block (not --header args) as shown in Quick Start above. If the issue persists, install globally and use node:

1. Run: npm install -g @prereason/mcp
2. Use this config (replace YOUR_USER with your Windows username):

{
  "mcpServers": {
    "prereason": {
      "command": "node",
      "args": [
        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js"
      ],
      "env": {
        "PREREASON_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Auth errors on get_context / get_metric

• list_briefings, list_metrics, and get_health work without a key
• get_context and get_metric require a valid API key
• Get a free key at prereason.com/signup

Other MCP Clients

If your client supports remote HTTP servers, use Quick Start Option 1 above. The stdio bridge package is only needed for clients that require stdio transport (e.g. Claude Desktop).

CLI Usage

# Using environment variable (recommended)
PREREASON_API_KEY=pr_live_... npx @prereason/mcp

# Using --header flag (backward compatible)
npx @prereason/mcp --header "Authorization:Bearer YOUR_API_KEY"

# Custom URL
PREREASON_URL=https://custom.endpoint/mcp npx @prereason/mcp

# Help
npx @prereason/mcp --help

Links

• Documentation
• Sign Up
• API Discovery
• Terms of Service
• Privacy Policy

Privacy Policy

See prereason.com/privacy for data handling practices.

License

MIT