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.
- package/README.md +53 -22
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +421 -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 +180 -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 +158 -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 +154 -0
- package/dist/lib/adapters/bybit.js.map +1 -0
- package/dist/lib/adapters/hyperliquid.d.ts.map +1 -1
- package/dist/lib/adapters/hyperliquid.js +4 -1
- 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 +199 -0
- package/dist/lib/adapters/okx.js.map +1 -0
- package/dist/lib/changelog-parser.d.ts +43 -0
- package/dist/lib/changelog-parser.d.ts.map +1 -0
- package/dist/lib/changelog-parser.js +134 -0
- package/dist/lib/changelog-parser.js.map +1 -0
- package/dist/lib/cross-asset-grid.d.ts +39 -0
- package/dist/lib/cross-asset-grid.d.ts.map +1 -0
- package/dist/lib/cross-asset-grid.js +160 -0
- package/dist/lib/cross-asset-grid.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/forum-post-content.d.ts +48 -0
- package/dist/lib/forum-post-content.d.ts.map +1 -0
- package/dist/lib/forum-post-content.js +118 -0
- package/dist/lib/forum-post-content.js.map +1 -0
- package/dist/lib/forum-post-failures.d.ts +34 -0
- package/dist/lib/forum-post-failures.d.ts.map +1 -0
- package/dist/lib/forum-post-failures.js +218 -0
- package/dist/lib/forum-post-failures.js.map +1 -0
- package/dist/lib/forum-post-verify.d.ts +64 -0
- package/dist/lib/forum-post-verify.d.ts.map +1 -0
- package/dist/lib/forum-post-verify.js +240 -0
- package/dist/lib/forum-post-verify.js.map +1 -0
- 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 +45 -6
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +321 -19
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/pkg-version.d.ts +2 -0
- package/dist/lib/pkg-version.d.ts.map +1 -0
- package/dist/lib/pkg-version.js +22 -0
- package/dist/lib/pkg-version.js.map +1 -0
- 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 +20 -0
- package/dist/scripts/agent-forum-post.d.ts.map +1 -0
- package/dist/scripts/agent-forum-post.js +892 -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 +345 -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 +25 -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 +133 -50
- 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 +29 -8
- package/dist/tools/scan-funding-arb.js.map +1 -1
- package/dist/types.d.ts +46 -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,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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
109
|
-
- Expected Value — probability-weighted average return per
|
|
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
|
|
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
|
-
│
|
|
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
|
-
└─
|
|
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
|
|
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.
|
|
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
|
-
|
|
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)
|
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;AAovCpE,wBAAgB,mBAAmB,cAElC"}
|