@prereason/mcp 0.1.3 → 0.1.5

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 (2) hide show
  1. package/README.md +33 -27
  2. package/package.json +11 -3
package/README.md CHANGED
@@ -3,15 +3,21 @@
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 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.
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 to `https://api.prereason.com/api/mcp` with no bridge package needed. See [Other MCP Clients](#other-mcp-clients) below.
15
+
16
+ ### Option 2: stdio bridge (Claude Desktop and other stdio-only clients)
17
+
12
18
  **Requires [Node.js 18+](https://nodejs.org)**
13
19
 
14
- Add to your `claude_desktop_config.json`:
20
+ Add to your MCP client config (e.g. `claude_desktop_config.json`):
15
21
 
16
22
  ```json
17
23
  {
@@ -27,11 +33,11 @@ Add to your `claude_desktop_config.json`:
27
33
  }
28
34
  ```
29
35
 
30
- Config file location:
36
+ Claude Desktop config file location:
31
37
  - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
32
38
  - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
33
39
 
34
- Restart Claude Desktop after editing the config. PreReason should appear in your connectors list with 5 tools.
40
+ Restart your MCP client after editing the config. PreReason should appear with 5 tools.
35
41
 
36
42
  ## Get an API Key
37
43
 
@@ -54,35 +60,35 @@ Restart Claude Desktop after editing the config. PreReason should appear in your
54
60
  ### Free (6 templates)
55
61
  | Template | Description |
56
62
  |----------|-------------|
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)
63
+ | `btc.quick-check` | Minimal fast context: BTC + Net Liquidity + correlation |
64
+ | `btc.context` | BTC + liquidity + hash ribbon + difficulty + momentum |
65
+ | `macro.snapshot` | Fed balance, M2, treasury yields, VIX, net liquidity |
66
+ | `cross.correlations` | BTC correlation matrix vs macro indicators |
67
+ | `btc.pulse` | Volume, fees, mempool analysis |
68
+ | `btc.grid-stress` | Epoch pace and difficulty adjustment forecast |
69
+
70
+ ### Basic - $19.99/mo (5 templates)
65
71
  | Template | Description |
66
72
  |----------|-------------|
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 |
73
+ | `btc.momentum` | Extended momentum with 90d trends and percentiles |
74
+ | `macro.liquidity` | Liquidity indicators with momentum analysis |
75
+ | `btc.on-chain` | Hash rate, difficulty, fees, mempool health |
76
+ | `cross.breadth` | Cross-asset breadth with SPY, DXY, VIX |
77
+ | `btc.miner-survival` | Hashprice thermometer with miner stress scoring |
72
78
 
73
- ### Pro — $49.99/mo (6 templates)
79
+ ### Pro - $49.99/mo (6 templates)
74
80
  | Template | Description |
75
81
  |----------|-------------|
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 |
82
+ | `btc.full` | Complete market intelligence with all metrics and analysis |
83
+ | `btc.factors` | Multi-factor attribution for BTC price movements |
84
+ | `cross.regime` | Market regime classification (risk-on/risk-off/transition) |
85
+ | `fx.liquidity` | FX environment with DXY, treasury, and global liquidity |
86
+ | `btc.energy` | Production cost model with gas input pressure |
87
+ | `btc.treasury` | Corporate Bitcoin treasury intelligence from SEC filings |
82
88
 
83
89
  ## Example Prompts
84
90
 
85
- Once connected, ask Claude:
91
+ Once connected, try prompts like:
86
92
 
87
93
  - "What's the current BTC regime?"
88
94
  - "Show me the macro snapshot"
@@ -132,7 +138,7 @@ If you still see this error, ensure you're using the `env` block (not `--header`
132
138
 
133
139
  ## Other MCP Clients
134
140
 
135
- Claude Code, Cursor, and Windsurf support remote HTTP servers directly — **no bridge package needed**:
141
+ Clients that support remote HTTP servers (Claude Code, Cursor, Windsurf, and others) can connect directly without this bridge package:
136
142
 
137
143
  ```bash
138
144
  # Claude Code (CLI)
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@prereason/mcp",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
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. Trend signals, regime classification, confidence scores, and 17 context templates.",
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",