crypto-quant-signal-mcp 1.10.8 → 1.11.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 +60 -38
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +641 -168
- package/dist/index.js.map +1 -1
- package/dist/lib/account-handlers.d.ts +9 -0
- package/dist/lib/account-handlers.d.ts.map +1 -1
- package/dist/lib/account-handlers.js +163 -71
- package/dist/lib/account-handlers.js.map +1 -1
- package/dist/lib/analytics.d.ts.map +1 -1
- package/dist/lib/analytics.js +20 -2
- package/dist/lib/analytics.js.map +1 -1
- package/dist/lib/asset-tiers.js +1 -1
- package/dist/lib/asset-tiers.js.map +1 -1
- package/dist/lib/leaderboard-cell.d.ts +12 -7
- package/dist/lib/leaderboard-cell.d.ts.map +1 -1
- package/dist/lib/leaderboard-cell.js +1 -0
- package/dist/lib/leaderboard-cell.js.map +1 -1
- package/dist/lib/mcp-usage-docs.js +9 -9
- package/dist/lib/performance-db.d.ts +44 -0
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +84 -5
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/welcome-page.js +1 -1
- package/dist/scripts/monitor.js +18 -14
- package/dist/scripts/monitor.js.map +1 -1
- package/dist/tools/get-trade-call.js +1 -1
- package/dist/tools/get-trade-call.js.map +1 -1
- package/dist/types.d.ts +23 -9
- package/dist/types.d.ts.map +1 -1
- package/package.json +7 -1
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -8,13 +8,16 @@
|
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
10
10
|
<strong>The Brain Layer for AI Trading Agents</strong><br/>
|
|
11
|
-
|
|
12
|
-
|
|
11
|
+
A self-tuning quant ML model with a published track record.<br/>
|
|
12
|
+
Composite trade calls · cross-venue funding arbitrage · regime-aware market classification<br/>
|
|
13
|
+
Across 5 exchanges (Binance · Hyperliquid · Bybit · OKX · Bitget) via MCP. <!-- SNAPSHOT-LINE -->
|
|
13
14
|
</p>
|
|
14
15
|
|
|
15
16
|
<p align="center">
|
|
17
|
+
<a href="https://t.me/algovaultofficialbot"><strong>🤖 Try Free in Telegram</strong></a> ·
|
|
16
18
|
<a href="https://algovault.com"><strong>algovault.com</strong></a> ·
|
|
17
19
|
<a href="https://algovault.com/track-record"><strong>Live Track Record</strong></a> ·
|
|
20
|
+
<a href="https://algovault.com/how-it-works"><strong>How it works</strong></a> ·
|
|
18
21
|
<a href="https://api.algovault.com/signup"><strong>Sign Up</strong></a> ·
|
|
19
22
|
<a href="https://algovault.com/docs.html"><strong>Docs</strong></a>
|
|
20
23
|
</p>
|
|
@@ -32,12 +35,12 @@
|
|
|
32
35
|
|
|
33
36
|
<p align="center">
|
|
34
37
|
<a href="https://algovault.com/track-record">
|
|
35
|
-
<img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/track-record-2026-05-
|
|
38
|
+
<img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/track-record-2026-05-13.png" alt="AlgoVault Live Track Record — 90.4% PFE Win Rate across 86,093 trade calls, 33 Merkle batches anchored on Base L2" width="100%" />
|
|
36
39
|
</a>
|
|
37
40
|
</p>
|
|
38
41
|
|
|
39
42
|
<p align="center">
|
|
40
|
-
<strong><span data-tr-field="pfe_wr">90.
|
|
43
|
+
<strong><span data-tr-field="pfe_wr">90.4%</span> PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">86,093</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">33</span> on-chain batches</strong> · <strong><span data-tr-field="hold_rate">99%</span> HOLD rate</strong> <!-- SNAPSHOT-LINE -->
|
|
41
44
|
</p>
|
|
42
45
|
|
|
43
46
|
<p align="center">
|
|
@@ -50,23 +53,40 @@
|
|
|
50
53
|
|
|
51
54
|
---
|
|
52
55
|
|
|
53
|
-
##
|
|
56
|
+
## Drop-in for every MCP client
|
|
54
57
|
|
|
55
|
-
|
|
58
|
+
AlgoVault MCP serves Streamable HTTP at `https://api.algovault.com/mcp` — MCP-spec compliant, no SDK or wrapper library required. Drop-in for:
|
|
56
59
|
|
|
57
|
-
|
|
60
|
+
| Client | Config |
|
|
61
|
+
|---|---|
|
|
62
|
+
| **Claude Desktop** | Settings → Integrations → Add custom connector → `https://api.algovault.com/mcp` |
|
|
63
|
+
| **Claude Code** (CLI) | `claude mcp add crypto-quant-signal https://api.algovault.com/mcp` |
|
|
64
|
+
| **Cursor** | `~/.cursor/config.json` → `mcpServers` block → `url: "https://api.algovault.com/mcp"` |
|
|
65
|
+
| **Cline** | VS Code Cline extension → MCP server settings → add Streamable HTTP server |
|
|
66
|
+
| **Codex** (OpenAI CLI) | `~/.codex/config.toml` → `[mcp_servers.algovault]` table + `url = "https://api.algovault.com/mcp"` (or `codex mcp` CLI) |
|
|
67
|
+
| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` → `mcpServers.algovault.serverUrl = "https://api.algovault.com/mcp"` |
|
|
68
|
+
| **Continue.dev** | `config.yaml` → `mcpServers: [{ name: algovault, type: streamable-http, url: "https://api.algovault.com/mcp" }]` |
|
|
69
|
+
| Any other MCP-spec-compliant client | Configure the Streamable HTTP transport with URL `https://api.algovault.com/mcp` |
|
|
58
70
|
|
|
59
|
-
|
|
71
|
+
MCP `tools/list` + `resources/list` is the API surface. No `@algovault/sdk`; the protocol is the contract.
|
|
60
72
|
|
|
61
|
-
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## What's new in v1.11.0
|
|
76
|
+
|
|
77
|
+
Live since 2026-05-XX (target):
|
|
78
|
+
|
|
79
|
+
- **🤖 Try Free in Telegram.** [`@algovaultofficialbot`](https://t.me/algovaultofficialbot) is now the primary on-ramp at the top of this README. One Telegram command (`/watch BTC 4h`) gets you live regime alerts and BUY/SELL trade calls in real time. Same composite-verdict signal stream as the MCP server, same <span data-tr-field="pfe_wr">90.4%</span> PFE win rate, same on-chain track record. No code, no API key, no install. 100 free trade-call alerts/month before the upgrade prompt fires. <!-- SNAPSHOT-LINE -->
|
|
62
80
|
|
|
63
|
-
-
|
|
81
|
+
- **🔁 Default exchange changed: Hyperliquid → Binance Futures.** `get_trade_call(coin: "BTC", timeframe: "1h")` (no `exchange` arg) now returns the Binance USDT-M Futures verdict by default. Binance is the highest-volume CEX and the most familiar default for devs onboarding. Hyperliquid remains fully supported — pass `exchange: "HL"` to keep prior behavior, or specify any of the 5 venues explicitly. No data loss; default-routing change only.
|
|
64
82
|
|
|
65
|
-
-
|
|
83
|
+
- **🧠 Self-tuning quant ML model — surfaced.** AlgoVault is a self-tuning quant ML model with a published track record. The composite trade-call verdict is produced by a model that continuously learns from outcomes via our [Autonomous Optimization Engine](https://algovault.com/how-it-works). Like an LLM API, you're not buying a one-shot signal — you're buying access to a model that gets sharper with every call. PFE win rate has improved monotonically since launch; verifiable on Base L2.
|
|
66
84
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
85
|
+
- **🔌 Drop-in client matrix enumerated.** Streamable HTTP at `api.algovault.com/mcp` works with Claude Desktop, Claude Code, Cursor, Cline, and every other MCP-spec-compliant client. See the [Drop-in section](#drop-in-for-every-mcp-client). No SDK; no wrapper library; protocol is the API.
|
|
86
|
+
|
|
87
|
+
- **📄 New `/how-it-works` page.** Substrate-level docs page now live at [algovault.com/how-it-works](https://algovault.com/how-it-works). Explains what AlgoVault is at the technical level for devs evaluating one click below the landing hero.
|
|
88
|
+
|
|
89
|
+
> **Upgrading from v1.10.x or earlier?** The MCP tool surface is unchanged structurally — `get_trade_call`, `scan_funding_arb`, `get_market_regime` keep their parameter shapes. The only behavioral diff: omitting `exchange` now returns the Binance result instead of Hyperliquid. Existing agents passing `exchange` explicitly are unaffected. MCP clients (Claude Desktop, Cursor, Cline) cache the tool list at session start — toggle the connector off/on to pick up the new default-routing behavior.
|
|
70
90
|
|
|
71
91
|
---
|
|
72
92
|
|
|
@@ -74,7 +94,7 @@ Live since 2026-05-08:
|
|
|
74
94
|
|
|
75
95
|
Most MCP trading servers give you raw data — prices, order books, candles. Your agent still has to figure out what to do with it.
|
|
76
96
|
|
|
77
|
-
AlgoVault is different. We give your agent **one answer**: a directional verdict with a confidence score,
|
|
97
|
+
AlgoVault is different. We give your agent **one answer**: a directional verdict with a confidence score, produced by a self-tuning quant ML model whose weights are calibrated from published trade outcomes. Every call is tracked, every outcome is measured, and the full track record is on-chain from day one.
|
|
78
98
|
|
|
79
99
|
**What makes this not just another indicator wrapper:**
|
|
80
100
|
|
|
@@ -82,8 +102,8 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
|
|
|
82
102
|
- **Regime-aware call generation.** Calls are filtered through a market regime classifier before emission. The engine knows when to stay silent — a trend-following setup in a ranging market gets suppressed, not broadcast. (HOLD rate ~99%; we issue calls only when the edge is clear.) <!-- SNAPSHOT-LINE -->
|
|
83
103
|
- **Cross-venue intelligence.** Full signal generation on 5 exchanges 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. <!-- SNAPSHOT-LINE -->
|
|
84
104
|
- **Published track record with every release.** Every call is recorded with outcome prices at multiple horizons. PFE Win Rate, Profit Factor, Expected Value computed continuously. No cherry-picking, no survivorship bias. **Anchored on-chain on Base L2 — we cannot rewrite history.**
|
|
85
|
-
- **
|
|
86
|
-
- **Crypto + TradFi coverage.**
|
|
105
|
+
- **Self-tuning model.** Indicator weights are tuned from live outcome data by our [Autonomous Optimization Engine](https://algovault.com/how-it-works). The model gets sharper with every signal.
|
|
106
|
+
- **Crypto + TradFi coverage.** 730+ assets — standard crypto perps on all 5 venues; TradFi perps (stocks, indices, commodities, FX) on Binance, Bybit, Bitget, OKX, and Hyperliquid via demand-driven SHADOW-SEED-W1 fan-out; liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
|
|
87
107
|
|
|
88
108
|
---
|
|
89
109
|
|
|
@@ -118,14 +138,14 @@ That's it. Your Claude now has a quant analyst built in.
|
|
|
118
138
|
|
|
119
139
|
### `get_trade_call` <sub>(alias: `get_trade_signal`)</sub>
|
|
120
140
|
|
|
121
|
-
Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any supported asset on any of 5 supported exchanges — crypto perps, TradFi
|
|
141
|
+
Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any supported asset on any of 5 supported exchanges — crypto perps, TradFi perps (stocks, indices, commodities, FX) on Binance / Bybit / Bitget / OKX / Hyperliquid, and liquidity-filtered meme coins.
|
|
122
142
|
|
|
123
|
-
Under the hood: a
|
|
143
|
+
Under the hood: a self-tuning quant ML model evaluates momentum, trend structure, derivatives sentiment, open interest dynamics, and volume conviction. Scores pass through regime-aware filters and adaptive post-processing gates before a final verdict is emitted. Only high-conviction calls are generated; the model stays silent when the edge is unclear.
|
|
124
144
|
|
|
125
145
|
**Parameters:**
|
|
126
146
|
- `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 710+ supported assets <!-- SNAPSHOT-LINE -->
|
|
127
|
-
- `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
|
|
128
|
-
- `exchange` (string, default `"
|
|
147
|
+
- `timeframe` (string, default `"15m"`): all 11 timeframes — `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
|
|
148
|
+
- `exchange` (string, default `"BINANCE"`): `"BINANCE"`, `"HL"` (Hyperliquid), `"BYBIT"`, `"OKX"`, `"BITGET"`. Asset availability varies per venue — pass exchange explicitly to target a specific venue.
|
|
129
149
|
- `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
|
|
130
150
|
|
|
131
151
|
**Output:** v1.10.0 sanitized shape — `call` direction, `confidence` (0–100), bucketed `indicators` (`funding_rate` / `funding_24h_avg` / `funding_state` / `oi_change_pct` / `volume_24h` / `trend_persistence` / `breakout_pending`), detected `regime`, sanitized `reasoning` prose, and `_algovault` metadata for downstream tool composability.
|
|
@@ -158,7 +178,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
|
|
|
158
178
|
{ "coin": "SOL", "timeframe": "15m", "confidence": 73 }
|
|
159
179
|
],
|
|
160
180
|
"_algovault": {
|
|
161
|
-
"version": "1.
|
|
181
|
+
"version": "1.11.0",
|
|
162
182
|
"tool": "get_trade_call",
|
|
163
183
|
"compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
|
|
164
184
|
}
|
|
@@ -186,20 +206,12 @@ Combines directional strength measurement with ADX slope analysis (detecting tre
|
|
|
186
206
|
**Parameters:**
|
|
187
207
|
- `coin` (string, required): Asset symbol
|
|
188
208
|
- `timeframe` (string, default `"4h"`): Candle timeframe for analysis
|
|
189
|
-
- `exchange` (string, default `"
|
|
209
|
+
- `exchange` (string, default `"BINANCE"`): Exchange to analyze — same options as `get_trade_call`
|
|
190
210
|
|
|
191
211
|
**Output includes:** regime label, confidence score, underlying metrics (trend strength, volatility interpretation, price structure), cross-venue funding sentiment, and a plain-English strategy suggestion.
|
|
192
212
|
|
|
193
213
|
---
|
|
194
214
|
|
|
195
|
-
## Free Telegram bot — `@algovaultofficialbot`
|
|
196
|
-
|
|
197
|
-
Want regime alerts + AlgoVault trade calls (BUY / SELL) pushed to a Telegram chat without writing any code? Open Telegram → search `@algovaultofficialbot` → `/start`. The bot is a thin client over this same MCP server — the same composite-verdict signal stream, no extra subscription, your free 100-calls/mo quota is shared with bot-driven calls.
|
|
198
|
-
|
|
199
|
-
Source: [github.com/AlgoVaultLabs/algovault-bot](https://github.com/AlgoVaultLabs/algovault-bot).
|
|
200
|
-
|
|
201
|
-
---
|
|
202
|
-
|
|
203
215
|
## When You Hit the Free Limit
|
|
204
216
|
|
|
205
217
|
Free tier is 100 calls per calendar month. **HOLD calls don't count against it** — you only consume quota on BUY/SELL verdicts.
|
|
@@ -227,7 +239,7 @@ or pay per call via x402.
|
|
|
227
239
|
| Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
|
|
228
240
|
|---------|------|-------------------|-------------|---------------------|-----------------|
|
|
229
241
|
| Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
|
|
230
|
-
| Assets | All
|
|
242
|
+
| Assets | All 730+ | All 730+ | All 730+ | All 730+ | All 730+ | <!-- SNAPSHOT-LINE-TABLE -->
|
|
231
243
|
| Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
|
|
232
244
|
| Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
|
|
233
245
|
| Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
|
|
@@ -336,7 +348,7 @@ Every call is hashed (keccak256) at creation time and anchored on Base L2 via da
|
|
|
336
348
|
https://api.algovault.com/mcp
|
|
337
349
|
```
|
|
338
350
|
|
|
339
|
-
Streamable HTTP transport. Compatible with any MCP client — Claude, Cursor, Cline, custom agents.
|
|
351
|
+
Streamable HTTP transport. Compatible with any MCP-spec client — Claude Desktop, Claude Code, Cursor, Cline, custom agents. No SDK or wrapper library required; MCP is the API.
|
|
340
352
|
|
|
341
353
|
### Local install via npx
|
|
342
354
|
|
|
@@ -358,6 +370,12 @@ npx -y crypto-quant-signal-mcp
|
|
|
358
370
|
}
|
|
359
371
|
```
|
|
360
372
|
|
|
373
|
+
### Claude Code CLI
|
|
374
|
+
|
|
375
|
+
```bash
|
|
376
|
+
claude mcp add crypto-quant-signal https://api.algovault.com/mcp
|
|
377
|
+
```
|
|
378
|
+
|
|
361
379
|
### npm install
|
|
362
380
|
|
|
363
381
|
```bash
|
|
@@ -379,7 +397,7 @@ docker compose up -d
|
|
|
379
397
|
## Architecture
|
|
380
398
|
|
|
381
399
|
```
|
|
382
|
-
Agent / Claude / Cursor
|
|
400
|
+
Agent / Claude Desktop / Claude Code / Cursor / Cline / any MCP client
|
|
383
401
|
│
|
|
384
402
|
▼
|
|
385
403
|
api.algovault.com/mcp (Streamable HTTP)
|
|
@@ -391,18 +409,21 @@ api.algovault.com/mcp (Streamable HTTP)
|
|
|
391
409
|
▼
|
|
392
410
|
MCP Server (Express + @modelcontextprotocol/sdk)
|
|
393
411
|
│
|
|
394
|
-
├─
|
|
412
|
+
├─ Self-Tuning Quant ML Model
|
|
395
413
|
│ ├─ Multi-factor indicator fusion
|
|
396
414
|
│ ├─ Regime-aware signal filtering
|
|
397
415
|
│ └─ Adaptive post-processing gates
|
|
398
416
|
│
|
|
417
|
+
├─ Autonomous Optimization Engine (results published; mechanics confidential)
|
|
418
|
+
│ └─ Closed-loop weight tuning from published outcomes
|
|
419
|
+
│
|
|
399
420
|
├─ Asset Classification Engine
|
|
400
421
|
│ ├─ 4-tier quality system (Blue Chip → Major Alt → TradFi → Meme)
|
|
401
422
|
│ └─ Liquidity filter for meme/micro assets
|
|
402
423
|
│
|
|
403
424
|
├─ Exchange Adapter Layer
|
|
404
|
-
│ ├─
|
|
405
|
-
│ ├─
|
|
425
|
+
│ ├─ Binance USDT-M Futures (default)
|
|
426
|
+
│ ├─ Hyperliquid (crypto + TradFi perps)
|
|
406
427
|
│ ├─ Bybit Linear
|
|
407
428
|
│ ├─ OKX Swap
|
|
408
429
|
│ └─ Bitget USDT-M
|
|
@@ -448,7 +469,8 @@ MIT
|
|
|
448
469
|
<p align="center">
|
|
449
470
|
Built by <a href="https://algovault.com"><strong>AlgoVault Labs</strong></a><br/>
|
|
450
471
|
<a href="https://algovault.com">algovault.com</a> ·
|
|
472
|
+
<a href="https://algovault.com/how-it-works">how it works</a> ·
|
|
451
473
|
<a href="https://algovault.com/track-record">track-record</a> ·
|
|
452
474
|
<a href="https://api.algovault.com/mcp">MCP endpoint</a> ·
|
|
453
|
-
<a href="https://
|
|
475
|
+
<a href="https://t.me/algovaultofficialbot">Telegram bot</a>
|
|
454
476
|
</p>
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AA2mEtF,wBAAgB,mBAAmB,cAElC"}
|