@prereason/mcp 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.1.2 (2026-02-21)
+
+- Fix Windows path resolution issue in Claude Desktop (rename `.mjs` → `.js` bin entry)
+- Add Windows troubleshooting section in README
+
+## 0.1.1 (2026-02-21)
+
+- Add MIT LICENSE file
+- Enhance README with full template list, troubleshooting, and example prompts
+- Add CHANGELOG
+
+## 0.1.0 (2026-02-20)
+
+- Initial release
+- stdio-to-Streamable HTTP bridge for Claude Desktop
+- Default URL: `https://api.prereason.com/api/mcp`
+- `--header Key:Value` flag for API key authentication
+- `--help` and `--version` flags
+- 5 MCP tools: get_context, get_metric, list_templates, list_metrics, get_health

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PreReason
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,11 +1,16 @@
 # @prereason/mcp
 
-MCP bridge for [PreReason](https://www.prereason.com) — connects Claude Desktop to PreReason's Bitcoin & macro data API.
+[![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)
 
-PreReason provides pre-computed context templates with market data, macro indicators, trend analysis, and causal reasoning for LLM agents.
+MCP bridge for [PreReason](https://www.prereason.com) — connects Claude Desktop to PreReason's Bitcoin and macro data API.
+
+PreReason provides pre-computed context templates with market data, macro indicators, trend analysis, confidence scores, and causal reasoning for LLM agents.
 
 ## Quick Start
 
+**Requires [Node.js 18+](https://nodejs.org)**
+
 Add to your `claude_desktop_config.json`:
 
 ```json
@@ -26,25 +31,54 @@ 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.
+Restart Claude Desktop after editing the config. PreReason should appear in your connectors list with 5 tools.
 
 ## Get an API Key
 
-1. Sign up at [prereason.com](https://www.prereason.com)
+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_`)
 
-## What You Get
-
-5 MCP tools:
-
-| Tool | Description | Auth Required |
-|------|-------------|---------------|
-| `list_templates` | List all 17 context templates | No |
-| `list_metrics` | List all 26 available metrics | No |
-| `get_health` | API health check | No |
-| `get_context` | Fetch a context template | Yes |
-| `get_metric` | Fetch a single metric | Yes |
+## 5 MCP Tools
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_templates` | Open | List all 17 context templates with tier requirements |
+| `list_metrics` | Open | List all 26 available metrics (filterable by category) |
+| `get_health` | Open | API health check, version, account tier |
+| `get_context` | Required | Fetch a context template (markdown or JSON) |
+| `get_metric` | Required | Fetch a single metric with trend/signal/percentile |
+
+## 17 Context Templates
+
+### 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)
+| 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 |
+
+### 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 |
 
 ## Example Prompts
 
@@ -53,18 +87,92 @@ Once connected, ask Claude:
 - "What's the current BTC regime?"
 - "Show me the macro snapshot"
 - "What does the full context template say about market conditions?"
-- "List available prereason templates"
+- "Get the bitcoin price metric with trend analysis"
+- "What's the hash ribbon signal right now?"
+- "List available templates"
+
+## Troubleshooting
 
-## Claude Code / Cursor / Windsurf
+### "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
 
-These clients support remote HTTP MCP servers directly — no bridge needed:
+### 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 Node.js is installed in a path with spaces (e.g. `C:\Program Files\nodejs\`), `npx` may fail inside Claude Desktop. Workaround:
+
+1. Install globally: `npm install -g @prereason/mcp`
+2. Use `node` command instead:
+
+```json
+{
+  "mcpServers": {
+    "prereason": {
+      "command": "node",
+      "args": [
+        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js",
+        "--header", "Authorization:Bearer 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
+- Get a free key at [prereason.com/signup](https://www.prereason.com/signup)
+
+## Other MCP Clients
+
+Claude Code, Cursor, and Windsurf support remote HTTP servers directly — **no bridge package needed**:
+
+```bash
+# Claude Code (CLI)
 claude mcp add prereason --transport http https://api.prereason.com/api/mcp
+
+# Or add to .mcp.json
+{
+  "mcpServers": {
+    "prereason": {
+      "type": "http",
+      "url": "https://api.prereason.com/api/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## CLI Usage
+
+```bash
+# Default URL (https://api.prereason.com/api/mcp)
+npx @prereason/mcp --header "Authorization:Bearer YOUR_API_KEY"
+
+# Custom URL
+npx @prereason/mcp https://custom-endpoint.com/mcp --header "Authorization:Bearer KEY"
+
+# Help
+npx @prereason/mcp --help
 ```
 
 ## Links
 
 - [Documentation](https://www.prereason.com/docs#mcp)
-- [API Reference](https://api.prereason.com/.well-known/mcp/server.json)
-- [PreReason](https://www.prereason.com)
+- [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)
+
+## License
+
+MIT

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@prereason/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "Connect Claude Desktop to PreReason's Bitcoin & macro data API via MCP",
   "bin": {
-    "prereason-mcp": "./bin/cli.mjs"
+    "prereason-mcp": "./bin/cli.js"
   },
   "files": [
     "bin",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0"