@prereason/mcp

MCP server for PreReason - the Context API for financial agents.

Give your agent market context, not raw price feeds. 17 briefings covering BTC, macro, cross-asset regimes, and liquidity - each with trend signals, confidence scores, and causal narratives.

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