crypto-quant-signal-mcp 1.10.6 → 1.10.8

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 CHANGED
@@ -1,44 +1,72 @@
1
1
  <p align="center">
2
- <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/logo.png" alt="AlgoVault" width="120" />
2
+ <a href="https://algovault.com">
3
+ <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/logo.png" alt="AlgoVault" width="120" />
4
+ </a>
3
5
  </p>
4
6
 
5
- # crypto-quant-signal-mcp
7
+ <h1 align="center">crypto-quant-signal-mcp</h1>
6
8
 
7
- The Brain 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. <!-- SNAPSHOT-LINE -->
8
-
9
- [![npm version](https://img.shields.io/npm/v/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
10
- [![npm downloads](https://img.shields.io/npm/dw/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
12
- [![On-Chain Verified](https://img.shields.io/badge/Track_Record-On--Chain_Verified-blue?logo=ethereum)](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81)
9
+ <p align="center">
10
+ <strong>The Brain Layer for AI Trading Agents</strong><br/>
11
+ Composite quant trade calls · cross-venue funding arbitrage · regime-aware market classification<br/>
12
+ Across 5 exchanges (Hyperliquid · Binance · Bybit · OKX · Bitget) via MCP. <!-- SNAPSHOT-LINE -->
13
+ </p>
13
14
 
14
- **[Live Track Record](https://algovault.com/track-record)** — 89.4%+ PFE Win Rate across 60,000+ trade calls on 5 exchanges. Public, no login required. <!-- SNAPSHOT-LINE -->
15
+ <p align="center">
16
+ <a href="https://algovault.com"><strong>algovault.com</strong></a> ·
17
+ <a href="https://algovault.com/track-record"><strong>Live Track Record</strong></a> ·
18
+ <a href="https://api.algovault.com/signup"><strong>Sign Up</strong></a> ·
19
+ <a href="https://algovault.com/docs.html"><strong>Docs</strong></a>
20
+ </p>
15
21
 
16
- <!-- snapshot: 2026-04-28 — live source of truth: https://algovault.com/api/performance-public — refetch before citing exact numbers -->
22
+ <p align="center">
23
+ <a href="https://www.npmjs.com/package/crypto-quant-signal-mcp"><img src="https://img.shields.io/npm/v/crypto-quant-signal-mcp" alt="npm version" /></a>
24
+ <a href="https://www.npmjs.com/package/crypto-quant-signal-mcp"><img src="https://img.shields.io/npm/dw/crypto-quant-signal-mcp" alt="npm downloads" /></a>
25
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT" /></a>
26
+ <a href="https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81"><img src="https://img.shields.io/badge/Track_Record-On--Chain_Verified-blue?logo=ethereum" alt="On-Chain Verified" /></a>
27
+ </p>
17
28
 
18
29
  ---
19
30
 
20
- ## What's new in v1.10.3
31
+ ## 📊 Live Track Record — Public, Verifiable, On-Chain
21
32
 
22
- Live since 2026-04-30:
33
+ <p align="center">
34
+ <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-06.png" alt="AlgoVault Live Track Record — 90.0% PFE Win Rate across 74,733 trade calls, 26 Merkle batches anchored on Base L2" width="100%" />
36
+ </a>
37
+ </p>
23
38
 
24
- - **Free tier unlocked** — every supported coin + every supported timeframe is now accessible at the free tier (was BTC/ETH only on 15m/1h). The 100-calls/month cap is the only ceiling. HOLD calls remain free at every tier. All 11 timeframes (`1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d`) are callable on demand — your first call for `SOL/4h` or `PEPE/15m` Just Works.
25
- - **`Connect Your MCP Client` docs section** — new walkthroughs for Claude Desktop, Cursor, Cline, Claude Code, Smithery, and plain HTTP/curl at [`algovault.com/docs.html#connect-mcp`](https://algovault.com/docs.html#connect-mcp). Every config snippet was web-verified against the upstream docs on 2026-04-30.
39
+ <p align="center">
40
+ <strong><span data-tr-field="pfe_wr">90.0%</span> PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">74,733</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">26</span> on-chain batches</strong> · <strong><span data-tr-field="hold_rate">99%</span> HOLD rate</strong> <!-- SNAPSHOT-LINE -->
41
+ </p>
26
42
 
27
- > **Upgrading from v1.9.x or earlier?** MCP clients (Claude Desktop, Claude.ai custom connectors, Cursor, Cline) cache the tool list at session start. The free-tier behavior changed in v1.10.3 — even though no tool was renamed, **refresh your tool list** so the client picks up the new permissive responses:
28
- > - **Claude.ai / Claude Desktop**: Settings → Connectors → AlgoVault → toggle off + on (or click "Refresh tools")
29
- > - **Cursor / Cline**: restart the MCP server connection from the integration panel
30
- >
31
- > Cached tool responses from before the unlock may still surface "requires Starter" upgrade hints on free-tier calls. Refreshing fixes it instantly. (See the v1.10.0 entry below for the prior `signal → call` rename context, also subject to this same refresh recipe.)
43
+ <p align="center">
44
+ Every call is hashed at emission, anchored on Base L2 daily, and re-evaluated against actual price action. We can't edit history. <em>Refetch live numbers any time at <a href="https://algovault.com/track-record">algovault.com/track-record</a> or <a href="https://api.algovault.com/api/performance-public">/api/performance-public</a>.</em>
45
+ </p>
46
+
47
+ <p align="center">
48
+ <a href="https://algovault.com/track-record"><strong>→ Open the live dashboard</strong></a>
49
+ </p>
32
50
 
33
51
  ---
34
52
 
35
- ## What's new in v1.10.0
53
+ ## What's new in v1.10.8
54
+
55
+ Live since 2026-05-08:
56
+
57
+ - **🤖 Public Telegram bot — [@algovaultofficialbot](https://t.me/algovaultofficialbot).** AlgoVault verdicts now push to your phone. Set a watchlist with `/watch BTC 4h` and the bot delivers regime shifts and BUY/SELL trade calls in real time. Built on the same composite-verdict signal stream that powers the MCP — same 90.0% PFE win rate, same on-chain track record, now in your pocket. <!-- SNAPSHOT-LINE -->
58
+
59
+ - **📱 One-click link from `/welcome`.** After Stripe checkout, the welcome page shows a "Connect @algovaultofficialbot" button. One click binds your Telegram chat to your subscription — your paid tier unlocks unlimited bot pushes instantly, no API-key copy-paste, no auth dance. Free-tier users get 100 trade-call alerts/month before the upgrade prompt fires.
60
+
61
+ - **🧠 Smart routing built in.** HOLD verdicts stay silent (no spam, no quota tick). Regime alerts are flap-suppressed — fires only after 2 consecutive same-regime confirmations, so you get the shift, not the noise. Per-timeframe dispatch means a 1-minute pair fires every minute and a daily pair fires once a day — you control the cadence by what you watch.
62
+
63
+ - **🌐 Full coverage parity.** Every asset (720+), every timeframe (1m → 1d), every exchange (HL · Binance · Bybit · OKX · Bitget) — all callable from the bot, same as the API. Pick what you want to track; the bot handles the polling.
36
64
 
37
- Live since 2026-04-28:
65
+ - **📈 Trade calls that count cleanly.** Bot-pushed BUY/SELL alerts tick your free-tier monthly cap (matching the API's 100/mo) and stop ticking the moment your subscription is linked. No double-counting, no surprise overage — your real Stripe-backed quota (3K/15K/100K) governs everything.
38
66
 
39
- - **`signal` → `call`** rename across the response shape, the tool name (`get_trade_call`), and the public dashboard. `get_trade_signal` is registered as an alias and continues to work for existing agents — no migration needed.
40
- - **`also_see` cross-asset leads** replace `try_next` with cells trimmed to `{coin, timeframe, confidence}`. Direction requires another call.
41
- - **5-exchange + 20-skill catalog refresh** below.
67
+ > **Upgrading from v1.10.6 or earlier?** MCP clients (Claude Desktop, Claude.ai custom connectors, Cursor, Cline) cache the tool list at session start. The MCP tool surface is unchanged in v1.10.8, but if you signed up before today and want bot access:
68
+ > - **Already a subscriber?** Visit your `/welcome` link from the original signup email — the new button lives there. Or hit `api.algovault.com/account` to recover your key, then sign up at [@algovaultofficialbot](https://t.me/algovaultofficialbot).
69
+ > - **Free tier?** [Start the bot](https://t.me/algovaultofficialbot), `/watch` your first asset, get free regime alerts forever and 100 trade-call alerts/month.
42
70
 
43
71
  ---
44
72
 
@@ -50,12 +78,12 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
50
78
 
51
79
  **What makes this not just another indicator wrapper:**
52
80
 
53
- - **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.
54
- - **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.
55
- - **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. <!-- SNAPSHOT-LINE -->
56
- - **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.
57
- - **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.
58
- - **Crypto + TradFi coverage.** 710+ 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. <!-- SNAPSHOT-LINE -->
81
+ - **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. Weights are calibrated from live market outcome data, not textbook defaults.
82
+ - **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
+ - **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
+ - **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
+ - **Adaptive scoring.** Indicator weights are retuned monthly from outcome data via the [Autonomous Optimization Engine](https://algovault.com/track-record). The engine learns what works.
86
+ - **Crypto + TradFi coverage.** 720+ assets — standard crypto perps on all 5 venues, TradFi perpetuals (stocks, indices, commodities, FX) on Hyperliquid, liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
59
87
 
60
88
  ---
61
89
 
@@ -94,19 +122,17 @@ Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any
94
122
 
95
123
  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 before a final verdict is emitted. Only high-conviction calls are generated; the engine stays silent when the edge is unclear.
96
124
 
97
- > Tool name `get_trade_signal` remains registered as an alias for backward compatibility — agents using the old name continue to work without changes. New integrations should call `get_trade_call`.
98
-
99
125
  **Parameters:**
100
- - `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 290+ supported assets <!-- SNAPSHOT-LINE -->
126
+ - `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 710+ supported assets <!-- SNAPSHOT-LINE -->
101
127
  - `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
102
128
  - `exchange` (string, default `"HL"`): `"HL"` (Hyperliquid), `"BINANCE"`, `"BYBIT"`, `"OKX"`, `"BITGET"`. TradFi assets (GOLD, TSLA, etc.) are HL-only.
103
129
  - `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
104
130
 
105
- **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. The seven raw indicator fields (`rsi`, `ema_*`, `hurst`, `funding_z_score`, `squeeze_active`) were stripped in v1.10.0 to close composite-verdict reverse-engineering.
131
+ **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.
106
132
 
107
- Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also_see` (top-3 cross-asset leads when the grid has non-HOLD cells), both trimmed to `{coin, timeframe, confidence}` only — direction requires another `get_trade_call` invocation.
133
+ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also_see` (top-3 cross-asset leads), trimmed to `{coin, timeframe, confidence}` only — direction requires another `get_trade_call` invocation.
108
134
 
109
- **Example response (v1.10.0):**
135
+ **Example response:**
110
136
 
111
137
  ```json
112
138
  {
@@ -132,7 +158,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
132
158
  { "coin": "SOL", "timeframe": "15m", "confidence": 73 }
133
159
  ],
134
160
  "_algovault": {
135
- "version": "1.10.0",
161
+ "version": "1.10.7",
136
162
  "tool": "get_trade_call",
137
163
  "compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
138
164
  }
@@ -141,31 +167,84 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
141
167
 
142
168
  ### `scan_funding_arb`
143
169
 
144
- 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.
170
+ Scans cross-venue funding rate differentials across Hyperliquid, Binance, and Bybit. Normalizes hourly vs 8-hour rate conventions, computes basis-point spreads, ranks opportunities by composite score (spread magnitude, time urgency, funding conviction from 24h history). OKX and Bitget funding data is available via their respective adapters — arb scanning expansion is planned.
145
171
 
146
- This is the only MCP server that provides cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
172
+ This is the only MCP server providing cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
147
173
 
148
174
  **Parameters:**
149
175
  - `minSpreadBps` (number, default `5`): Minimum spread in basis points to include
150
- - `limit` (number, default `10`): Maximum results returned
176
+ - `limit` (number, default `10`): Maximum results returned (free tier capped at 5)
151
177
 
152
178
  **Output includes:** per-opportunity venue rates, optimal long/short direction, annualized spread percentage, and next funding timestamps.
153
179
 
154
180
  ### `get_market_regime`
155
181
 
156
- Classifies the current market environment into one of four regimes: **TRENDING_UP**, **TRENDING_DOWN**, **RANGING**, or **VOLATILE**.
182
+ Classifies the current market environment: **TRENDING_UP**, **TRENDING_DOWN**, **RANGING**, or **VOLATILE**.
157
183
 
158
- 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_call` filters its output — agents can also use it independently for strategy selection and position sizing.
184
+ Combines 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_call` filters its output — agents can also use it independently for strategy selection and position sizing.
159
185
 
160
186
  **Parameters:**
161
187
  - `coin` (string, required): Asset symbol
162
188
  - `timeframe` (string, default `"4h"`): Candle timeframe for analysis
163
- - `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_call
189
+ - `exchange` (string, default `"HL"`): Exchange to analyze — same options as `get_trade_call`
164
190
 
165
191
  **Output includes:** regime label, confidence score, underlying metrics (trend strength, volatility interpretation, price structure), cross-venue funding sentiment, and a plain-English strategy suggestion.
166
192
 
167
193
  ---
168
194
 
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
+ ## When You Hit the Free Limit
204
+
205
+ Free tier is 100 calls per calendar month. **HOLD calls don't count against it** — you only consume quota on BUY/SELL verdicts.
206
+
207
+ When the cap is reached, the next call's response includes:
208
+
209
+ ```
210
+ Free tier limit reached (100/100 calls this month).
211
+ Upgrade to Starter ($9.99/mo) for 3,000 calls/mo,
212
+ or pay per call via x402.
213
+ → https://api.algovault.com/signup?plan=starter
214
+ ```
215
+
216
+ **Two zero-friction upgrade paths:**
217
+
218
+ | Path | When to use | Friction |
219
+ |------|-------------|----------|
220
+ | **Starter $9.99/mo** | Your agent runs on a known schedule (cron, hourly digests, daily scans). | Stripe checkout · API key delivered instantly · [signup →](https://api.algovault.com/signup?plan=starter) |
221
+ | **x402 micropayment** | Your agent is autonomous and pays per call in USDC on Base. No signup. | Wallet · ~$0.01–0.05 per BUY/SELL · zero account state · [x402.org](https://x402.org) |
222
+
223
+ ---
224
+
225
+ ## Pricing
226
+
227
+ | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
228
+ |---------|------|-------------------|-------------|---------------------|-----------------|
229
+ | Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
230
+ | Assets | All 720+ | All 720+ | All 720+ | All 720+ | All 720+ | <!-- SNAPSHOT-LINE-TABLE -->
231
+ | Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
232
+ | Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
233
+ | Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
234
+ | Track record | Full access | Full access | Full access | Full access | Full access |
235
+ | Monthly calls | 100/mo | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
236
+ | Support | Community | Email | Priority | Dedicated | — |
237
+ | Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
238
+ | HOLD calls | Free | Free | Free | Free | Free |
239
+
240
+ \* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction. We only get paid when we see a tradeable opportunity.
241
+
242
+ **Subscriptions:** Sign up at [api.algovault.com/signup](https://api.algovault.com/signup). Starter ($9.99/mo) unlocks 3,000 calls/mo. API key delivered instantly after checkout.
243
+
244
+ **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).
245
+
246
+ ---
247
+
169
248
  ## Integrations
170
249
 
171
250
  End-to-end tutorials pairing AlgoVault with each major exchange's Agent Trade Kit. AlgoVault returns the analytics; the agent's risk policy decides what to execute. **All demos run testnet/demo only — zero real-money risk.**
@@ -179,19 +258,20 @@ End-to-end tutorials pairing AlgoVault with each major exchange's Agent Trade Ki
179
258
  | 04 | Bitget | [`docs/integrations/bitget.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/bitget.md) | [`examples/bitget/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/bitget/demo.mjs) | [algovault.com/docs/integrations/bitget](https://algovault.com/docs/integrations/bitget) |
180
259
  <!-- /BUILD:README_INTEGRATIONS_TABLE -->
181
260
 
182
- Distribution surface tracker: [`algovault-skills/docs/INTEGRATIONS_DISTRIBUTION.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/INTEGRATIONS_DISTRIBUTION.md).
183
-
184
261
  ---
185
262
 
186
- ## Skills
263
+ ## Skills (20 ready-to-use Anthropic Agent Skills)
187
264
 
188
- 20 ready-to-use Anthropic Agent Skills wrapping the AlgoVault MCP server. Each Skill is a single-prompt wrapper over 1–3 tool calls — composite verdicts, regime gating, multi-timeframe consensus, funding-arb monitoring, and more.
265
+ 20 single-prompt wrappers over 1–3 AlgoVault tool calls — composite verdicts, regime gating, multi-timeframe consensus, funding-arb monitoring, and more.
189
266
 
190
267
  ```bash
191
268
  claude plugin install AlgoVaultLabs/algovault-skills
192
269
  ```
193
270
 
194
- Browse the full catalog at <https://algovault.com/skills> or <https://github.com/AlgoVaultLabs/algovault-skills>.
271
+ Browse the full catalog at [algovault.com/skills](https://algovault.com/skills) or [github.com/AlgoVaultLabs/algovault-skills](https://github.com/AlgoVaultLabs/algovault-skills).
272
+
273
+ <details>
274
+ <summary><strong>Show all 20 Skills</strong></summary>
195
275
 
196
276
  <!-- BUILD:README_SKILLS_TABLE -->
197
277
  | # | Slug | Name | Difficulty | Tools |
@@ -218,9 +298,11 @@ Browse the full catalog at <https://algovault.com/skills> or <https://github.com
218
298
  | 20 | [`multi-agent-war-room`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/multi-agent-war-room/SKILL.md) | Multi-Agent War Room | Expert | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
219
299
  <!-- /BUILD:README_SKILLS_TABLE -->
220
300
 
301
+ </details>
302
+
221
303
  ---
222
304
 
223
- ## Performance Tracking
305
+ ## Performance Tracking & On-Chain Verification
224
306
 
225
307
  Every call is tracked from emission to outcome. No exceptions.
226
308
 
@@ -232,47 +314,17 @@ Every call is tracked from emission to outcome. No exceptions.
232
314
  - Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
233
315
  - Running statistics per asset, timeframe, and quality tier
234
316
 
235
- **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.
236
-
237
- - **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.
238
-
239
- **Infrastructure:**
240
- - Remote mode: PostgreSQL with automated outcome backfill
241
- - Local mode: SQLite at `~/.crypto-quant-signal/performance.db`
242
- - Only high-confidence BUY/SELL calls are tracked — HOLD is excluded
243
- - Signals are tracked per exchange — the track record shows performance on each venue independently
317
+ **HOLD calls are free.** When the engine says "don't trade," you don't pay. Only BUY/SELL verdicts charge x402 or count against subscription quotas. Aligns incentives: we only get paid when we see a tradeable opportunity. Current HOLD rate ~99%. <!-- SNAPSHOT-LINE -->
244
318
 
245
319
  ### On-Chain Verification
246
320
 
247
- 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.
321
+ Every call is hashed (keccak256) at creation time and anchored on Base L2 via daily Merkle batches. The track record is tamper-proof — we cannot edit past calls.
248
322
 
249
323
  - **Contract**: [`0x6485...0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) (Base L2)
250
- - **Verify any call**: `https://api.algovault.com/api/verify-signal?signalId=<ID>`
251
- - **View all batches**: `https://api.algovault.com/api/merkle-batches`
324
+ - **Verify any call**: [`api.algovault.com/api/verify-signal?signalId=<ID>`](https://api.algovault.com/api/verify-signal)
325
+ - **View all batches**: [`api.algovault.com/api/merkle-batches`](https://api.algovault.com/api/merkle-batches)
252
326
  - **Visual verification**: [algovault.com/verify](https://algovault.com/verify)
253
-
254
- ---
255
-
256
- ## Pricing
257
-
258
- | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
259
- |---------|------|-------------------|-------------|---------------------|-----------------|
260
- | Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
261
- | Assets | All 710+ | All 710+ | All 710+ | All 710+ | All 710+ | <!-- SNAPSHOT-LINE-TABLE -->
262
- | Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
263
- | Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 | <!-- SNAPSHOT-LINE-TABLE -->
264
- | Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
265
- | Track record | Full access | Full access | Full access | Full access | Full access |
266
- | Monthly calls | 100/mo | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
267
- | Support | Community | Email | Priority | Dedicated | — |
268
- | Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
269
- | HOLD calls | Free | Free | Free | Free | Free |
270
-
271
- \* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction.
272
-
273
- **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).
274
-
275
- **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.
327
+ - **Live dashboard**: [algovault.com/track-record](https://algovault.com/track-record)
276
328
 
277
329
  ---
278
330
 
@@ -334,7 +386,7 @@ api.algovault.com/mcp (Streamable HTTP)
334
386
  │
335
387
  ├─ x402 payment verification (USDC on Base)
336
388
  ├─ API key / subscription check
337
- ├─ Free tier fallback
389
+ ├─ Free tier fallback (100 calls/mo, all assets, all timeframes)
338
390
  │
339
391
  ▼
340
392
  MCP Server (Express + @modelcontextprotocol/sdk)
@@ -361,8 +413,6 @@ MCP Server (Express + @modelcontextprotocol/sdk)
361
413
  └─ Exchange Public APIs (free, no auth — all 5 venues)
362
414
  ```
363
415
 
364
- **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. <!-- SNAPSHOT-LINE -->
365
-
366
416
  ---
367
417
 
368
418
  ## Suite Composability
@@ -395,6 +445,10 @@ MIT
395
445
 
396
446
  > **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.
397
447
 
398
- Built by [AlgoVault Labs](https://algovault.com)
399
-
400
- [Landing page](https://algovault.com) · [API endpoint](https://api.algovault.com/mcp)
448
+ <p align="center">
449
+ Built by <a href="https://algovault.com"><strong>AlgoVault Labs</strong></a><br/>
450
+ <a href="https://algovault.com">algovault.com</a> ·
451
+ <a href="https://algovault.com/track-record">track-record</a> ·
452
+ <a href="https://api.algovault.com/mcp">MCP endpoint</a> ·
453
+ <a href="https://api.algovault.com/signup">sign up</a>
454
+ </p>
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4mDpE,wBAAgB,mBAAmB,cAElC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqpDpE,wBAAgB,mBAAmB,cAElC"}
package/dist/index.js CHANGED
@@ -68,6 +68,8 @@ const analytics_summary_js_1 = require("./resources/analytics-summary.js");
68
68
  const skills_analytics_js_1 = require("./resources/skills-analytics.js");
69
69
  const stripe_js_1 = require("./lib/stripe.js");
70
70
  const errors_js_1 = require("./lib/errors.js");
71
+ const bot_auth_js_1 = require("./lib/bot-auth.js");
72
+ const welcome_page_js_1 = require("./lib/welcome-page.js");
71
73
  /**
72
74
  * Format a thrown error into the MCP tool-content payload. v1.10.2: when the
73
75
  * cause is `UpstreamRateLimitError`, emit a structured `{error_code, exchange,
@@ -143,6 +145,7 @@ function createServer() {
143
145
  verdict: result.call,
144
146
  confidence: result.confidence,
145
147
  ipHash: (0, license_js_1.getRequestIpHash)(),
148
+ isBotInternal: license.tier === 'internal',
146
149
  });
147
150
  const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
148
151
  if (sessionIdForCohort !== null) {
@@ -182,6 +185,7 @@ function createServer() {
182
185
  licenseTier: license.tier,
183
186
  responseTimeMs: Date.now() - startMs,
184
187
  ipHash: (0, license_js_1.getRequestIpHash)(),
188
+ isBotInternal: license.tier === 'internal',
185
189
  });
186
190
  const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
187
191
  if (sessionIdForCohort !== null) {
@@ -217,6 +221,7 @@ function createServer() {
217
221
  licenseTier: license.tier,
218
222
  responseTimeMs: Date.now() - startMs,
219
223
  ipHash: (0, license_js_1.getRequestIpHash)(),
224
+ isBotInternal: license.tier === 'internal',
220
225
  });
221
226
  const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
222
227
  if (sessionIdForCohort !== null) {
@@ -473,7 +478,7 @@ async function startHttp() {
473
478
  return res.status(400).send('Missing session_id');
474
479
  try {
475
480
  const { apiKey, tier, email } = await (0, stripe_js_1.getCustomerApiKey)(sessionId);
476
- res.send(getWelcomePageHtml(apiKey, tier, email));
481
+ res.send((0, welcome_page_js_1.getWelcomePageHtml)(apiKey, tier, email));
477
482
  }
478
483
  catch (err) {
479
484
  console.error('Welcome page error:', err instanceof Error ? err.message : err);
@@ -770,6 +775,29 @@ async function startHttp() {
770
775
  res.status(500).json({ error: 'Failed to load verify samples' });
771
776
  }
772
777
  });
778
+ // BOT-W2 / D1-C: bot validates api_keys it receives via /start auth_<key>
779
+ // deep-link from /welcome. Two-flag firewall reuses the W1 internal-bypass
780
+ // env (BOT_INTERNAL_BYPASS_ENABLED + ALGOVAULT_INTERNAL_BYPASS_KEY).
781
+ // NOT exposed via the MCP transport — this is a server-internal HTTP route.
782
+ app.get('/api/bot/validate-key', async (req, res) => {
783
+ const auth = (0, bot_auth_js_1.checkBotInternalAuth)(req.headers);
784
+ if (!auth.ok) {
785
+ return res.status(auth.status).json({ error: auth.error });
786
+ }
787
+ const apiKey = (req.query.api_key || '').trim();
788
+ if (!apiKey) {
789
+ return res.status(400).json({ error: 'api_key_required' });
790
+ }
791
+ const result = await (0, stripe_js_1.validateApiKey)(apiKey);
792
+ if (!result.valid || !result.tier) {
793
+ return res.status(404).json({ valid: false });
794
+ }
795
+ return res.json({
796
+ valid: true,
797
+ customer_id: result.customerId || null,
798
+ tier: result.tier,
799
+ });
800
+ });
773
801
  // MCP endpoint
774
802
  app.all('/mcp', express.json(), async (req, res) => {
775
803
  // Resolve license per-request using 3-tier gate: x402 → API key → free
@@ -999,6 +1027,12 @@ function renderAssets(data) {
999
1027
  // Canonical 20 Skill slugs — table renders all 20 even with zero invocations.
1000
1028
  // Kept in sync with skills/manifest.json in github.com/AlgoVaultLabs/algovault-skills.
1001
1029
  const SKILL_SLUGS = ['quick-btc-check','portfolio-scanner','regime-aware-trading','funding-arb-monitor','full-3-tool-pipeline','multi-timeframe-confirmation','tradfi-rotation','risk-gated-entry','funding-sentiment-dashboard','contrarian-meme-scanner','divergence-detector','hourly-digest-bot','hedging-advisor','volatility-breakout-watch','cross-asset-correlation','funding-cash-and-carry','weekend-vs-weekday-patterns','agent-portfolio-rebalance','smart-dca-bot','multi-agent-war-room'];
1030
+ // Canonical license tiers — Calls by Tier table renders all 5 even at zero
1031
+ // count, so operators can monitor enterprise + x402 traffic the moment it
1032
+ // starts (instead of "tier just appeared today" silent change). Order is
1033
+ // price-asc with x402 last (pay-per-call sits outside the subscription ladder).
1034
+ // Kept in sync with LicenseTier enum in src/types.ts.
1035
+ const LICENSE_TIERS = ['free','starter','pro','enterprise','x402'];
1002
1036
  function escSlug(s) { return String(s).replace(/[<>&]/g,''); }
1003
1037
  function fmtTs(s) {
1004
1038
  if (!s) return '<span style="color:#6e7681">never</span>';
@@ -1039,7 +1073,12 @@ async function load() {
1039
1073
  document.getElementById('sessions-all').textContent = d.uniqueSessions.allTime;
1040
1074
  document.getElementById('sessions-24h').textContent = d.uniqueSessions.last24h;
1041
1075
  renderRows('by-tool', d.byTool);
1042
- renderRows('by-tier', d.byTier);
1076
+ // Pre-fill all 5 canonical license tiers (zero-fill missing) so empty
1077
+ // buckets like enterprise + x402 always show as "0" rows. Mirrors the
1078
+ // SKILL_SLUGS pattern at line ~1066: explicit canonical-list expansion
1079
+ // beats "render whatever the API returns" for monitoring surfaces.
1080
+ const tierFilled = Object.fromEntries(LICENSE_TIERS.map(t => [t, (d.byTier && d.byTier[t]) || 0]));
1081
+ renderRows('by-tier', tierFilled);
1043
1082
  renderAssets(d.topAssets);
1044
1083
  // C1 (LATENCY-W1): truthful per-tool latency table — n / p50 / p95 / min / max.
1045
1084
  // Replaces the misleading single-number avg (a bimodal distribution averaged 7.8s
@@ -1679,56 +1718,6 @@ function getSignupPageHtml() {
1679
1718
  </body>
1680
1719
  </html>`;
1681
1720
  }
1682
- // ── Welcome Page HTML ──
1683
- function getWelcomePageHtml(apiKey, tier, email) {
1684
- const keyDisplay = apiKey
1685
- ? `<div class="key-box"><div class="label">Your API Key</div><code id="api-key">${apiKey}</code><button onclick="navigator.clipboard.writeText(document.getElementById('api-key').textContent);this.textContent='Copied!'">Copy</button></div>`
1686
- : `<div class="pending"><p>Your API key is being provisioned. This usually takes a few seconds.</p><p>Refresh this page in a moment, or check your email at <strong>${email || 'your registered address'}</strong>.</p></div>`;
1687
- return `<!DOCTYPE html>
1688
- <html lang="en">
1689
- <head>
1690
- <meta charset="utf-8">
1691
- <meta name="viewport" content="width=device-width, initial-scale=1">
1692
- <title>Welcome to AlgoVault ${tier ? `(${tier})` : ''}</title>
1693
- <style>
1694
- * { margin: 0; padding: 0; box-sizing: border-box; }
1695
- body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #0f1117; color: #e1e4e8; display: flex; justify-content: center; align-items: center; min-height: 100vh; padding: 24px; }
1696
- .container { max-width: 560px; width: 100%; text-align: center; }
1697
- h1 { font-size: 28px; margin-bottom: 8px; }
1698
- .subtitle { color: #8b949e; margin-bottom: 32px; font-size: 14px; }
1699
- .key-box { background: #161b22; border: 1px solid #30363d; border-radius: 12px; padding: 24px; margin: 24px 0; text-align: left; }
1700
- .key-box .label { color: #8b949e; font-size: 12px; text-transform: uppercase; letter-spacing: 1px; margin-bottom: 12px; }
1701
- .key-box code { display: block; background: #0d1117; border: 1px solid #21262d; border-radius: 6px; padding: 12px 16px; font-size: 16px; color: #3fb950; word-break: break-all; margin-bottom: 12px; }
1702
- .key-box button { background: #238636; color: #fff; border: none; padding: 8px 20px; border-radius: 6px; cursor: pointer; font-size: 14px; }
1703
- .key-box button:hover { background: #2ea043; }
1704
- .pending { background: #161b22; border: 1px solid #30363d; border-radius: 12px; padding: 24px; margin: 24px 0; color: #d29922; }
1705
- .usage { margin-top: 24px; text-align: left; }
1706
- .usage h2 { font-size: 16px; color: #8b949e; text-transform: uppercase; letter-spacing: 1px; margin-bottom: 12px; }
1707
- .usage pre { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; font-size: 13px; overflow-x: auto; color: #c9d1d9; }
1708
- </style>
1709
- </head>
1710
- <body>
1711
- <div class="container">
1712
- <h1>Welcome to AlgoVault! &#x1f389;</h1>
1713
- <div class="subtitle">${tier ? tier.charAt(0).toUpperCase() + tier.slice(1) + ' plan activated' : 'Setting up your account...'}</div>
1714
- ${keyDisplay}
1715
- <div class="usage">
1716
- <h2>Use it in Claude Desktop / Cursor / Claude Code</h2>
1717
- <pre>{
1718
- "mcpServers": {
1719
- "algovault": {
1720
- "url": "https://api.algovault.com/mcp",
1721
- "headers": { "Authorization": "Bearer ${apiKey || 'YOUR_API_KEY'}" }
1722
- }
1723
- }
1724
- }</pre>
1725
- <p style="color:#8b949e;font-size:12px;margin-top:8px">Paste into <code style="background:#0d1117;padding:1px 4px;border-radius:3px">claude_desktop_config.json</code> (or Cursor / Claude Code MCP config). Then ask: <em>"Get me a trade call for SOL on the 5-minute timeframe."</em></p>
1726
- <p style="color:#8b949e;font-size:12px;margin-top:8px">Want to test with raw HTTP/curl? See the <a href="https://algovault.com/docs.html#testing-with-curl" style="color:#58a6ff">3-step handshake guide</a> in our docs. Supported exchanges: HL (default), BINANCE, BYBIT, OKX, BITGET. Need to find your key later? Visit <a href="/account" style="color:#58a6ff">/account</a>.</p>
1727
- </div>
1728
- </div>
1729
- </body>
1730
- </html>`;
1731
- }
1732
1721
  // ── Entry Point ──
1733
1722
  const transport = (process.env.TRANSPORT || 'http').toLowerCase();
1734
1723
  if (transport === 'stdio') {