@prereason/mcp 0.1.2 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.1.3 (2026-02-21)
+
+- Add `PREREASON_API_KEY` environment variable support (fixes Windows `cmd.exe` quoting crash)
+- Add `PREREASON_URL` environment variable for custom endpoint
+- Update all config examples to use `env` block (matches Stripe/Supabase pattern)
+- `--header` CLI args still supported for backward compatibility
+
 ## 0.1.2 (2026-02-21)
 
 - Fix Windows path resolution issue in Claude Desktop (rename `.mjs` → `.js` bin entry)

package/README.md

@@ -3,35 +3,41 @@
 [![npm version](https://img.shields.io/npm/v/@prereason/mcp.svg)](https://www.npmjs.com/package/@prereason/mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-MCP bridge for [PreReason](https://www.prereason.com) — connects Claude Desktop to PreReason's Bitcoin and macro data API.
+MCP server for [PreReason](https://www.prereason.com): pre-analyzed Bitcoin and macro financial intelligence.
 
-PreReason provides pre-computed context templates with market data, macro indicators, trend analysis, confidence scores, and causal reasoning for LLM agents.
+PreReason returns interpreted signals (bullish/bearish/neutral), trend analysis, regime classification, confidence scores, percentile rankings, and cross-asset correlations. Use it when your task needs market context for decision-making, not raw price feeds.
 
 ## Quick Start
 
+### Option 1: Direct HTTP (Claude Code, Cursor, Windsurf, etc.)
+
+Clients that support remote MCP servers can connect directly to `https://api.prereason.com/api/mcp` with no bridge package needed. See [Other MCP Clients](#other-mcp-clients) below.
+
+### Option 2: stdio bridge (Claude Desktop and other stdio-only clients)
+
 **Requires [Node.js 18+](https://nodejs.org)**
 
-Add to your `claude_desktop_config.json`:
+Add to your MCP client config (e.g. `claude_desktop_config.json`):
 
 ```json
 {
   "mcpServers": {
     "prereason": {
       "command": "npx",
-      "args": [
-        "-y", "@prereason/mcp",
-        "--header", "Authorization:Bearer YOUR_API_KEY"
-      ]
+      "args": ["-y", "@prereason/mcp"],
+      "env": {
+        "PREREASON_API_KEY": "YOUR_API_KEY"
+      }
     }
   }
 }
 ```
 
-Config file location:
+Claude Desktop config file location:
 - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
 
-Restart Claude Desktop after editing the config. PreReason should appear in your connectors list with 5 tools.
+Restart your MCP client after editing the config. PreReason should appear with 5 tools.
 
 ## Get an API Key
 
@@ -54,35 +60,35 @@ Restart Claude Desktop after editing the config. PreReason should appear in your
 ### Free (6 templates)
 | Template | Description |
 |----------|-------------|
-| `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 |
-| `correlation-check` | BTC correlation matrix vs macro indicators |
-| `btc-pulse` | Volume, fees, mempool analysis |
-| `grid-stress` | Epoch pace and difficulty adjustment forecast |
-
-### Basic — $19.99/mo (5 templates)
+| `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 templates)
 | Template | Description |
 |----------|-------------|
-| `btc-momentum` | Extended momentum with 90d trends and percentiles |
-| `liquidity-momentum` | Liquidity indicators with momentum analysis |
-| `on-chain-health` | Hash rate, difficulty, fees, mempool health |
-| `market-breadth` | Cross-asset breadth with SPY, DXY, VIX |
-| `miner-survival` | Hashprice thermometer with miner stress scoring |
+| `btc.momentum` | Extended momentum with 90d trends and 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 templates)
+### Pro - $49.99/mo (6 templates)
 | Template | Description |
 |----------|-------------|
-| `full-context` | Complete market intelligence with all metrics and analysis |
-| `factor-attribution` | Multi-factor attribution for BTC price movements |
-| `regime-check` | Market regime classification (risk-on/risk-off/transition) |
-| `fx-liquidity` | FX environment with DXY, treasury, and global liquidity |
-| `energy-cost` | Production cost model with gas input pressure |
-| `treasury-holdings` | Corporate Bitcoin treasury intelligence from SEC filings |
+| `btc.full` | Complete market intelligence with all metrics and analysis |
+| `btc.factors` | Multi-factor attribution for BTC price movements |
+| `cross.regime` | Market regime classification (risk-on/risk-off/transition) |
+| `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, ask Claude:
+Once connected, try prompts like:
 
 - "What's the current BTC regime?"
 - "Show me the macro snapshot"
@@ -104,10 +110,10 @@ Once connected, ask Claude:
 
 ### Windows: "'C:\Program' is not recognized"
 
-If Node.js is installed in a path with spaces (e.g. `C:\Program Files\nodejs\`), `npx` may fail inside Claude Desktop. Workaround:
+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. Install globally: `npm install -g @prereason/mcp`
-2. Use `node` command instead:
+1. Run: `npm install -g @prereason/mcp`
+2. Use this config (replace `YOUR_USER` with your Windows username):
 
 ```json
 {
@@ -115,16 +121,16 @@ If Node.js is installed in a path with spaces (e.g. `C:\Program Files\nodejs\`),
     "prereason": {
       "command": "node",
       "args": [
-        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js",
-        "--header", "Authorization:Bearer YOUR_API_KEY"
-      ]
+        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js"
+      ],
+      "env": {
+        "PREREASON_API_KEY": "YOUR_API_KEY"
+      }
     }
   }
 }
 ```
 
-Replace `YOUR_USER` with your Windows username.
-
 ### Auth errors on get_context / get_metric
 - `list_templates`, `list_metrics`, and `get_health` work without a key
 - `get_context` and `get_metric` require a valid API key
@@ -132,7 +138,7 @@ Replace `YOUR_USER` with your Windows username.
 
 ## Other MCP Clients
 
-Claude Code, Cursor, and Windsurf support remote HTTP servers directly — **no bridge package needed**:
+Clients that support remote HTTP servers (Claude Code, Cursor, Windsurf, and others) can connect directly without this bridge package:
 
 ```bash
 # Claude Code (CLI)
@@ -155,11 +161,14 @@ claude mcp add prereason --transport http https://api.prereason.com/api/mcp
 ## CLI Usage
 
 ```bash
-# Default URL (https://api.prereason.com/api/mcp)
+# 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
-npx @prereason/mcp https://custom-endpoint.com/mcp --header "Authorization:Bearer KEY"
+PREREASON_URL=https://custom.endpoint/mcp npx @prereason/mcp
 
 # Help
 npx @prereason/mcp --help

package/bin/cli.js

@@ -4,13 +4,17 @@
  *
  * Connects Claude Desktop (stdio) to PreReason's Streamable HTTP MCP endpoint.
  *
+ * Auth (preferred — works on all platforms):
+ *   Set PREREASON_API_KEY env var in your MCP client config.
+ *
  * Usage:
+ *   npx @prereason/mcp
  *   npx @prereason/mcp [--header Key:Value]...
  *   npx @prereason/mcp <URL> [--header Key:Value]...
  *
- * Examples:
- *   npx @prereason/mcp --header "Authorization:Bearer pr_live_..."
- *   npx @prereason/mcp https://api.prereason.com/api/mcp --header "Authorization:Bearer pr_live_..."
+ * Environment variables:
+ *   PREREASON_API_KEY   Your API key (adds Authorization: Bearer header)
+ *   PREREASON_URL       Override the default endpoint URL
  */
 
 import { createRequire } from 'node:module';
@@ -25,8 +29,11 @@ if (process.argv.includes('--help') || process.argv.includes('-h')) {
   const pkg = require('../package.json');
   process.stderr.write(`${pkg.name} v${pkg.version}\n\n`);
   process.stderr.write('Usage:\n');
-  process.stderr.write('  npx @prereason/mcp [--header Key:Value]...\n');
-  process.stderr.write('  npx @prereason/mcp <URL> [--header Key:Value]...\n\n');
+  process.stderr.write('  npx @prereason/mcp\n');
+  process.stderr.write('  npx @prereason/mcp [--header Key:Value]...\n\n');
+  process.stderr.write('Environment variables (recommended):\n');
+  process.stderr.write('  PREREASON_API_KEY    Your API key (adds Authorization: Bearer header)\n');
+  process.stderr.write('  PREREASON_URL        Override the default endpoint URL\n\n');
   process.stderr.write('Options:\n');
   process.stderr.write('  --header Key:Value   Add HTTP header (can be repeated)\n');
   process.stderr.write('  --help, -h           Show this help\n');
@@ -42,10 +49,15 @@ if (process.argv.includes('--version') || process.argv.includes('-v')) {
   process.exit(0);
 }
 
-// --- Parse CLI arguments ---
-let urlArg = DEFAULT_URL;
+// --- Read environment variables (preferred, avoids Windows cmd.exe quoting issues) ---
+let urlArg = process.env.PREREASON_URL || DEFAULT_URL;
 const headers = {};
 
+if (process.env.PREREASON_API_KEY) {
+  headers['Authorization'] = `Bearer ${process.env.PREREASON_API_KEY}`;
+}
+
+// --- Parse CLI arguments (override env vars) ---
 for (let i = 2; i < process.argv.length; i++) {
   if (process.argv[i] === '--header' && process.argv[i + 1]) {
     const val = process.argv[++i];

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@prereason/mcp",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "type": "module",
-  "description": "Connect Claude Desktop to PreReason's Bitcoin & macro data API via MCP",
+  "description": "MCP server for pre-analyzed Bitcoin and macro financial intelligence. Trend signals, regime classification, confidence scores, and 17 context templates.",
   "bin": {
     "prereason-mcp": "./bin/cli.js"
   },
@@ -26,7 +26,15 @@
     "macro",
     "prereason",
     "ai",
-    "llm"
+    "llm",
+    "finance",
+    "crypto",
+    "financial-data",
+    "liquidity",
+    "ai-agent",
+    "trading",
+    "market-data",
+    "context-protocol"
   ],
   "license": "MIT",
   "homepage": "https://www.prereason.com/docs#mcp",