crypto-quant-signal-mcp 1.7.0 → 1.9.0

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 (114) hide show
  1. package/README.md +53 -22
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +421 -91
  4. package/dist/index.js.map +1 -1
  5. package/dist/lib/adapters/binance.d.ts +23 -0
  6. package/dist/lib/adapters/binance.d.ts.map +1 -0
  7. package/dist/lib/adapters/binance.js +180 -0
  8. package/dist/lib/adapters/binance.js.map +1 -0
  9. package/dist/lib/adapters/bitget.d.ts +19 -0
  10. package/dist/lib/adapters/bitget.d.ts.map +1 -0
  11. package/dist/lib/adapters/bitget.js +158 -0
  12. package/dist/lib/adapters/bitget.js.map +1 -0
  13. package/dist/lib/adapters/bybit.d.ts +19 -0
  14. package/dist/lib/adapters/bybit.d.ts.map +1 -0
  15. package/dist/lib/adapters/bybit.js +154 -0
  16. package/dist/lib/adapters/bybit.js.map +1 -0
  17. package/dist/lib/adapters/hyperliquid.d.ts.map +1 -1
  18. package/dist/lib/adapters/hyperliquid.js +4 -1
  19. package/dist/lib/adapters/hyperliquid.js.map +1 -1
  20. package/dist/lib/adapters/okx.d.ts +19 -0
  21. package/dist/lib/adapters/okx.d.ts.map +1 -0
  22. package/dist/lib/adapters/okx.js +199 -0
  23. package/dist/lib/adapters/okx.js.map +1 -0
  24. package/dist/lib/changelog-parser.d.ts +43 -0
  25. package/dist/lib/changelog-parser.d.ts.map +1 -0
  26. package/dist/lib/changelog-parser.js +134 -0
  27. package/dist/lib/changelog-parser.js.map +1 -0
  28. package/dist/lib/cross-asset-grid.d.ts +39 -0
  29. package/dist/lib/cross-asset-grid.d.ts.map +1 -0
  30. package/dist/lib/cross-asset-grid.js +160 -0
  31. package/dist/lib/cross-asset-grid.js.map +1 -0
  32. package/dist/lib/exchange-adapter.d.ts +8 -4
  33. package/dist/lib/exchange-adapter.d.ts.map +1 -1
  34. package/dist/lib/exchange-adapter.js +30 -6
  35. package/dist/lib/exchange-adapter.js.map +1 -1
  36. package/dist/lib/forum-post-content.d.ts +48 -0
  37. package/dist/lib/forum-post-content.d.ts.map +1 -0
  38. package/dist/lib/forum-post-content.js +118 -0
  39. package/dist/lib/forum-post-content.js.map +1 -0
  40. package/dist/lib/forum-post-failures.d.ts +34 -0
  41. package/dist/lib/forum-post-failures.d.ts.map +1 -0
  42. package/dist/lib/forum-post-failures.js +218 -0
  43. package/dist/lib/forum-post-failures.js.map +1 -0
  44. package/dist/lib/forum-post-verify.d.ts +64 -0
  45. package/dist/lib/forum-post-verify.d.ts.map +1 -0
  46. package/dist/lib/forum-post-verify.js +240 -0
  47. package/dist/lib/forum-post-verify.js.map +1 -0
  48. package/dist/lib/license.d.ts +29 -2
  49. package/dist/lib/license.d.ts.map +1 -1
  50. package/dist/lib/license.js +115 -7
  51. package/dist/lib/license.js.map +1 -1
  52. package/dist/lib/merkle.d.ts +16 -0
  53. package/dist/lib/merkle.d.ts.map +1 -0
  54. package/dist/lib/merkle.js +76 -0
  55. package/dist/lib/merkle.js.map +1 -0
  56. package/dist/lib/performance-db.d.ts +45 -6
  57. package/dist/lib/performance-db.d.ts.map +1 -1
  58. package/dist/lib/performance-db.js +321 -19
  59. package/dist/lib/performance-db.js.map +1 -1
  60. package/dist/lib/pkg-version.d.ts +2 -0
  61. package/dist/lib/pkg-version.d.ts.map +1 -0
  62. package/dist/lib/pkg-version.js +22 -0
  63. package/dist/lib/pkg-version.js.map +1 -0
  64. package/dist/lib/stripe.d.ts.map +1 -1
  65. package/dist/lib/stripe.js +3 -0
  66. package/dist/lib/stripe.js.map +1 -1
  67. package/dist/lib/telegram.d.ts +7 -0
  68. package/dist/lib/telegram.d.ts.map +1 -0
  69. package/dist/lib/telegram.js +55 -0
  70. package/dist/lib/telegram.js.map +1 -0
  71. package/dist/resources/signal-performance.d.ts.map +1 -1
  72. package/dist/resources/signal-performance.js +3 -3
  73. package/dist/resources/signal-performance.js.map +1 -1
  74. package/dist/scripts/agent-forum-post.d.ts +20 -0
  75. package/dist/scripts/agent-forum-post.d.ts.map +1 -0
  76. package/dist/scripts/agent-forum-post.js +892 -0
  77. package/dist/scripts/agent-forum-post.js.map +1 -0
  78. package/dist/scripts/backfill-outcomes.js +127 -80
  79. package/dist/scripts/backfill-outcomes.js.map +1 -1
  80. package/dist/scripts/deploy-merkle-contract.d.ts +3 -0
  81. package/dist/scripts/deploy-merkle-contract.d.ts.map +1 -0
  82. package/dist/scripts/deploy-merkle-contract.js +26 -0
  83. package/dist/scripts/deploy-merkle-contract.js.map +1 -0
  84. package/dist/scripts/molthunt-launch.d.ts +11 -0
  85. package/dist/scripts/molthunt-launch.d.ts.map +1 -0
  86. package/dist/scripts/molthunt-launch.js +234 -0
  87. package/dist/scripts/molthunt-launch.js.map +1 -0
  88. package/dist/scripts/monitor.d.ts +3 -0
  89. package/dist/scripts/monitor.d.ts.map +1 -0
  90. package/dist/scripts/monitor.js +345 -0
  91. package/dist/scripts/monitor.js.map +1 -0
  92. package/dist/scripts/publish-merkle-batch.d.ts +14 -0
  93. package/dist/scripts/publish-merkle-batch.d.ts.map +1 -0
  94. package/dist/scripts/publish-merkle-batch.js +93 -0
  95. package/dist/scripts/publish-merkle-batch.js.map +1 -0
  96. package/dist/scripts/seed-signals.d.ts +12 -16
  97. package/dist/scripts/seed-signals.d.ts.map +1 -1
  98. package/dist/scripts/seed-signals.js +194 -48
  99. package/dist/scripts/seed-signals.js.map +1 -1
  100. package/dist/tools/get-market-regime.d.ts +3 -1
  101. package/dist/tools/get-market-regime.d.ts.map +1 -1
  102. package/dist/tools/get-market-regime.js +25 -10
  103. package/dist/tools/get-market-regime.js.map +1 -1
  104. package/dist/tools/get-trade-signal.d.ts +2 -1
  105. package/dist/tools/get-trade-signal.d.ts.map +1 -1
  106. package/dist/tools/get-trade-signal.js +133 -50
  107. package/dist/tools/get-trade-signal.js.map +1 -1
  108. package/dist/tools/scan-funding-arb.d.ts.map +1 -1
  109. package/dist/tools/scan-funding-arb.js +29 -8
  110. package/dist/tools/scan-funding-arb.js.map +1 -1
  111. package/dist/types.d.ts +46 -0
  112. package/dist/types.d.ts.map +1 -1
  113. package/package.json +12 -2
  114. package/server.json +3 -3
