@prereason/mcp 0.1.2 → 0.1.3

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

@@ -18,10 +18,10 @@ Add to your `claude_desktop_config.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"
+      }
     }
   }
 }
@@ -104,10 +104,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 +115,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
@@ -155,11 +155,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,6 +1,6 @@
 {
   "name": "@prereason/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Connect Claude Desktop to PreReason's Bitcoin & macro data API via MCP",
   "bin": {