crypto-quant-signal-mcp 1.7.0 → 1.8.1
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.
- package/README.md +51 -22
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +393 -91
- package/dist/index.js.map +1 -1
- package/dist/lib/adapters/binance.d.ts +23 -0
- package/dist/lib/adapters/binance.d.ts.map +1 -0
- package/dist/lib/adapters/binance.js +177 -0
- package/dist/lib/adapters/binance.js.map +1 -0
- package/dist/lib/adapters/bitget.d.ts +19 -0
- package/dist/lib/adapters/bitget.d.ts.map +1 -0
- package/dist/lib/adapters/bitget.js +155 -0
- package/dist/lib/adapters/bitget.js.map +1 -0
- package/dist/lib/adapters/bybit.d.ts +19 -0
- package/dist/lib/adapters/bybit.d.ts.map +1 -0
- package/dist/lib/adapters/bybit.js +151 -0
- package/dist/lib/adapters/bybit.js.map +1 -0
- package/dist/lib/adapters/okx.d.ts +19 -0
- package/dist/lib/adapters/okx.d.ts.map +1 -0
- package/dist/lib/adapters/okx.js +196 -0
- package/dist/lib/adapters/okx.js.map +1 -0
- package/dist/lib/exchange-adapter.d.ts +8 -4
- package/dist/lib/exchange-adapter.d.ts.map +1 -1
- package/dist/lib/exchange-adapter.js +30 -6
- package/dist/lib/exchange-adapter.js.map +1 -1
- package/dist/lib/license.d.ts +29 -2
- package/dist/lib/license.d.ts.map +1 -1
- package/dist/lib/license.js +115 -7
- package/dist/lib/license.js.map +1 -1
- package/dist/lib/merkle.d.ts +16 -0
- package/dist/lib/merkle.d.ts.map +1 -0
- package/dist/lib/merkle.js +76 -0
- package/dist/lib/merkle.js.map +1 -0
- package/dist/lib/performance-db.d.ts +29 -6
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +224 -19
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/stripe.d.ts.map +1 -1
- package/dist/lib/stripe.js +3 -0
- package/dist/lib/stripe.js.map +1 -1
- package/dist/lib/telegram.d.ts +7 -0
- package/dist/lib/telegram.d.ts.map +1 -0
- package/dist/lib/telegram.js +55 -0
- package/dist/lib/telegram.js.map +1 -0
- package/dist/resources/signal-performance.d.ts.map +1 -1
- package/dist/resources/signal-performance.js +3 -3
- package/dist/resources/signal-performance.js.map +1 -1
- package/dist/scripts/agent-forum-post.d.ts +18 -0
- package/dist/scripts/agent-forum-post.d.ts.map +1 -0
- package/dist/scripts/agent-forum-post.js +604 -0
- package/dist/scripts/agent-forum-post.js.map +1 -0
- package/dist/scripts/backfill-outcomes.js +127 -80
- package/dist/scripts/backfill-outcomes.js.map +1 -1
- package/dist/scripts/deploy-merkle-contract.d.ts +3 -0
- package/dist/scripts/deploy-merkle-contract.d.ts.map +1 -0
- package/dist/scripts/deploy-merkle-contract.js +26 -0
- package/dist/scripts/deploy-merkle-contract.js.map +1 -0
- package/dist/scripts/molthunt-launch.d.ts +11 -0
- package/dist/scripts/molthunt-launch.d.ts.map +1 -0
- package/dist/scripts/molthunt-launch.js +234 -0
- package/dist/scripts/molthunt-launch.js.map +1 -0
- package/dist/scripts/monitor.d.ts +3 -0
- package/dist/scripts/monitor.d.ts.map +1 -0
- package/dist/scripts/monitor.js +305 -0
- package/dist/scripts/monitor.js.map +1 -0
- package/dist/scripts/publish-merkle-batch.d.ts +14 -0
- package/dist/scripts/publish-merkle-batch.d.ts.map +1 -0
- package/dist/scripts/publish-merkle-batch.js +93 -0
- package/dist/scripts/publish-merkle-batch.js.map +1 -0
- package/dist/scripts/seed-signals.d.ts +12 -16
- package/dist/scripts/seed-signals.d.ts.map +1 -1
- package/dist/scripts/seed-signals.js +194 -48
- package/dist/scripts/seed-signals.js.map +1 -1
- package/dist/tools/get-market-regime.d.ts +3 -1
- package/dist/tools/get-market-regime.d.ts.map +1 -1
- package/dist/tools/get-market-regime.js +23 -10
- package/dist/tools/get-market-regime.js.map +1 -1
- package/dist/tools/get-trade-signal.d.ts +2 -1
- package/dist/tools/get-trade-signal.d.ts.map +1 -1
- package/dist/tools/get-trade-signal.js +58 -18
- package/dist/tools/get-trade-signal.js.map +1 -1
- package/dist/tools/scan-funding-arb.d.ts.map +1 -1
- package/dist/tools/scan-funding-arb.js +26 -8
- package/dist/tools/scan-funding-arb.js.map +1 -1
- package/dist/types.d.ts +3 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +12 -2
- 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
|
|
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
|
[](https://www.npmjs.com/package/crypto-quant-signal-mcp)
|
|
10
10
|
[](https://www.npmjs.com/package/crypto-quant-signal-mcp)
|
|
11
11
|
[](https://opensource.org/licenses/MIT)
|
|
12
|
+
[](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81)
|
|
12
13
|
|
|
13
|
-
**[Live Track Record](https://algovault.com/track-record)** —
|
|
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
|
|
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
|
|
27
|
-
- **Cross-venue intelligence.**
|
|
28
|
-
- **Published track record with every release.** Every
|
|
29
|
-
- **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works and adjusts — the
|
|
30
|
-
- **Crypto + TradFi coverage.** 290+ assets — standard crypto perps, TradFi perpetuals (stocks, indices, commodities, FX
|
|
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
|

|
|
54
57
|
|
|
55
58
|
That's it. Your Claude now has a quant analyst built in.
|
|
@@ -60,22 +63,23 @@ 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
|
|
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
|
-
- `
|
|
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
|
|
73
77
|
|
|
74
|
-
**Output includes:**
|
|
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.
|
|
75
79
|
|
|
76
80
|
### `scan_funding_arb`
|
|
77
81
|
|
|
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).
|
|
82
|
+
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
83
|
|
|
80
84
|
This is the only MCP server that provides cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
|
|
81
85
|
|
|
@@ -94,6 +98,7 @@ Uses a multi-dimensional classification approach combining directional strength
|
|
|
94
98
|
**Parameters:**
|
|
95
99
|
- `coin` (string, required): Asset symbol
|
|
96
100
|
- `timeframe` (string, default `"4h"`): Candle timeframe for analysis
|
|
101
|
+
- `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_signal
|
|
97
102
|
|
|
98
103
|
**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
104
|
|
|
@@ -101,20 +106,34 @@ Uses a multi-dimensional classification approach combining directional strength
|
|
|
101
106
|
|
|
102
107
|
## Performance Tracking
|
|
103
108
|
|
|
104
|
-
Every
|
|
109
|
+
Every call is tracked from emission to outcome. No exceptions.
|
|
105
110
|
|
|
106
111
|
**What we measure:**
|
|
107
112
|
- Outcome prices at timeframe-appropriate evaluation windows
|
|
108
|
-
- PFE Win Rate — did price move in the
|
|
109
|
-
- Expected Value — probability-weighted average return per
|
|
113
|
+
- PFE Win Rate — did price move in the call direction at any point during the evaluation window
|
|
114
|
+
- Expected Value — probability-weighted average return per call
|
|
110
115
|
- Profit Factor — gross wins divided by gross losses
|
|
111
116
|
- Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
|
|
112
117
|
- Running statistics per asset, timeframe, and quality tier
|
|
113
118
|
|
|
119
|
+
**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.
|
|
120
|
+
|
|
121
|
+
- **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.
|
|
122
|
+
|
|
114
123
|
**Infrastructure:**
|
|
115
124
|
- Remote mode: PostgreSQL with automated outcome backfill
|
|
116
125
|
- Local mode: SQLite at `~/.crypto-quant-signal/performance.db`
|
|
117
|
-
- Only high-confidence BUY/SELL
|
|
126
|
+
- Only high-confidence BUY/SELL calls are tracked — HOLD is excluded
|
|
127
|
+
- Signals are tracked per exchange — the track record shows performance on each venue independently
|
|
128
|
+
|
|
129
|
+
### On-Chain Verification
|
|
130
|
+
|
|
131
|
+
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.
|
|
132
|
+
|
|
133
|
+
- **Contract**: [`0x6485...0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) (Base L2)
|
|
134
|
+
- **Verify any call**: `https://api.algovault.com/api/verify-signal?signalId=<ID>`
|
|
135
|
+
- **View all batches**: `https://api.algovault.com/api/merkle-batches`
|
|
136
|
+
- **Visual verification**: [algovault.com/verify](https://algovault.com/verify)
|
|
118
137
|
|
|
119
138
|
---
|
|
120
139
|
|
|
@@ -122,6 +141,7 @@ Every signal is tracked from emission to outcome. No exceptions.
|
|
|
122
141
|
|
|
123
142
|
| Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
|
|
124
143
|
|---------|------|-------------------|-------------|---------------------|-----------------|
|
|
144
|
+
| Exchanges | HL only | All 5 | All 5 | All 5 | All 5 |
|
|
125
145
|
| Assets | BTC, ETH | All 290+ | All 290+ | All 290+ | All 290+ |
|
|
126
146
|
| Asset classes | Crypto only | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
|
|
127
147
|
| Timeframes | 15m, 1h | All 11 | All 11 | All 11 | All 11 |
|
|
@@ -130,6 +150,9 @@ Every signal is tracked from emission to outcome. No exceptions.
|
|
|
130
150
|
| Monthly calls | ~100/day | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
|
|
131
151
|
| Support | Community | Email | Priority | Dedicated | — |
|
|
132
152
|
| Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
|
|
153
|
+
| HOLD calls | Free | Free | Free | Free | Free |
|
|
154
|
+
|
|
155
|
+
\* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction.
|
|
133
156
|
|
|
134
157
|
**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
158
|
|
|
@@ -210,15 +233,19 @@ MCP Server (Express + @modelcontextprotocol/sdk)
|
|
|
210
233
|
│ └─ Liquidity filter for meme/micro assets
|
|
211
234
|
│
|
|
212
235
|
├─ Exchange Adapter Layer
|
|
213
|
-
│
|
|
236
|
+
│ ├─ Hyperliquid (crypto + TradFi xyz perps)
|
|
237
|
+
│ ├─ Binance USDT-M Futures
|
|
238
|
+
│ ├─ Bybit Linear
|
|
239
|
+
│ ├─ OKX Swap
|
|
240
|
+
│ └─ Bitget USDT-M
|
|
214
241
|
│
|
|
215
242
|
├─ Performance Tracker
|
|
216
243
|
│ └─ PostgreSQL (remote) / SQLite (local)
|
|
217
244
|
│
|
|
218
|
-
└─
|
|
245
|
+
└─ Exchange Public APIs (free, no auth — all 5 venues)
|
|
219
246
|
```
|
|
220
247
|
|
|
221
|
-
**Exchange adapter pattern:** All exchange interactions go through the `ExchangeAdapter` interface — supporting
|
|
248
|
+
**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
249
|
|
|
223
250
|
---
|
|
224
251
|
|
|
@@ -238,7 +265,7 @@ Schemas are designed for composability. All tools share consistent `timestamp`,
|
|
|
238
265
|
|
|
239
266
|
## Privacy
|
|
240
267
|
|
|
241
|
-
**Local mode:** Zero telemetry. No data sent to AlgoVault servers.
|
|
268
|
+
**Local mode:** Zero telemetry. No data sent to AlgoVault servers. Call history stored on your machine only.
|
|
242
269
|
|
|
243
270
|
**Remote mode:** Request metadata logged for analytics (IP hashed, never stored raw). See [privacy policy](https://api.algovault.com/privacy).
|
|
244
271
|
|
|
@@ -250,6 +277,8 @@ MIT
|
|
|
250
277
|
|
|
251
278
|
---
|
|
252
279
|
|
|
253
|
-
|
|
280
|
+
> **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.
|
|
281
|
+
|
|
282
|
+
Built by [AlgoVault Labs](https://algovault.com)
|
|
254
283
|
|
|
255
284
|
[Landing page](https://algovault.com) · [API endpoint](https://api.algovault.com/mcp)
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwtCpE,wBAAgB,mBAAmB,cAElC"}
|