@prereason/mcp 0.1.3 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +54 -45
  3. package/package.json +11 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.6 (2026-02-25)
4
+
5
+ - Fix description wording: replace "trend signals" with "trend interpretation"
6
+ - Add SECURITY.md with vulnerability reporting policy
7
+ - Add GitHub Actions CI workflow for provenance-signed npm publishing
8
+ - Public source repo at https://github.com/PreReason/mcp
9
+
3
10
  ## 0.1.3 (2026-02-21)
4
11
 
5
12
  - Add `PREREASON_API_KEY` environment variable support (fixes Windows `cmd.exe` quoting crash)
package/README.md CHANGED
@@ -3,15 +3,42 @@
3
3
  [![npm version](https://img.shields.io/npm/v/@prereason/mcp.svg)](https://www.npmjs.com/package/@prereason/mcp)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
5
5
 
6
- MCP bridge for [PreReason](https://www.prereason.com) — connects Claude Desktop to PreReason's Bitcoin and macro data API.
6
+ MCP server for [PreReason](https://www.prereason.com): pre-analyzed Bitcoin and macro financial intelligence.
7
7
 
8
- PreReason provides pre-computed context templates with market data, macro indicators, trend analysis, confidence scores, and causal reasoning for LLM agents.
8
+ PreReason returns pre-analyzed market context: trend interpretation, momentum analysis, cross-asset correlations, and more. Use it when your task needs to understand market conditions for decision-making, not raw price feeds.
9
9
 
10
10
  ## Quick Start
11
11
 
12
+ ### Option 1: Direct HTTP (Claude Code, Cursor, Windsurf, etc.)
13
+
14
+ Clients that support remote MCP servers can connect directly with no bridge package needed.
15
+
16
+ ```bash
17
+ # Claude Code (CLI one-liner)
18
+ claude mcp add prereason --transport http https://api.prereason.com/api/mcp
19
+ ```
20
+
21
+ Or add to `.mcp.json` / your client's MCP config:
22
+
23
+ ```json
24
+ {
25
+ "mcpServers": {
26
+ "prereason": {
27
+ "type": "http",
28
+ "url": "https://api.prereason.com/api/mcp",
29
+ "headers": {
30
+ "Authorization": "Bearer YOUR_API_KEY"
31
+ }
32
+ }
33
+ }
34
+ }
35
+ ```
36
+
37
+ ### Option 2: stdio bridge (Claude Desktop and other stdio-only clients)
38
+
12
39
  **Requires [Node.js 18+](https://nodejs.org)**
13
40
 
14
- Add to your `claude_desktop_config.json`:
41
+ Add to your MCP client config (e.g. `claude_desktop_config.json`):
15
42
 
16
43
  ```json
17
44
  {
@@ -27,11 +54,11 @@ Add to your `claude_desktop_config.json`:
27
54
  }
28
55
  ```
29
56
 
30
- Config file location:
57
+ Claude Desktop config file location:
31
58
  - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
32
59
  - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
33
60
 
34
- Restart Claude Desktop after editing the config. PreReason should appear in your connectors list with 5 tools.
61
+ Restart your MCP client after editing the config. PreReason should appear with 5 tools.
35
62
 
36
63
  ## Get an API Key
37
64
 
@@ -54,35 +81,35 @@ Restart Claude Desktop after editing the config. PreReason should appear in your
54
81
  ### Free (6 templates)
55
82
  | Template | Description |
56
83
  |----------|-------------|
57
- | `quick-check` | Minimal fast context: BTC + Net Liquidity + correlation |
58
- | `btc-context` | BTC + liquidity + hash ribbon + difficulty + momentum |
59
- | `macro-snapshot` | Fed balance, M2, treasury yields, VIX, net liquidity |
60
- | `correlation-check` | BTC correlation matrix vs macro indicators |
61
- | `btc-pulse` | Volume, fees, mempool analysis |
62
- | `grid-stress` | Epoch pace and difficulty adjustment forecast |
63
-
64
- ### Basic — $19.99/mo (5 templates)
84
+ | `btc.quick-check` | Minimal fast context: BTC + Net Liquidity + correlation |
85
+ | `btc.context` | BTC + liquidity + hash ribbon + difficulty + momentum |
86
+ | `macro.snapshot` | Fed balance, M2, treasury yields, VIX, net liquidity |
87
+ | `cross.correlations` | BTC correlation matrix vs macro indicators |
88
+ | `btc.pulse` | Volume, fees, mempool analysis |
89
+ | `btc.grid-stress` | Epoch pace and difficulty adjustment forecast |
90
+
91
+ ### Basic - $19.99/mo (5 templates)
65
92
  | Template | Description |
66
93
  |----------|-------------|
67
- | `btc-momentum` | Extended momentum with 90d trends and percentiles |
68
- | `liquidity-momentum` | Liquidity indicators with momentum analysis |
69
- | `on-chain-health` | Hash rate, difficulty, fees, mempool health |
70
- | `market-breadth` | Cross-asset breadth with SPY, DXY, VIX |
71
- | `miner-survival` | Hashprice thermometer with miner stress scoring |
94
+ | `btc.momentum` | Extended momentum with 90d trends and percentiles |
95
+ | `macro.liquidity` | Liquidity indicators with momentum analysis |
96
+ | `btc.on-chain` | Hash rate, difficulty, fees, mempool health |
97
+ | `cross.breadth` | Cross-asset breadth with SPY, DXY, VIX |
98
+ | `btc.miner-survival` | Hashprice thermometer with miner stress scoring |
72
99
 
73
- ### Pro — $49.99/mo (6 templates)
100
+ ### Pro - $49.99/mo (6 templates)
74
101
  | Template | Description |
75
102
  |----------|-------------|
76
- | `full-context` | Complete market intelligence with all metrics and analysis |
77
- | `factor-attribution` | Multi-factor attribution for BTC price movements |
78
- | `regime-check` | Market regime classification (risk-on/risk-off/transition) |
79
- | `fx-liquidity` | FX environment with DXY, treasury, and global liquidity |
80
- | `energy-cost` | Production cost model with gas input pressure |
81
- | `treasury-holdings` | Corporate Bitcoin treasury intelligence from SEC filings |
103
+ | `btc.full` | Complete market intelligence with all metrics and analysis |
104
+ | `btc.factors` | Multi-factor attribution for BTC price movements |
105
+ | `cross.regime` | Market regime classification (risk-on/risk-off/transition) |
106
+ | `fx.liquidity` | FX environment with DXY, treasury, and global liquidity |
107
+ | `btc.energy` | Production cost model with gas input pressure |
108
+ | `btc.treasury` | Corporate Bitcoin treasury intelligence from SEC filings |
82
109
 
83
110
  ## Example Prompts
84
111
 
85
- Once connected, ask Claude:
112
+ Once connected, try prompts like:
86
113
 
87
114
  - "What's the current BTC regime?"
88
115
  - "Show me the macro snapshot"
@@ -132,25 +159,7 @@ If you still see this error, ensure you're using the `env` block (not `--header`
132
159
 
133
160
  ## Other MCP Clients
134
161
 
135
- Claude Code, Cursor, and Windsurf support remote HTTP servers directly — **no bridge package needed**:
136
-
137
- ```bash
138
- # Claude Code (CLI)
139
- claude mcp add prereason --transport http https://api.prereason.com/api/mcp
140
-
141
- # Or add to .mcp.json
142
- {
143
- "mcpServers": {
144
- "prereason": {
145
- "type": "http",
146
- "url": "https://api.prereason.com/api/mcp",
147
- "headers": {
148
- "Authorization": "Bearer YOUR_API_KEY"
149
- }
150
- }
151
- }
152
- }
153
- ```
162
+ 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).
154
163
 
155
164
  ## CLI Usage
156
165
 
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@prereason/mcp",
3
- "version": "0.1.3",
3
+ "version": "0.1.6",
4
4
  "type": "module",
5
- "description": "Connect Claude Desktop to PreReason's Bitcoin & macro data API via MCP",
5
+ "description": "MCP server for pre-analyzed Bitcoin and macro financial intelligence. 17 context templates with trend interpretation, momentum analysis, and cross-asset correlations.",
6
6
  "bin": {
7
7
  "prereason-mcp": "./bin/cli.js"
8
8
  },
@@ -26,7 +26,15 @@
26
26
  "macro",
27
27
  "prereason",
28
28
  "ai",
29
- "llm"
29
+ "llm",
30
+ "finance",
31
+ "crypto",
32
+ "financial-data",
33
+ "liquidity",
34
+ "ai-agent",
35
+ "trading",
36
+ "market-data",
37
+ "context-protocol"
30
38
  ],
31
39
  "license": "MIT",
32
40
  "homepage": "https://www.prereason.com/docs#mcp",