crypto-quant-signal-mcp 1.6.1 → 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 +64 -33
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +492 -93
- 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/hyperliquid.d.ts +9 -0
- package/dist/lib/adapters/hyperliquid.d.ts.map +1 -1
- package/dist/lib/adapters/hyperliquid.js +31 -2
- package/dist/lib/adapters/hyperliquid.js.map +1 -1
- 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/asset-tiers.d.ts +1 -0
- package/dist/lib/asset-tiers.d.ts.map +1 -1
- package/dist/lib/asset-tiers.js +1 -0
- package/dist/lib/asset-tiers.js.map +1 -1
- 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/indicators.d.ts +25 -6
- package/dist/lib/indicators.d.ts.map +1 -1
- package/dist/lib/indicators.js +168 -21
- package/dist/lib/indicators.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 +117 -8
- 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/oi-ranking.d.ts.map +1 -1
- package/dist/lib/oi-ranking.js +2 -1
- package/dist/lib/oi-ranking.js.map +1 -1
- package/dist/lib/performance-db.d.ts +40 -6
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +275 -19
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/stripe.d.ts +2 -2
- package/dist/lib/stripe.d.ts.map +1 -1
- package/dist/lib/stripe.js +15 -2
- 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 +204 -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 +161 -55
- 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 +172 -23
- package/dist/tools/scan-funding-arb.js.map +1 -1
- package/dist/types.d.ts +29 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +12 -2
- package/server.json +19 -45
package/README.md
CHANGED
|
@@ -4,11 +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)
|
|
13
|
+
|
|
14
|
+
**[Live Track Record](https://algovault.com/track-record)** — 91%+ directional accuracy across 19,000+ trade calls on 5 exchanges. Public, no login required.
|
|
12
15
|
|
|
13
16
|
---
|
|
14
17
|
|
|
@@ -16,16 +19,16 @@ The signal intelligence layer for AI trading agents — composite quant signals
|
|
|
16
19
|
|
|
17
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.
|
|
18
21
|
|
|
19
|
-
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.
|
|
20
23
|
|
|
21
24
|
**What makes this not just another indicator wrapper:**
|
|
22
25
|
|
|
23
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.
|
|
24
|
-
- **Regime-aware
|
|
25
|
-
- **Cross-venue intelligence.**
|
|
26
|
-
- **Published track record with every release.** Every
|
|
27
|
-
- **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works and adjusts — the
|
|
28
|
-
- **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.
|
|
29
32
|
|
|
30
33
|
---
|
|
31
34
|
|
|
@@ -48,6 +51,8 @@ No code. No API key. No install.
|
|
|
48
51
|
|
|
49
52
|
> "Get me a trade signal for ETH on the 4h timeframe"
|
|
50
53
|
|
|
54
|
+
> "Get me a trade signal for BTC on Binance, 1h timeframe"
|
|
55
|
+
|
|
51
56
|

|
|
52
57
|
|
|
53
58
|
That's it. Your Claude now has a quant analyst built in.
|
|
@@ -58,22 +63,23 @@ That's it. Your Claude now has a quant analyst built in.
|
|
|
58
63
|
|
|
59
64
|
### `get_trade_signal`
|
|
60
65
|
|
|
61
|
-
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.
|
|
62
67
|
|
|
63
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.
|
|
64
69
|
|
|
65
|
-
Only high-conviction
|
|
70
|
+
Only high-conviction calls are generated. The engine is designed to stay silent when the edge is unclear.
|
|
66
71
|
|
|
67
72
|
**Parameters:**
|
|
68
73
|
- `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 290+ supported assets
|
|
69
74
|
- `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
|
|
70
|
-
- `
|
|
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
|
|
71
77
|
|
|
72
|
-
**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.
|
|
73
79
|
|
|
74
80
|
### `scan_funding_arb`
|
|
75
81
|
|
|
76
|
-
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
|
|
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.
|
|
77
83
|
|
|
78
84
|
This is the only MCP server that provides cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
|
|
79
85
|
|
|
@@ -87,11 +93,12 @@ This is the only MCP server that provides cross-venue funding arbitrage intellig
|
|
|
87
93
|
|
|
88
94
|
Classifies the current market environment into one of four regimes: **TRENDING_UP**, **TRENDING_DOWN**, **RANGING**, or **VOLATILE**.
|
|
89
95
|
|
|
90
|
-
Uses a multi-dimensional classification approach combining directional strength measurement
|
|
96
|
+
Uses a multi-dimensional classification approach combining directional strength measurement with ADX slope analysis (detecting trend strengthening vs exhaustion), volume-weighted pivot detection, ATR-adaptive funding thresholds, and cross-venue funding sentiment divergence. The regime classification directly informs how `get_trade_signal` filters its output — agents can also use it independently for strategy selection and position sizing.
|
|
91
97
|
|
|
92
98
|
**Parameters:**
|
|
93
99
|
- `coin` (string, required): Asset symbol
|
|
94
100
|
- `timeframe` (string, default `"4h"`): Candle timeframe for analysis
|
|
101
|
+
- `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_signal
|
|
95
102
|
|
|
96
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.
|
|
97
104
|
|
|
@@ -99,39 +106,57 @@ Uses a multi-dimensional classification approach combining directional strength
|
|
|
99
106
|
|
|
100
107
|
## Performance Tracking
|
|
101
108
|
|
|
102
|
-
Every
|
|
109
|
+
Every call is tracked from emission to outcome. No exceptions.
|
|
103
110
|
|
|
104
111
|
**What we measure:**
|
|
105
112
|
- Outcome prices at timeframe-appropriate evaluation windows
|
|
106
|
-
- PFE Win Rate — did price move in the
|
|
107
|
-
- 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
|
|
108
115
|
- Profit Factor — gross wins divided by gross losses
|
|
109
116
|
- Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
|
|
110
117
|
- Running statistics per asset, timeframe, and quality tier
|
|
111
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
|
+
|
|
112
123
|
**Infrastructure:**
|
|
113
124
|
- Remote mode: PostgreSQL with automated outcome backfill
|
|
114
125
|
- Local mode: SQLite at `~/.crypto-quant-signal/performance.db`
|
|
115
|
-
- 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)
|
|
116
137
|
|
|
117
138
|
---
|
|
118
139
|
|
|
119
140
|
## Pricing
|
|
120
141
|
|
|
121
|
-
| Feature | Free | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
|
|
122
|
-
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
127
|
-
|
|
|
128
|
-
|
|
|
129
|
-
|
|
|
130
|
-
|
|
|
142
|
+
| Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
|
|
143
|
+
|---------|------|-------------------|-------------|---------------------|-----------------|
|
|
144
|
+
| Exchanges | HL only | All 5 | All 5 | All 5 | All 5 |
|
|
145
|
+
| Assets | BTC, ETH | All 290+ | All 290+ | All 290+ | All 290+ |
|
|
146
|
+
| Asset classes | Crypto only | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
|
|
147
|
+
| Timeframes | 15m, 1h | All 11 | All 11 | All 11 | All 11 |
|
|
148
|
+
| Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
|
|
149
|
+
| Track record | Full access | Full access | Full access | Full access | Full access |
|
|
150
|
+
| Monthly calls | ~100/day | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
|
|
151
|
+
| Support | Community | Email | Priority | Dedicated | — |
|
|
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.
|
|
131
156
|
|
|
132
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).
|
|
133
158
|
|
|
134
|
-
**Subscriptions:** Sign up at [api.algovault.com/signup](https://api.algovault.com/signup). API key delivered instantly after checkout.
|
|
159
|
+
**Subscriptions:** Sign up at [api.algovault.com/signup](https://api.algovault.com/signup). Starter ($9.99/mo) unlocks all assets and timeframes. API key delivered instantly after checkout.
|
|
135
160
|
|
|
136
161
|
---
|
|
137
162
|
|
|
@@ -208,15 +233,19 @@ MCP Server (Express + @modelcontextprotocol/sdk)
|
|
|
208
233
|
│ └─ Liquidity filter for meme/micro assets
|
|
209
234
|
│
|
|
210
235
|
├─ Exchange Adapter Layer
|
|
211
|
-
│
|
|
236
|
+
│ ├─ Hyperliquid (crypto + TradFi xyz perps)
|
|
237
|
+
│ ├─ Binance USDT-M Futures
|
|
238
|
+
│ ├─ Bybit Linear
|
|
239
|
+
│ ├─ OKX Swap
|
|
240
|
+
│ └─ Bitget USDT-M
|
|
212
241
|
│
|
|
213
242
|
├─ Performance Tracker
|
|
214
243
|
│ └─ PostgreSQL (remote) / SQLite (local)
|
|
215
244
|
│
|
|
216
|
-
└─
|
|
245
|
+
└─ Exchange Public APIs (free, no auth — all 5 venues)
|
|
217
246
|
```
|
|
218
247
|
|
|
219
|
-
**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.
|
|
220
249
|
|
|
221
250
|
---
|
|
222
251
|
|
|
@@ -236,7 +265,7 @@ Schemas are designed for composability. All tools share consistent `timestamp`,
|
|
|
236
265
|
|
|
237
266
|
## Privacy
|
|
238
267
|
|
|
239
|
-
**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.
|
|
240
269
|
|
|
241
270
|
**Remote mode:** Request metadata logged for analytics (IP hashed, never stored raw). See [privacy policy](https://api.algovault.com/privacy).
|
|
242
271
|
|
|
@@ -248,6 +277,8 @@ MIT
|
|
|
248
277
|
|
|
249
278
|
---
|
|
250
279
|
|
|
251
|
-
|
|
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)
|
|
252
283
|
|
|
253
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"}
|