# @prereason/mcp [![npm version](https://img.shields.io/npm/v/@prereason/mcp.svg)](https://www.npmjs.com/package/@prereason/mcp) [![npm downloads](https://img.shields.io/npm/dm/@prereason/mcp.svg)](https://www.npmjs.com/package/@prereason/mcp) [![node version](https://img.shields.io/node/v/@prereason/mcp.svg)](https://nodejs.org) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Glama Score](https://glama.ai/mcp/servers/PreReason/mcp/badges/score.svg)](https://glama.ai/mcp/servers/PreReason/mcp) **MCP server for [PreReason](https://www.prereason.com) - 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. ```json { "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: ```bash # 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: ```json { "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+](https://nodejs.org)** Add to your MCP client config (e.g. `claude_desktop_config.json`): ```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](https://www.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): ```json { "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](https://www.prereason.com/signup) ## Other MCP Clients If your client supports remote HTTP servers, use [Quick Start Option 1](#option-1-direct-http-claude-code-cursor-windsurf-etc) above. The stdio bridge package is only needed for clients that require stdio transport (e.g. Claude Desktop). ## CLI Usage ```bash # 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](https://www.prereason.com/docs#mcp) - [Sign Up](https://www.prereason.com/signup) - [API Discovery](https://www.prereason.com/.well-known/mcp/server.json) - [Terms of Service](https://www.prereason.com/terms) - [Privacy Policy](https://www.prereason.com/privacy) ## Privacy Policy See [prereason.com/privacy](https://www.prereason.com/privacy) for data handling practices. ## License MIT