crypto-quant-signal-mcp 1.10.7 → 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 +59 -32
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +670 -219
- 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 +1 -0
- package/dist/lib/analytics.d.ts.map +1 -1
- package/dist/lib/analytics.js +42 -5
- 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/bot-auth.d.ts +18 -0
- package/dist/lib/bot-auth.d.ts.map +1 -0
- package/dist/lib/bot-auth.js +28 -0
- package/dist/lib/bot-auth.js.map +1 -0
- 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/license.d.ts +2 -2
- package/dist/lib/license.d.ts.map +1 -1
- package/dist/lib/license.js +41 -4
- package/dist/lib/license.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.d.ts +13 -0
- package/dist/lib/welcome-page.d.ts.map +1 -0
- package/dist/lib/welcome-page.js +79 -0
- package/dist/lib/welcome-page.js.map +1 -0
- 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 +24 -10
- 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,26 +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` |
|
|
70
|
+
|
|
71
|
+
MCP `tools/list` + `resources/list` is the API surface. No `@algovault/sdk`; the protocol is the contract.
|
|
58
72
|
|
|
59
73
|
---
|
|
60
74
|
|
|
61
|
-
## What's new in v1.
|
|
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 -->
|
|
80
|
+
|
|
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.
|
|
82
|
+
|
|
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.
|
|
62
84
|
|
|
63
|
-
|
|
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.
|
|
64
86
|
|
|
65
|
-
-
|
|
66
|
-
- **Free-tier exhaustion path** — when an agent hits the 100-calls/month cap, the response includes a direct upgrade link: `Free tier limit reached (X/100 calls this month). Upgrade to Starter ($9.99/mo) for 3,000 calls/mo, or pay per call via x402. → https://api.algovault.com/signup?plan=starter`
|
|
67
|
-
- **Output-sanitization v1** — composite-verdict-reverse-engineering surface closed (`rsi`, `ema_*`, `hurst`, `funding_z_score`, `squeeze_active` stripped from public response). `_algovault` metadata block + `also_see` cross-asset leads remain.
|
|
68
|
-
- **Connect-Your-MCP-Client docs** — Claude Desktop, Cursor, Cline, Claude Code, Smithery, plain HTTP/curl walkthroughs at [`algovault.com/docs.html#connect-mcp`](https://algovault.com/docs.html#connect-mcp).
|
|
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.
|
|
69
88
|
|
|
70
|
-
> **Upgrading from v1.
|
|
71
|
-
> - **Claude.ai / Claude Desktop**: Settings → Connectors → AlgoVault → toggle off + on
|
|
72
|
-
> - **Cursor / Cline**: restart the MCP server connection from the integration panel
|
|
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.
|
|
73
90
|
|
|
74
91
|
---
|
|
75
92
|
|
|
@@ -77,7 +94,7 @@ Live since 2026-05-06:
|
|
|
77
94
|
|
|
78
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.
|
|
79
96
|
|
|
80
|
-
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.
|
|
81
98
|
|
|
82
99
|
**What makes this not just another indicator wrapper:**
|
|
83
100
|
|
|
@@ -85,8 +102,8 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
|
|
|
85
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 -->
|
|
86
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 -->
|
|
87
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.**
|
|
88
|
-
- **
|
|
89
|
-
- **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 -->
|
|
90
107
|
|
|
91
108
|
---
|
|
92
109
|
|
|
@@ -121,14 +138,14 @@ That's it. Your Claude now has a quant analyst built in.
|
|
|
121
138
|
|
|
122
139
|
### `get_trade_call` <sub>(alias: `get_trade_signal`)</sub>
|
|
123
140
|
|
|
124
|
-
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.
|
|
125
142
|
|
|
126
|
-
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.
|
|
127
144
|
|
|
128
145
|
**Parameters:**
|
|
129
146
|
- `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 710+ supported assets <!-- SNAPSHOT-LINE -->
|
|
130
|
-
- `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
|
|
131
|
-
- `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.
|
|
132
149
|
- `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
|
|
133
150
|
|
|
134
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.
|
|
@@ -161,7 +178,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
|
|
|
161
178
|
{ "coin": "SOL", "timeframe": "15m", "confidence": 73 }
|
|
162
179
|
],
|
|
163
180
|
"_algovault": {
|
|
164
|
-
"version": "1.
|
|
181
|
+
"version": "1.11.0",
|
|
165
182
|
"tool": "get_trade_call",
|
|
166
183
|
"compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
|
|
167
184
|
}
|
|
@@ -189,7 +206,7 @@ Combines directional strength measurement with ADX slope analysis (detecting tre
|
|
|
189
206
|
**Parameters:**
|
|
190
207
|
- `coin` (string, required): Asset symbol
|
|
191
208
|
- `timeframe` (string, default `"4h"`): Candle timeframe for analysis
|
|
192
|
-
- `exchange` (string, default `"
|
|
209
|
+
- `exchange` (string, default `"BINANCE"`): Exchange to analyze — same options as `get_trade_call`
|
|
193
210
|
|
|
194
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.
|
|
195
212
|
|
|
@@ -222,7 +239,7 @@ or pay per call via x402.
|
|
|
222
239
|
| Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
|
|
223
240
|
|---------|------|-------------------|-------------|---------------------|-----------------|
|
|
224
241
|
| Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
|
|
225
|
-
| Assets | All
|
|
242
|
+
| Assets | All 730+ | All 730+ | All 730+ | All 730+ | All 730+ | <!-- SNAPSHOT-LINE-TABLE -->
|
|
226
243
|
| Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
|
|
227
244
|
| Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
|
|
228
245
|
| Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
|
|
@@ -331,7 +348,7 @@ Every call is hashed (keccak256) at creation time and anchored on Base L2 via da
|
|
|
331
348
|
https://api.algovault.com/mcp
|
|
332
349
|
```
|
|
333
350
|
|
|
334
|
-
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.
|
|
335
352
|
|
|
336
353
|
### Local install via npx
|
|
337
354
|
|
|
@@ -353,6 +370,12 @@ npx -y crypto-quant-signal-mcp
|
|
|
353
370
|
}
|
|
354
371
|
```
|
|
355
372
|
|
|
373
|
+
### Claude Code CLI
|
|
374
|
+
|
|
375
|
+
```bash
|
|
376
|
+
claude mcp add crypto-quant-signal https://api.algovault.com/mcp
|
|
377
|
+
```
|
|
378
|
+
|
|
356
379
|
### npm install
|
|
357
380
|
|
|
358
381
|
```bash
|
|
@@ -374,7 +397,7 @@ docker compose up -d
|
|
|
374
397
|
## Architecture
|
|
375
398
|
|
|
376
399
|
```
|
|
377
|
-
Agent / Claude / Cursor
|
|
400
|
+
Agent / Claude Desktop / Claude Code / Cursor / Cline / any MCP client
|
|
378
401
|
│
|
|
379
402
|
▼
|
|
380
403
|
api.algovault.com/mcp (Streamable HTTP)
|
|
@@ -386,18 +409,21 @@ api.algovault.com/mcp (Streamable HTTP)
|
|
|
386
409
|
▼
|
|
387
410
|
MCP Server (Express + @modelcontextprotocol/sdk)
|
|
388
411
|
│
|
|
389
|
-
├─
|
|
412
|
+
├─ Self-Tuning Quant ML Model
|
|
390
413
|
│ ├─ Multi-factor indicator fusion
|
|
391
414
|
│ ├─ Regime-aware signal filtering
|
|
392
415
|
│ └─ Adaptive post-processing gates
|
|
393
416
|
│
|
|
417
|
+
├─ Autonomous Optimization Engine (results published; mechanics confidential)
|
|
418
|
+
│ └─ Closed-loop weight tuning from published outcomes
|
|
419
|
+
│
|
|
394
420
|
├─ Asset Classification Engine
|
|
395
421
|
│ ├─ 4-tier quality system (Blue Chip → Major Alt → TradFi → Meme)
|
|
396
422
|
│ └─ Liquidity filter for meme/micro assets
|
|
397
423
|
│
|
|
398
424
|
├─ Exchange Adapter Layer
|
|
399
|
-
│ ├─
|
|
400
|
-
│ ├─
|
|
425
|
+
│ ├─ Binance USDT-M Futures (default)
|
|
426
|
+
│ ├─ Hyperliquid (crypto + TradFi perps)
|
|
401
427
|
│ ├─ Bybit Linear
|
|
402
428
|
│ ├─ OKX Swap
|
|
403
429
|
│ └─ Bitget USDT-M
|
|
@@ -443,7 +469,8 @@ MIT
|
|
|
443
469
|
<p align="center">
|
|
444
470
|
Built by <a href="https://algovault.com"><strong>AlgoVault Labs</strong></a><br/>
|
|
445
471
|
<a href="https://algovault.com">algovault.com</a> ·
|
|
472
|
+
<a href="https://algovault.com/how-it-works">how it works</a> ·
|
|
446
473
|
<a href="https://algovault.com/track-record">track-record</a> ·
|
|
447
474
|
<a href="https://api.algovault.com/mcp">MCP endpoint</a> ·
|
|
448
|
-
<a href="https://
|
|
475
|
+
<a href="https://t.me/algovaultofficialbot">Telegram bot</a>
|
|
449
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"}
|