package/README.md CHANGED
@@ -4,13 +4,14 @@
4
4
 
5
5
  # crypto-quant-signal-mcp
6
6
 
7
- The signal intelligence layer for AI trading agents — composite quant signals across crypto and TradFi perps, cross-venue arbitrage detection, and regime-aware market classification via MCP.
7
+ The call intelligence layer for AI trading agents — composite quant calls across 5 exchanges (Hyperliquid, Binance, Bybit, OKX, Bitget), cross-venue arbitrage detection, and regime-aware market classification via MCP.
8
8
 
9
9
  [![npm version](https://img.shields.io/npm/v/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
10
10
  [![npm downloads](https://img.shields.io/npm/dw/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
11
11
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
12
+ [![On-Chain Verified](https://img.shields.io/badge/Track_Record-On--Chain_Verified-blue?logo=ethereum)](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81)
12
13
 
13
- **[Live Track Record](https://algovault.com/track-record)** — 90%+ directional accuracy across 900+ trade calls. Public, no login required.
14
+ **[Live Track Record](https://algovault.com/track-record)** — 91%+ directional accuracy across 19,000+ trade calls on 5 exchanges. Public, no login required.
14
15
 
15
16
  ---
16
17
 
@@ -18,16 +19,16 @@ The signal intelligence layer for AI trading agents — composite quant signals
18
19
 
19
20
  Most MCP trading servers give you raw data — prices, order books, candles. Your agent still has to figure out what to do with it.
20
21
 
21
- AlgoVault is different. We give your agent **one answer**: a directional verdict with a confidence score, built from a multi-factor composite scoring engine tuned on production quant systems. Every signal is tracked, every outcome is measured, and the full track record is public from day one.
22
+ AlgoVault is different. We give your agent **one answer**: a directional verdict with a confidence score, built from a multi-factor composite scoring engine tuned on production quant systems. Every call is tracked, every outcome is measured, and the full track record is public from day one.
22
23
 
23
24
  **What makes this not just another indicator wrapper:**
24
25
 
25
26
  - **Composite scoring, not single-indicator noise.** Multiple orthogonal signals — momentum oscillators, trend structure, derivatives positioning, volume dynamics, open interest flow — fused into a single weighted verdict. The weights are calibrated from live market outcome data, not textbook defaults.
26
- - **Regime-aware signal generation.** Signals are filtered through a market regime classifier before emission. The engine knows when to signal and when to stay silent — a trend-following setup in a ranging market gets suppressed, not broadcast.
27
- - **Cross-venue intelligence.** Funding rates from Hyperliquid, Binance, and Bybit are normalized and compared in real-time. Nobody else does cross-venue derivatives analysis via MCP.
28
- - **Published track record with every release.** Every signal is recorded with outcome prices at multiple horizons. Win rate, profit factor, and expected value are computed continuously. No cherry-picking, no survivorship bias.
29
- - **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works and adjusts — the signal you get today is better than the one from last month.
30
- - **Crypto + TradFi coverage.** 290+ assets — standard crypto perps, TradFi perpetuals (stocks, indices, commodities, FX via Hyperliquid's xyz dex), and liquidity-filtered meme coins. Assets are classified into quality tiers with institutional-grade signal filtering.
27
+ - **Regime-aware call generation.** Calls are filtered through a market regime classifier before emission. The engine knows when to issue calls and when to stay silent — a trend-following setup in a ranging market gets suppressed, not broadcast.
28
+ - **Cross-venue intelligence.** Full signal generation on 5 exchanges — Hyperliquid, Binance, Bybit, OKX, and Bitget — with native candle, OI, funding, and volume data per venue. Cross-venue funding arbitrage scanning across all venues. Nobody else does multi-exchange derivatives analysis via MCP.
29
+ - **Published track record with every release.** Every call is recorded with outcome prices at multiple horizons. Win rate, profit factor, and expected value are computed continuously. No cherry-picking, no survivorship bias.
30
+ - **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works and adjusts — the call you get today is better than the one from last month.
31
+ - **Crypto + TradFi coverage.** 290+ assets across 5 exchanges — standard crypto perps on all venues, TradFi perpetuals (stocks, indices, commodities, FX) on Hyperliquid, and liquidity-filtered meme coins. Assets are classified into quality tiers with per-exchange signal generation.
31
32
 
32
33
  ---
33
34
 
@@ -50,6 +51,8 @@ No code. No API key. No install.
50
51
 
51
52
  > "Get me a trade signal for ETH on the 4h timeframe"
52
53
 
54
+ > "Get me a trade signal for BTC on Binance, 1h timeframe"
55
+
53
56
  ![BTC Signal Result](https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/BTC-signal.png)
54
57
 
55
58
  That's it. Your Claude now has a quant analyst built in.
@@ -60,22 +63,25 @@ That's it. Your Claude now has a quant analyst built in.
60
63
 
61
64
  ### `get_trade_signal`
62
65
 
63
- Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any supported asset — crypto perps, TradFi perpetuals (stocks, indices, commodities, FX), and liquidity-filtered meme coins on Hyperliquid.
66
+ Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any supported asset on any of 5 supported exchanges — crypto perps, TradFi perpetuals (stocks, indices, commodities, FX), and liquidity-filtered meme coins on Hyperliquid.
64
67
 
65
68
  Under the hood: a multi-factor scoring engine evaluates momentum, trend structure, derivatives sentiment, open interest dynamics, and volume conviction. Scores pass through regime-aware filters and adaptive post-processing gates — including funding flow analysis, volatility regime detection, and trend persistence decay — before a final verdict is emitted.
66
69
 
67
- Only high-conviction signals are generated. The engine is designed to stay silent when the edge is unclear.
70
+ Only high-conviction calls are generated. The engine is designed to stay silent when the edge is unclear.
68
71
 
69
72
  **Parameters:**
70
73
  - `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 290+ supported assets
71
74
  - `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
72
- - `includeReasoning` (boolean, default `true`): Human-readable explanation of the signal logic
75
+ - `exchange` (string, default `"HL"`): `"HL"` (Hyperliquid), `"BINANCE"`, `"BYBIT"`, `"OKX"`, `"BITGET"`. TradFi assets (GOLD, TSLA, etc.) are HL-only.
76
+ - `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
77
+
78
+ **Output includes:** call direction, confidence score (0–100), all computed indicator values, detected market regime, reasoning narrative, and `_algovault` metadata for downstream tool composability.
73
79
 
74
- **Output includes:** signal direction, confidence score (0–100), all computed indicator values, detected market regime, reasoning narrative, and `_algovault` metadata for downstream tool composability.
80
+ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `try_next` (always, when the cross-asset grid has non-HOLD cells) as signal-surface expansion fields — exploration hints across the BTC/ETH/SOL/BNB/XRP/DOGE × 5m/15m/1h/4h grid, not trade recommendations.
75
81
 
76
82
  ### `scan_funding_arb`
77
83
 
78
- Scans cross-venue funding rate differentials across Hyperliquid, Binance, and Bybit. Normalizes hourly vs 8-hour rate conventions, computes basis-point spreads, and ranks opportunities by composite score (spread magnitude, time urgency, and funding conviction from 24h history).
84
+ Scans cross-venue funding rate differentials across Hyperliquid, Binance, and Bybit. Normalizes hourly vs 8-hour rate conventions, computes basis-point spreads, and ranks opportunities by composite score (spread magnitude, time urgency, and funding conviction from 24h history). OKX and Bitget funding data is available via their respective adapters — arb scanning expansion is planned.
79
85
 
80
86
  This is the only MCP server that provides cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
81
87
 
@@ -94,6 +100,7 @@ Uses a multi-dimensional classification approach combining directional strength
94
100
  **Parameters:**
95
101
  - `coin` (string, required): Asset symbol
96
102
  - `timeframe` (string, default `"4h"`): Candle timeframe for analysis
103
+ - `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_signal
97
104
 
98
105
  **Output includes:** regime label, confidence score, underlying metrics (trend strength, volatility interpretation, price structure), cross-venue funding sentiment, and a plain-English strategy suggestion.
99
106
 
@@ -101,20 +108,34 @@ Uses a multi-dimensional classification approach combining directional strength
101
108
 
102
109
  ## Performance Tracking
103
110
 
104
- Every signal is tracked from emission to outcome. No exceptions.
111
+ Every call is tracked from emission to outcome. No exceptions.
105
112
 
106
113
  **What we measure:**
107
114
  - Outcome prices at timeframe-appropriate evaluation windows
108
- - PFE Win Rate — did price move in the signal direction at any point during the evaluation window
109
- - Expected Value — probability-weighted average return per signal
115
+ - PFE Win Rate — did price move in the call direction at any point during the evaluation window
116
+ - Expected Value — probability-weighted average return per call
110
117
  - Profit Factor — gross wins divided by gross losses
111
118
  - Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
112
119
  - Running statistics per asset, timeframe, and quality tier
113
120
 
121
+ **HOLD calls are free** — when the engine says "don't trade," you don't pay. Only BUY and SELL verdicts are charged via x402 or count against subscription quotas. This aligns our incentives: you only pay when we see a tradeable opportunity.
122
+
123
+ - **HOLD Rate**: Percentage of scans where the engine declines to issue a trade call. A high HOLD rate (currently ~84%) means the engine is selective — it only calls BUY/SELL when conditions align across multiple indicators.
124
+
114
125
  **Infrastructure:**
115
126
  - Remote mode: PostgreSQL with automated outcome backfill
116
127
  - Local mode: SQLite at `~/.crypto-quant-signal/performance.db`
117
- - Only high-confidence BUY/SELL signals are tracked — HOLD is excluded
128
+ - Only high-confidence BUY/SELL calls are tracked — HOLD is excluded
129
+ - Signals are tracked per exchange — the track record shows performance on each venue independently
130
+
131
+ ### On-Chain Verification
132
+
133
+ Every call is hashed (keccak256) at creation time and anchored on Base L2 via daily Merkle batches. This makes the track record tamper-proof — we cannot edit past calls.
134
+
135
+ - **Contract**: [`0x6485...0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) (Base L2)
136
+ - **Verify any call**: `https://api.algovault.com/api/verify-signal?signalId=<ID>`
137
+ - **View all batches**: `https://api.algovault.com/api/merkle-batches`
138
+ - **Visual verification**: [algovault.com/verify](https://algovault.com/verify)
118
139
 
119
140
  ---
120
141
 
@@ -122,6 +143,7 @@ Every signal is tracked from emission to outcome. No exceptions.
122
143
 
123
144
  | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
124
145
  |---------|------|-------------------|-------------|---------------------|-----------------|
146
+ | Exchanges | HL only | All 5 | All 5 | All 5 | All 5 |
125
147
  | Assets | BTC, ETH | All 290+ | All 290+ | All 290+ | All 290+ |
126
148
  | Asset classes | Crypto only | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
127
149
  | Timeframes | 15m, 1h | All 11 | All 11 | All 11 | All 11 |
@@ -130,6 +152,9 @@ Every signal is tracked from emission to outcome. No exceptions.
130
152
  | Monthly calls | ~100/day | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
131
153
  | Support | Community | Email | Priority | Dedicated | — |
132
154
  | Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
155
+ | HOLD calls | Free | Free | Free | Free | Free |
156
+
157
+ \* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction.
133
158
 
134
159
  **x402 micropayments:** AI agents pay per HTTP call with USDC on Base — no signup, no API key, no billing. The payment receipt is the credential. See [x402.org](https://x402.org).
135
160
 
@@ -210,15 +235,19 @@ MCP Server (Express + @modelcontextprotocol/sdk)
210
235
  │ └─ Liquidity filter for meme/micro assets
211
236
  │
212
237
  ├─ Exchange Adapter Layer
213
- │ └─ Hyperliquid (standard + xyz TradFi perps) · Binance, Bybit (funding data)
238
+ │ ├─ Hyperliquid (crypto + TradFi xyz perps)
239
+ │ ├─ Binance USDT-M Futures
240
+ │ ├─ Bybit Linear
241
+ │ ├─ OKX Swap
242
+ │ └─ Bitget USDT-M
214
243
  │
215
244
  ├─ Performance Tracker
216
245
  │ └─ PostgreSQL (remote) / SQLite (local)
217
246
  │
218
- └─ Hyperliquid Public API (free, no auth)
247
+ └─ Exchange Public APIs (free, no auth — all 5 venues)
219
248
  ```
220
249
 
221
- **Exchange adapter pattern:** All exchange interactions go through the `ExchangeAdapter` interface — supporting both standard crypto perps and xyz TradFi perps on Hyperliquid, with Binance and Bybit for cross-venue funding comparison.
250
+ **Exchange adapter pattern:** All exchange interactions go through the `ExchangeAdapter` interface — supporting full signal generation on all 5 exchanges. Each adapter implements candles, OI, funding rates, and current price via native exchange APIs. TradFi perps are Hyperliquid-exclusive.
222
251
 
223
252
  ---
224
253
 
@@ -238,7 +267,7 @@ Schemas are designed for composability. All tools share consistent `timestamp`,
238
267
 
239
268
  ## Privacy
240
269
 
241
- **Local mode:** Zero telemetry. No data sent to AlgoVault servers. Signal history stored on your machine only.
270
+ **Local mode:** Zero telemetry. No data sent to AlgoVault servers. Call history stored on your machine only.
242
271
 
243
272
  **Remote mode:** Request metadata logged for analytics (IP hashed, never stored raw). See [privacy policy](https://api.algovault.com/privacy).
244
273
 
@@ -250,6 +279,8 @@ MIT
250
279
 
251
280
  ---
252
281
 
253
- Built by [AlgoVault Labs](https://algovault.com) — signal intelligence for the autonomous trading era.
282
+ > **Disclaimer:** AlgoVault provides directional entry interpretation for AI agents. Exit timing is determined by your agent or strategy. This is not financial advice. Past performance does not guarantee future results.
283
+
284
+ Built by [AlgoVault Labs](https://algovault.com)
254
285
 
255
286
  [Landing page](https://algovault.com) · [API endpoint](https://api.algovault.com/mcp)
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAk7BpE,wBAAgB,mBAAmB,cAElC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAovCpE,wBAAgB,mBAAmB,cAElC"}