crypto-quant-signal-mcp 1.19.0 → 1.20.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.
Files changed (214) hide show
  1. package/README.md +54 -17
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +123 -7
  4. package/dist/index.js.map +1 -1
  5. package/dist/lib/adapters/bitget.d.ts.map +1 -1
  6. package/dist/lib/adapters/bitget.js +19 -4
  7. package/dist/lib/adapters/bitget.js.map +1 -1
  8. package/dist/lib/candle-guard.d.ts +37 -0
  9. package/dist/lib/candle-guard.d.ts.map +1 -0
  10. package/dist/lib/candle-guard.js +78 -0
  11. package/dist/lib/candle-guard.js.map +1 -0
  12. package/dist/lib/chat-analytics.d.ts.map +1 -1
  13. package/dist/lib/chat-analytics.js +5 -9
  14. package/dist/lib/chat-analytics.js.map +1 -1
  15. package/dist/lib/equities/equity-bars-provider.d.ts +71 -0
  16. package/dist/lib/equities/equity-bars-provider.d.ts.map +1 -0
  17. package/dist/lib/equities/equity-bars-provider.js +275 -0
  18. package/dist/lib/equities/equity-bars-provider.js.map +1 -0
  19. package/dist/lib/equities/equity-constants.d.ts +39 -0
  20. package/dist/lib/equities/equity-constants.d.ts.map +1 -0
  21. package/dist/lib/equities/equity-constants.js +46 -0
  22. package/dist/lib/equities/equity-constants.js.map +1 -0
  23. package/dist/lib/equities/equity-indicators.d.ts +28 -0
  24. package/dist/lib/equities/equity-indicators.d.ts.map +1 -0
  25. package/dist/lib/equities/equity-indicators.js +86 -0
  26. package/dist/lib/equities/equity-indicators.js.map +1 -0
  27. package/dist/lib/equities/equity-misses.d.ts +11 -0
  28. package/dist/lib/equities/equity-misses.d.ts.map +1 -0
  29. package/dist/lib/equities/equity-misses.js +17 -0
  30. package/dist/lib/equities/equity-misses.js.map +1 -0
  31. package/dist/lib/equities/equity-outcomes.d.ts +25 -0
  32. package/dist/lib/equities/equity-outcomes.d.ts.map +1 -0
  33. package/dist/lib/equities/equity-outcomes.js +33 -0
  34. package/dist/lib/equities/equity-outcomes.js.map +1 -0
  35. package/dist/lib/equities/equity-performance.d.ts +33 -0
  36. package/dist/lib/equities/equity-performance.d.ts.map +1 -0
  37. package/dist/lib/equities/equity-performance.js +51 -0
  38. package/dist/lib/equities/equity-performance.js.map +1 -0
  39. package/dist/lib/equities/equity-store.d.ts +67 -0
  40. package/dist/lib/equities/equity-store.d.ts.map +1 -0
  41. package/dist/lib/equities/equity-store.js +165 -0
  42. package/dist/lib/equities/equity-store.js.map +1 -0
  43. package/dist/lib/equities/equity-symbols.d.ts +25 -0
  44. package/dist/lib/equities/equity-symbols.d.ts.map +1 -0
  45. package/dist/lib/equities/equity-symbols.js +44 -0
  46. package/dist/lib/equities/equity-symbols.js.map +1 -0
  47. package/dist/lib/equities/equity-tool-formatters.d.ts +51 -0
  48. package/dist/lib/equities/equity-tool-formatters.d.ts.map +1 -0
  49. package/dist/lib/equities/equity-tool-formatters.js +134 -0
  50. package/dist/lib/equities/equity-tool-formatters.js.map +1 -0
  51. package/dist/lib/equities/equity-universe-rank.d.ts +29 -0
  52. package/dist/lib/equities/equity-universe-rank.d.ts.map +1 -0
  53. package/dist/lib/equities/equity-universe-rank.js +65 -0
  54. package/dist/lib/equities/equity-universe-rank.js.map +1 -0
  55. package/dist/lib/equities/equity-verdict.d.ts +35 -0
  56. package/dist/lib/equities/equity-verdict.d.ts.map +1 -0
  57. package/dist/lib/equities/equity-verdict.js +128 -0
  58. package/dist/lib/equities/equity-verdict.js.map +1 -0
  59. package/dist/lib/errors.d.ts +45 -0
  60. package/dist/lib/errors.d.ts.map +1 -1
  61. package/dist/lib/errors.js +52 -1
  62. package/dist/lib/errors.js.map +1 -1
  63. package/dist/lib/geo-dashboard.d.ts +38 -0
  64. package/dist/lib/geo-dashboard.d.ts.map +1 -1
  65. package/dist/lib/geo-dashboard.js +116 -2
  66. package/dist/lib/geo-dashboard.js.map +1 -1
  67. package/dist/lib/geo-digest.d.ts +126 -0
  68. package/dist/lib/geo-digest.d.ts.map +1 -0
  69. package/dist/lib/geo-digest.js +265 -0
  70. package/dist/lib/geo-digest.js.map +1 -0
  71. package/dist/lib/geo-extractor.d.ts +28 -2
  72. package/dist/lib/geo-extractor.d.ts.map +1 -1
  73. package/dist/lib/geo-extractor.js +73 -4
  74. package/dist/lib/geo-extractor.js.map +1 -1
  75. package/dist/lib/geo-gap-list.d.ts +37 -0
  76. package/dist/lib/geo-gap-list.d.ts.map +1 -0
  77. package/dist/lib/geo-gap-list.js +161 -0
  78. package/dist/lib/geo-gap-list.js.map +1 -0
  79. package/dist/lib/geo-orchestrator.d.ts +33 -8
  80. package/dist/lib/geo-orchestrator.d.ts.map +1 -1
  81. package/dist/lib/geo-orchestrator.js +119 -27
  82. package/dist/lib/geo-orchestrator.js.map +1 -1
  83. package/dist/lib/geo-storage.d.ts +24 -2
  84. package/dist/lib/geo-storage.d.ts.map +1 -1
  85. package/dist/lib/geo-storage.js +99 -3
  86. package/dist/lib/geo-storage.js.map +1 -1
  87. package/dist/lib/indicator-buckets.d.ts +8 -2
  88. package/dist/lib/indicator-buckets.d.ts.map +1 -1
  89. package/dist/lib/indicator-buckets.js +1 -0
  90. package/dist/lib/indicator-buckets.js.map +1 -1
  91. package/dist/lib/license.d.ts +6 -2
  92. package/dist/lib/license.d.ts.map +1 -1
  93. package/dist/lib/license.js +15 -4
  94. package/dist/lib/license.js.map +1 -1
  95. package/dist/lib/llm-provider.d.ts +123 -1
  96. package/dist/lib/llm-provider.d.ts.map +1 -1
  97. package/dist/lib/llm-provider.js +495 -1
  98. package/dist/lib/llm-provider.js.map +1 -1
  99. package/dist/lib/market-sessions-constants.d.ts +90 -0
  100. package/dist/lib/market-sessions-constants.d.ts.map +1 -0
  101. package/dist/lib/market-sessions-constants.js +142 -0
  102. package/dist/lib/market-sessions-constants.js.map +1 -0
  103. package/dist/lib/market-sessions.d.ts +48 -0
  104. package/dist/lib/market-sessions.d.ts.map +1 -0
  105. package/dist/lib/market-sessions.js +94 -0
  106. package/dist/lib/market-sessions.js.map +1 -0
  107. package/dist/lib/question-hash.d.ts +3 -0
  108. package/dist/lib/question-hash.d.ts.map +1 -0
  109. package/dist/lib/question-hash.js +25 -0
  110. package/dist/lib/question-hash.js.map +1 -0
  111. package/dist/lib/trade-call-scanner.d.ts +70 -0
  112. package/dist/lib/trade-call-scanner.d.ts.map +1 -0
  113. package/dist/lib/trade-call-scanner.js +235 -0
  114. package/dist/lib/trade-call-scanner.js.map +1 -0
  115. package/dist/lib/tradfi-funding.d.ts +96 -0
  116. package/dist/lib/tradfi-funding.d.ts.map +1 -0
  117. package/dist/lib/tradfi-funding.js +197 -0
  118. package/dist/lib/tradfi-funding.js.map +1 -0
  119. package/dist/lib/underlying-type.d.ts +28 -0
  120. package/dist/lib/underlying-type.d.ts.map +1 -0
  121. package/dist/lib/underlying-type.js +161 -0
  122. package/dist/lib/underlying-type.js.map +1 -0
  123. package/dist/lib/venue-coverage.d.ts +1 -1
  124. package/dist/lib/venue-coverage.d.ts.map +1 -1
  125. package/dist/lib/venue-coverage.js +12 -9
  126. package/dist/lib/venue-coverage.js.map +1 -1
  127. package/dist/lib/venue-store.d.ts +13 -0
  128. package/dist/lib/venue-store.d.ts.map +1 -1
  129. package/dist/lib/venue-store.js +32 -0
  130. package/dist/lib/venue-store.js.map +1 -1
  131. package/dist/lib/webhook-api.d.ts +7 -0
  132. package/dist/lib/webhook-api.d.ts.map +1 -1
  133. package/dist/lib/webhook-api.js +22 -1
  134. package/dist/lib/webhook-api.js.map +1 -1
  135. package/dist/lib/webhook-events.d.ts +12 -4
  136. package/dist/lib/webhook-events.d.ts.map +1 -1
  137. package/dist/lib/webhook-events.js +64 -5
  138. package/dist/lib/webhook-events.js.map +1 -1
  139. package/dist/lib/x402-bazaar.d.ts +18 -0
  140. package/dist/lib/x402-bazaar.d.ts.map +1 -1
  141. package/dist/lib/x402-bazaar.js +37 -4
  142. package/dist/lib/x402-bazaar.js.map +1 -1
  143. package/dist/lib/x402-http-routes.d.ts +44 -0
  144. package/dist/lib/x402-http-routes.d.ts.map +1 -0
  145. package/dist/lib/x402-http-routes.js +203 -0
  146. package/dist/lib/x402-http-routes.js.map +1 -0
  147. package/dist/lib/x402.d.ts +5 -1
  148. package/dist/lib/x402.d.ts.map +1 -1
  149. package/dist/lib/x402.js +28 -13
  150. package/dist/lib/x402.js.map +1 -1
  151. package/dist/scripts/backfill-equity-bars.d.ts +5 -0
  152. package/dist/scripts/backfill-equity-bars.d.ts.map +1 -0
  153. package/dist/scripts/backfill-equity-bars.js +83 -0
  154. package/dist/scripts/backfill-equity-bars.js.map +1 -0
  155. package/dist/scripts/backfill-equity-outcomes.d.ts +6 -0
  156. package/dist/scripts/backfill-equity-outcomes.d.ts.map +1 -0
  157. package/dist/scripts/backfill-equity-outcomes.js +64 -0
  158. package/dist/scripts/backfill-equity-outcomes.js.map +1 -0
  159. package/dist/scripts/build-equity-universe.d.ts +4 -0
  160. package/dist/scripts/build-equity-universe.d.ts.map +1 -0
  161. package/dist/scripts/build-equity-universe.js +102 -0
  162. package/dist/scripts/build-equity-universe.js.map +1 -0
  163. package/dist/scripts/evaluate-venues.d.ts +1 -1
  164. package/dist/scripts/evaluate-venues.d.ts.map +1 -1
  165. package/dist/scripts/evaluate-venues.js +36 -18
  166. package/dist/scripts/evaluate-venues.js.map +1 -1
  167. package/dist/scripts/geo-demand-mining.d.ts +59 -0
  168. package/dist/scripts/geo-demand-mining.d.ts.map +1 -0
  169. package/dist/scripts/geo-demand-mining.js +272 -0
  170. package/dist/scripts/geo-demand-mining.js.map +1 -0
  171. package/dist/scripts/geo-weekly-cron.js +163 -64
  172. package/dist/scripts/geo-weekly-cron.js.map +1 -1
  173. package/dist/scripts/promote-venue.d.ts +3 -0
  174. package/dist/scripts/promote-venue.d.ts.map +1 -0
  175. package/dist/scripts/promote-venue.js +103 -0
  176. package/dist/scripts/promote-venue.js.map +1 -0
  177. package/dist/scripts/retire-venue.d.ts +3 -0
  178. package/dist/scripts/retire-venue.d.ts.map +1 -0
  179. package/dist/scripts/retire-venue.js +49 -0
  180. package/dist/scripts/retire-venue.js.map +1 -0
  181. package/dist/scripts/seed-equities.d.ts +7 -0
  182. package/dist/scripts/seed-equities.d.ts.map +1 -0
  183. package/dist/scripts/seed-equities.js +89 -0
  184. package/dist/scripts/seed-equities.js.map +1 -0
  185. package/dist/scripts/seed-signals.d.ts +27 -1
  186. package/dist/scripts/seed-signals.d.ts.map +1 -1
  187. package/dist/scripts/seed-signals.js +336 -94
  188. package/dist/scripts/seed-signals.js.map +1 -1
  189. package/dist/scripts/venue-readiness-report.d.ts +18 -0
  190. package/dist/scripts/venue-readiness-report.d.ts.map +1 -0
  191. package/dist/scripts/venue-readiness-report.js +108 -0
  192. package/dist/scripts/venue-readiness-report.js.map +1 -0
  193. package/dist/tool-annotations.d.ts +26 -0
  194. package/dist/tool-annotations.d.ts.map +1 -0
  195. package/dist/tool-annotations.js +32 -0
  196. package/dist/tool-annotations.js.map +1 -0
  197. package/dist/tool-descriptions.d.ts +7 -0
  198. package/dist/tool-descriptions.d.ts.map +1 -1
  199. package/dist/tool-descriptions.js +13 -1
  200. package/dist/tool-descriptions.js.map +1 -1
  201. package/dist/tools/get-market-regime.d.ts.map +1 -1
  202. package/dist/tools/get-market-regime.js +91 -5
  203. package/dist/tools/get-market-regime.js.map +1 -1
  204. package/dist/tools/get-trade-call.d.ts.map +1 -1
  205. package/dist/tools/get-trade-call.js +44 -4
  206. package/dist/tools/get-trade-call.js.map +1 -1
  207. package/dist/tools/scan-trade-calls.d.ts +58 -0
  208. package/dist/tools/scan-trade-calls.d.ts.map +1 -0
  209. package/dist/tools/scan-trade-calls.js +81 -0
  210. package/dist/tools/scan-trade-calls.js.map +1 -0
  211. package/dist/types.d.ts +35 -0
  212. package/dist/types.d.ts.map +1 -1
  213. package/package.json +1 -1
  214. package/server.json +1 -1
package/README.md CHANGED
@@ -34,8 +34,12 @@
34
34
 
35
35
  ## 📊 Live Track Record
36
36
 
37
+ <!-- SoT: this README is the single canonical source. The data-tr-field numbers below are
38
+ auto-injected from live /api/performance-public + /api/merkle-batches by
39
+ scripts/snapshot-landing-data.mjs at npm-publish + Hetzner-deploy. Do NOT hand-edit the
40
+ numbers; edit "What's new" by hand. Wired by OPS-NPM-README-SINGLE-SOT-W1 (2026-05-31). -->
37
41
  <p align="center">
38
- <strong><span data-tr-field="pfe_wr">90.5%</span> PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">96,898</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">38</span> on-chain batches</strong> · <strong><span data-tr-field="hold_rate">99%</span> HOLD rate</strong> <!-- SNAPSHOT-LINE -->
42
+ <strong><span data-tr-field="pfe_wr">91.7%</span>% PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">151,968</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">55</span> on-chain batches</strong> · <strong><span data-tr-field="hold_rate">98.9%</span>% HOLD rate</strong> <!-- SNAPSHOT-LINE -->
39
43
  </p>
40
44
 
41
45
  <p align="center">
@@ -68,7 +72,7 @@ AlgoVault MCP serves Streamable HTTP at `https://api.algovault.com/mcp` — MCP-
68
72
  | Client | Config |
69
73
  |---|---|
70
74
  | **Claude Desktop** | Settings → Integrations → Add custom connector → `https://api.algovault.com/mcp` |
71
- | **Claude Code** (CLI) | `claude mcp add crypto-quant-signal https://api.algovault.com/mcp --header "X-AlgoVault-Track-Token:chan-readme"` |
75
+ | **Claude Code** (CLI) | `claude mcp add crypto-quant-signal https://api.algovault.com/mcp` |
72
76
  | **Cursor** | `~/.cursor/config.json` → `mcpServers` block → `url: "https://api.algovault.com/mcp"` |
73
77
  | **Cline** | VS Code Cline extension → MCP server settings → add Streamable HTTP server |
74
78
  | **Codex** (OpenAI CLI) | `~/.codex/config.toml` → `[mcp_servers.algovault]` table + `url = "https://api.algovault.com/mcp"` (or `codex mcp` CLI) |
@@ -88,18 +92,35 @@ Drop-in tutorials for the major Python agent frameworks. Each tutorial pairs Alg
88
92
 
89
93
  | Framework | Tutorial | Runnable demo | Mirror |
90
94
  |---|---|---|---|
91
- | **LangChain** | [`docs/integrations/langchain.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/langchain.md) | [`examples/langchain/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/langchain/demo.py) | [algovault.com/docs/integrations/langchain](https://algovault.com/docs/integrations/langchain) |
92
- | **LlamaIndex** | [`docs/integrations/llamaindex.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/llamaindex.md) | [`examples/llamaindex/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/llamaindex/demo.py) | [algovault.com/docs/integrations/llamaindex](https://algovault.com/docs/integrations/llamaindex) |
93
- | **Microsoft Agent Framework** | [`docs/integrations/maf.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/maf.md) | [`examples/maf/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/maf/demo.py) | [algovault.com/docs/integrations/maf](https://algovault.com/docs/integrations/maf) |
94
- | **CrewAI** | [`docs/integrations/crewai.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/crewai.md) | [`examples/crewai/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/crewai/demo.py) | [algovault.com/docs/integrations/crewai](https://algovault.com/docs/integrations/crewai) |
95
+ | **LangChain** | [`docs/integrations/langchain.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/langchain.md) | [`examples/langchain/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/langchain/demo.py) | [algovault.com/integrations/langchain](https://algovault.com/integrations/langchain) |
96
+ | **LlamaIndex** | [`docs/integrations/llamaindex.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/llamaindex.md) | [`examples/llamaindex/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/llamaindex/demo.py) | [algovault.com/integrations/llamaindex](https://algovault.com/integrations/llamaindex) |
97
+ | **Microsoft Agent Framework** | [`docs/integrations/maf.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/maf.md) | [`examples/maf/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/maf/demo.py) | [algovault.com/integrations/maf](https://algovault.com/integrations/maf) |
98
+ | **CrewAI** | [`docs/integrations/crewai.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/crewai.md) | [`examples/crewai/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/crewai/demo.py) | [algovault.com/integrations/crewai](https://algovault.com/integrations/crewai) |
95
99
 
96
100
  Each demo is runnable as `python examples/<framework>/demo.py BTC 4h` — gets a real BUY/SELL/HOLD verdict from `api.algovault.com/mcp`, prints it. ≤5 minutes to first call.
97
101
 
98
102
  ---
99
103
 
100
- ## What's new in v1.18.2
104
+ ## What's new in v1.20.0
101
105
 
102
- Live since 2026-05-25:
106
+ Live since 2026-06-04:
107
+
108
+ - **📡 `scan_trade_calls` — market-wide scanner.** One call scans the top-N perps (1–100, ranked by open interest) on your chosen venue and returns every actionable BUY/SELL with confidence and regime. HOLDs stay free — quota counts only actionable calls.
109
+ - **🔔 Webhooks: dynamic `top:N` watchlists.** Subscribe with `assets: ["top:25"]` and your webhook follows the venue's top perps automatically. No manual list upkeep.
110
+ - **🏛️ TradFi-aware analysis.** Both core tools now report the underlying market session (`underlying_session`, with weekend/holiday caveats), interpret fixed pre-IPO funding correctly, and aggregate cross-venue funding sentiment for stocks, indices, commodities, and FX across all 5 venues.
111
+ - **🧭 Smarter errors on young listings.** Insufficient history returns a structured `INSUFFICIENT_CANDLES` error with `suggested_timeframes` instead of a plain string.
112
+
113
+ > MCP clients cache `tools/list` at session start — toggle the connector off/on (or restart the MCP connection) to see `scan_trade_calls`.
114
+
115
+ ### v1.19.0 highlights (recap)
116
+
117
+ - **🔔 Webhook Delivery Service.** Subscribe a URL; receive `trade_call` and `regime_shift` events as push, not poll. Payloads are HMAC-SHA256 signed, retried, and idempotent. Manage over HTTP: `POST` / `GET` / `DELETE /api/webhooks`, plus `POST /api/webhooks/:id/test` for a live test fire. API key required.
118
+ - **🔗 One-call signal verification.** Every webhook payload carries a `verify_url`. Resolve it at `GET /api/verify-signal?hash=<signal_hash>` for that call's public, on-chain-anchored record.
119
+ - **🔌 Two more platform integration examples.** The `algovault-integrations` mono-repo now ships 7 reference implementations — Hummingbot and FreqTrade join the existing five. New tiles on [algovault.com/integrations](https://algovault.com/integrations).
120
+
121
+ **→ Set up a webhook:** [algovault.com/integrations#webhooks](https://algovault.com/integrations#webhooks) · **Webhook docs:** [docs/WEBHOOKS.md](https://github.com/AlgoVaultLabs/crypto-quant-signal-mcp/blob/main/docs/WEBHOOKS.md)
122
+
123
+ ### v1.18.2 highlights (recap)
103
124
 
104
125
  - **🔌 Two new platform integration examples.** The `algovault-integrations` mono-repo now ships 5 reference implementations total (was 3 at v1.18.0):
105
126
  - **QuantDinger** (reference-architecture doc) — cross-MCP IDE-mediated orchestration. AlgoVault MCP and QuantDinger MCP connect through the user's IDE (Claude Desktop / Cursor / Codex CLI); no transformer code.
@@ -155,7 +176,7 @@ Live since 2026-05-25:
155
176
  - **🪪 ERC-8004 Verified Agent on Base.** AlgoVault MCP is registered on the canonical ERC-8004 Identity Registry at [`0x8004A169...e539a432`](https://basescan.org/address/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432). Each call traces back to a portable, censorship-resistant agent identity on Base L2. agentId [`44544`](https://basescan.org/token/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432?a=44544) on Basescan. Same on-chain track record; new verified agent handle that AI orchestrators can resolve.
156
177
  - **🔌 `/api/erc-8004-reputation` endpoint.** Read-only JSON aggregator exposing agentId, identity registry address, registration timestamp, and Basescan link. Cached 5 minutes. `curl -s api.algovault.com/api/erc-8004-reputation | jq`.
157
178
 
158
- > **Upgrading from v1.13.x or earlier?** The MCP tool surface is unchanged structurally — `get_trade_call`, `scan_funding_arb`, `get_market_regime` keep their parameter shapes. v1.14.0 only adds the Framework integrations cross-links; no tool schema change. If you upgraded across v1.13.2 you already picked up the refreshed tool descriptions — MCP clients cache `tools/list` at session start, so toggle the connector off/on if you haven't restarted since v1.13.2.
179
+ > **Upgrading from v1.19.x or earlier?** The six original tools — `get_trade_call`, `get_trade_signal`, `scan_funding_arb`, `get_market_regime`, `search_knowledge`, `chat_knowledge` — keep their parameter shapes unchanged. v1.20.0 adds ONE new tool, `scan_trade_calls` (top-N market scanner), and additive output fields on the core tools (`underlying_session`, `session_note`, `metrics.funding_by_venue`) plus a structured `INSUFFICIENT_CANDLES` error — all backward-compatible. Because MCP clients (Claude Desktop, Cursor, Cline) cache `tools/list` at session start, reconnect (toggle the connector off/on) once to see `scan_trade_calls`; existing integrations keep working without changes.
159
180
 
160
181
  ---
161
182
 
@@ -174,7 +195,7 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
174
195
  - **ERC-8004 verified agent.** AlgoVault MCP holds a registered agentId on the Base L2 Identity Registry. The agent identity is portable and on-chain.
175
196
  - **Drop-in for every major agent framework.** First-party tutorials + runnable demos for LangChain, LlamaIndex, Microsoft Agent Framework, CrewAI. ≤5 minutes to first call. See the [Framework integrations](#framework-integrations) section.
176
197
  - **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.
177
- - **Crypto + TradFi coverage.** 750+ assets — standard crypto perps on all 5 CEX; TradFi perps (stocks, indices, commodities, FX); liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
198
+ - **Crypto + TradFi coverage.** 760+ assets — standard crypto perps on all 5 CEX; TradFi perps (stocks, indices, commodities, FX); liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
178
199
 
179
200
  ---
180
201
 
@@ -249,7 +270,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
249
270
  { "coin": "SOL", "timeframe": "15m", "confidence": 73 }
250
271
  ],
251
272
  "_algovault": {
252
- "version": "1.14.0",
273
+ "version": "1.20.0",
253
274
  "tool": "get_trade_call",
254
275
  "compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
255
276
  }
@@ -281,6 +302,22 @@ Combines directional strength measurement with ADX slope analysis (detecting tre
281
302
 
282
303
  **Output includes:** regime label, confidence score, underlying metrics (trend strength, volatility interpretation, price structure), cross-venue funding sentiment, and a plain-English strategy suggestion.
283
304
 
305
+ ### `scan_trade_calls`
306
+
307
+ Scans the **top-N perpetual futures by open interest** on a venue and returns composite BUY/SELL/HOLD verdicts for the whole set in one call — market-wide coverage for agents that would otherwise loop `get_trade_call` per coin.
308
+
309
+ Non-HOLD calls are ranked first by confidence; HOLDs are free and never consume quota (quota counts only the actionable BUY/SELL results returned).
310
+
311
+ **Parameters:**
312
+ - `topN` (integer 1–100, default `20`): How many top perps (by open interest) to scan
313
+ - `timeframe` (string, default `"15m"`): Candle timeframe for the scan — `1m`–`1d`
314
+ - `exchange` (string, default `"BINANCE"`): Venue — `BINANCE`, `HL`, `BYBIT`, `OKX`, `BITGET`
315
+ - `minConfidence` (number 0–100, optional): Drop non-HOLD calls below this confidence
316
+ - `includeHolds` (boolean, default `false`): Append HOLD calls after the non-HOLD results
317
+ - `limit` (integer 1–100, default `10`): Max ranked calls returned (non-HOLD first)
318
+
319
+ **Output includes:** an array of `{ coin, timeframe, exchange, call, confidence, regime }` entries, ranked non-HOLD first, plus the scan's venue and timeframe.
320
+
284
321
  ---
285
322
 
286
323
  ## When You Hit the Free Limit
@@ -310,7 +347,7 @@ or pay per call via x402.
310
347
  | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
311
348
  |---------|------|-------------------|-------------|---------------------|-----------------|
312
349
  | Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
313
- | Assets | All 750+ | All 750+ | All 750+ | All 750+ | All 750+ | <!-- SNAPSHOT-LINE-TABLE -->
350
+ | Assets | All 760+ | All 760+ | All 760+ | All 760+ | All 760+ | <!-- SNAPSHOT-LINE-TABLE -->
314
351
  | Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
315
352
  | Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
316
353
  | Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
@@ -335,10 +372,10 @@ End-to-end tutorials pairing AlgoVault with each major exchange's Agent Trade Ki
335
372
  <!-- BUILD:README_INTEGRATIONS_TABLE -->
336
373
  | # | Exchange | Tutorial | Demo | Mirror |
337
374
  |---|---|---|---|---|
338
- | 01 | Binance | [`docs/integrations/binance.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/binance.md) | [`examples/binance/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/binance/demo.mjs) | [algovault.com/docs/integrations/binance](https://algovault.com/docs/integrations/binance) |
339
- | 02 | OKX | [`docs/integrations/okx.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/okx.md) | [`examples/okx/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/okx/demo.mjs) | [algovault.com/docs/integrations/okx](https://algovault.com/docs/integrations/okx) |
340
- | 03 | Bybit | [`docs/integrations/bybit.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/bybit.md) | [`examples/bybit/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/bybit/demo.mjs) | [algovault.com/docs/integrations/bybit](https://algovault.com/docs/integrations/bybit) |
341
- | 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) |
375
+ | 01 | Binance | [`docs/integrations/binance.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/binance.md) | [`examples/binance/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/binance/demo.mjs) | [algovault.com/integrations/binance](https://algovault.com/integrations/binance) |
376
+ | 02 | OKX | [`docs/integrations/okx.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/okx.md) | [`examples/okx/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/okx/demo.mjs) | [algovault.com/integrations/okx](https://algovault.com/integrations/okx) |
377
+ | 03 | Bybit | [`docs/integrations/bybit.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/bybit.md) | [`examples/bybit/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/bybit/demo.mjs) | [algovault.com/integrations/bybit](https://algovault.com/integrations/bybit) |
378
+ | 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/integrations/bitget](https://algovault.com/integrations/bitget) |
342
379
  <!-- /BUILD:README_INTEGRATIONS_TABLE -->
343
380
 
344
381
  ---
@@ -446,7 +483,7 @@ npx -y crypto-quant-signal-mcp
446
483
  ### Claude Code CLI
447
484
 
448
485
  ```bash
449
- claude mcp add crypto-quant-signal https://api.algovault.com/mcp --header "X-AlgoVault-Track-Token:chan-readme"
486
+ claude mcp add crypto-quant-signal https://api.algovault.com/mcp
450
487
  ```
451
488
 
452
489
  ### npm install
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAqpGtF,wBAAgB,mBAAmB,cAElC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AA+xGtF,wBAAgB,mBAAmB,cAElC"}
package/dist/index.js CHANGED
@@ -54,6 +54,7 @@ const zod_1 = require("zod");
54
54
  const get_trade_call_js_1 = require("./tools/get-trade-call.js");
55
55
  const scan_funding_arb_js_1 = require("./tools/scan-funding-arb.js");
56
56
  const get_market_regime_js_1 = require("./tools/get-market-regime.js");
57
+ const scan_trade_calls_js_1 = require("./tools/scan-trade-calls.js");
57
58
  const signal_performance_js_1 = require("./resources/signal-performance.js");
58
59
  const cross_asset_grid_js_1 = require("./lib/cross-asset-grid.js");
59
60
  const performance_db_js_1 = require("./lib/performance-db.js");
@@ -66,6 +67,11 @@ const asset_tiers_js_1 = require("./lib/asset-tiers.js");
66
67
  const capabilities_js_1 = require("./lib/capabilities.js");
67
68
  const license_js_1 = require("./lib/license.js");
68
69
  const x402_js_1 = require("./lib/x402.js");
70
+ const x402_http_routes_js_1 = require("./lib/x402-http-routes.js");
71
+ const tool_annotations_js_1 = require("./tool-annotations.js");
72
+ const equity_tool_formatters_js_1 = require("./lib/equities/equity-tool-formatters.js");
73
+ const equity_performance_js_1 = require("./lib/equities/equity-performance.js");
74
+ const equity_store_js_1 = require("./lib/equities/equity-store.js");
69
75
  const analytics_js_1 = require("./lib/analytics.js");
70
76
  const stripe_events_store_js_1 = require("./lib/stripe-events-store.js");
71
77
  const signup_emails_store_js_1 = require("./lib/signup-emails-store.js");
@@ -157,6 +163,10 @@ function toolErrorContent(err) {
157
163
  };
158
164
  return { content: [{ type: 'text', text: JSON.stringify(payload) }], isError: true };
159
165
  }
166
+ if (err instanceof errors_js_1.InsufficientCandlesError) {
167
+ const payload = (0, errors_js_1.buildInsufficientCandlesPayload)(err);
168
+ return { content: [{ type: 'text', text: JSON.stringify(payload) }], isError: true };
169
+ }
160
170
  const message = err instanceof Error ? err.message : String(err);
161
171
  return { content: [{ type: 'text', text: JSON.stringify({ error: message }) }], isError: true };
162
172
  }
@@ -295,8 +305,8 @@ function createServer() {
295
305
  }
296
306
  };
297
307
  }
298
- server.tool('get_trade_call', tool_descriptions_js_1.TRADE_CALL_DESCRIPTION, TRADE_CALL_SCHEMA, { readOnlyHint: true, openWorldHint: true }, makeTradeCallHandler('get_trade_call'));
299
- server.tool('get_trade_signal', tool_descriptions_js_1.TRADE_CALL_DESCRIPTION + tool_descriptions_js_1.TRADE_CALL_ALIAS_SUFFIX, TRADE_CALL_SCHEMA, { readOnlyHint: true, openWorldHint: true }, makeTradeCallHandler('get_trade_signal'));
308
+ server.tool('get_trade_call', tool_descriptions_js_1.TRADE_CALL_DESCRIPTION, TRADE_CALL_SCHEMA, { title: 'Composite Trade Call', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, makeTradeCallHandler('get_trade_call'));
309
+ server.tool('get_trade_signal', tool_descriptions_js_1.TRADE_CALL_DESCRIPTION + tool_descriptions_js_1.TRADE_CALL_ALIAS_SUFFIX, TRADE_CALL_SCHEMA, { title: 'Trade Signal', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, makeTradeCallHandler('get_trade_signal'));
300
310
  // ── Tool 2: scan_funding_arb ──
301
311
  server.tool('scan_funding_arb', tool_descriptions_js_1.SCAN_FUNDING_ARB_DESCRIPTION, {
302
312
  // DoS-prevention bounds (delta audit 2026-04-15): minSpreadBps clamped to
@@ -305,7 +315,7 @@ function createServer() {
305
315
  // hard boundary validation at the handler edge.
306
316
  minSpreadBps: zod_1.z.number().min(0).max(10_000).default(5).describe(tool_descriptions_js_1.PARAM_DESC_FUNDING_MIN_SPREAD_BPS),
307
317
  limit: zod_1.z.number().int().min(1).max(200).default(10).describe(tool_descriptions_js_1.PARAM_DESC_FUNDING_LIMIT),
308
- }, { readOnlyHint: true, openWorldHint: true }, async ({ minSpreadBps, limit }) => {
318
+ }, { title: 'Funding Arbitrage Scanner', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ minSpreadBps, limit }) => {
309
319
  const startMs = Date.now();
310
320
  try {
311
321
  const license = (0, license_js_1.getRequestLicense)();
@@ -339,7 +349,7 @@ function createServer() {
339
349
  coin: zod_1.z.string().max(20).describe(tool_descriptions_js_1.PARAM_DESC_REGIME_COIN),
340
350
  timeframe: zod_1.z.enum(['1h', '4h', '1d']).default('4h').describe(tool_descriptions_js_1.PARAM_DESC_REGIME_TIMEFRAME),
341
351
  exchange: zod_1.z.enum(['HL', 'BINANCE', 'BYBIT', 'OKX', 'BITGET', 'ASTER', 'EDGEX', 'GATE', 'MEXC', 'KUCOIN', 'PHEMEX', 'BINGX', 'HTX', 'WEEX', 'BITMART', 'XT', 'WHITEBIT']).default('HL').describe(tool_descriptions_js_1.PARAM_DESC_REGIME_EXCHANGE),
342
- }, { readOnlyHint: true, openWorldHint: true }, async ({ coin, timeframe, exchange }) => {
352
+ }, { title: 'Market Regime Classifier', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ coin, timeframe, exchange }) => {
343
353
  const startMs = Date.now();
344
354
  try {
345
355
  const license = (0, license_js_1.getRequestLicense)();
@@ -370,6 +380,90 @@ function createServer() {
370
380
  return toolErrorContent(err);
371
381
  }
372
382
  });
383
+ // ── Tools: get_equity_call + get_equity_regime (EQUITIES-ENGINE-W1) ──
384
+ // US equities daily-bar verdict engine (Databento EQUS.MINI). Free-tier quota
385
+ // wiring identical to the crypto free tools (handled inside getEquityCall via
386
+ // trackCall). Verdicts are precomputed nightly; the handler is a DB read.
387
+ const GET_EQUITY_CALL_DESCRIPTION = 'Composite daily-bar trade call (BUY/SELL/HOLD) for a US equity or ETF, with confidence, ' +
388
+ 'market regime, and the technical factors that drove it. Universe = top US equities by ' +
389
+ 'dollar-volume plus index and crypto-proxy ETFs (SPY, QQQ, IBIT, …). Verdicts are computed ' +
390
+ 'once per session from Databento EQUS.MINI daily bars. Out-of-universe tickers return a ' +
391
+ 'structured SYMBOL_NOT_IN_UNIVERSE error with nearest-symbol suggestions. Accepts BRK-B or BRK.B.';
392
+ const GET_EQUITY_REGIME_DESCRIPTION = 'Market regime for a US equity or ETF (defaults to SPY): trending_up, trending_down, ' +
393
+ 'compression, or ranging, with a confidence score. Derived from daily-bar trend strength ' +
394
+ '(ADX/DI), persistence (Hurst), and volatility compression.';
395
+ server.tool('get_equity_call', GET_EQUITY_CALL_DESCRIPTION, { symbol: zod_1.z.string().max(12).describe('US equity/ETF ticker, e.g. AAPL, SPY, BRK.B (BRK-B also accepted).') }, { title: 'Equity Trade Call', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ symbol }) => {
396
+ const startMs = Date.now();
397
+ try {
398
+ const license = (0, license_js_1.getRequestLicense)();
399
+ const result = await (0, equity_tool_formatters_js_1.getEquityCall)({ symbol, license });
400
+ (0, analytics_js_1.logRequest)({
401
+ sessionId: (0, license_js_1.getRequestSessionId)(),
402
+ toolName: 'get_equity_call',
403
+ asset: symbol,
404
+ licenseTier: license.tier,
405
+ responseTimeMs: Date.now() - startMs,
406
+ ipHash: (0, license_js_1.getRequestIpHash)(),
407
+ isBotInternal: license.tier === 'internal',
408
+ });
409
+ return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
410
+ }
411
+ catch (err) {
412
+ return toolErrorContent(err);
413
+ }
414
+ });
415
+ server.tool('get_equity_regime', GET_EQUITY_REGIME_DESCRIPTION, { symbol: zod_1.z.string().max(12).optional().describe('US equity/ETF ticker; defaults to SPY.') }, { title: 'Equity Market Regime', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ symbol }) => {
416
+ const startMs = Date.now();
417
+ try {
418
+ const license = (0, license_js_1.getRequestLicense)();
419
+ const result = await (0, equity_tool_formatters_js_1.getEquityRegime)({ symbol, license });
420
+ (0, analytics_js_1.logRequest)({
421
+ sessionId: (0, license_js_1.getRequestSessionId)(),
422
+ toolName: 'get_equity_regime',
423
+ asset: symbol ?? 'SPY',
424
+ licenseTier: license.tier,
425
+ responseTimeMs: Date.now() - startMs,
426
+ ipHash: (0, license_js_1.getRequestIpHash)(),
427
+ isBotInternal: license.tier === 'internal',
428
+ });
429
+ return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
430
+ }
431
+ catch (err) {
432
+ return toolErrorContent(err);
433
+ }
434
+ });
435
+ // ── Tool: scan_trade_calls (SCAN-TRADE-CALLS-W1) — cross-asset market scanner ──
436
+ // Thin handler: quota gate + envelope live in src/tools/scan-trade-calls.ts
437
+ // (runScanTradeCall); the scanner compute is src/lib/trade-call-scanner.ts.
438
+ server.tool('scan_trade_calls', scan_trade_calls_js_1.SCAN_TRADE_CALLS_DESCRIPTION, scan_trade_calls_js_1.SCAN_TRADE_CALLS_SCHEMA, { title: 'Market Scanner', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ topN, timeframe, exchange, minConfidence, includeHolds, limit }) => {
439
+ const startMs = Date.now();
440
+ try {
441
+ const license = (0, license_js_1.getRequestLicense)();
442
+ const result = await (0, scan_trade_calls_js_1.runScanTradeCall)({ topN, timeframe, exchange, minConfidence, includeHolds, limit }, license);
443
+ (0, analytics_js_1.logRequest)({
444
+ sessionId: (0, license_js_1.getRequestSessionId)(),
445
+ toolName: 'scan_trade_calls',
446
+ timeframe,
447
+ licenseTier: license.tier,
448
+ responseTimeMs: Date.now() - startMs,
449
+ ipHash: (0, license_js_1.getRequestIpHash)(),
450
+ isBotInternal: license.tier === 'internal',
451
+ });
452
+ const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
453
+ if (sessionIdForCohort !== null) {
454
+ (0, performance_db_js_1.upsertAgentSession)({
455
+ sessionId: sessionIdForCohort,
456
+ tool: 'scan_trade_calls',
457
+ tier: license.tier,
458
+ ipHash: (0, license_js_1.getRequestIpHash)() ?? null,
459
+ }).catch((e) => console.debug('upsertAgentSession failed:', e instanceof Error ? e.message : e));
460
+ }
461
+ return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
462
+ }
463
+ catch (err) {
464
+ return toolErrorContent(err);
465
+ }
466
+ });
373
467
  // ── Tool 4: search_knowledge ──
374
468
  // AV-CHAT-MCP-W1 (C2, 2026-05-18). BM25 lexical retrieval over the auto-
375
469
  // generated KnowledgeBundle (dist/knowledge/latest.json). Free, fast, no
@@ -379,7 +473,7 @@ function createServer() {
379
473
  server.tool('search_knowledge', tool_descriptions_js_1.SEARCH_KNOWLEDGE_DESCRIPTION, {
380
474
  query: zod_1.z.string().min(3).max(500).describe('Natural-language search query (3-500 chars).'),
381
475
  limit: zod_1.z.number().int().min(1).max(50).optional().describe('Max ranked results (1-50, default 10).'),
382
- }, { readOnlyHint: true, openWorldHint: true }, async ({ query, limit }) => {
476
+ }, { title: 'Knowledge Search', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ query, limit }) => {
383
477
  const startMs = Date.now();
384
478
  try {
385
479
  const license = (0, license_js_1.getRequestLicense)();
@@ -410,7 +504,7 @@ function createServer() {
410
504
  server.tool('chat_knowledge', tool_descriptions_js_1.CHAT_KNOWLEDGE_DESCRIPTION, {
411
505
  question: zod_1.z.string().min(5).max(500).describe('Natural-language question (5-500 chars).'),
412
506
  model: zod_1.z.enum(['claude-haiku-4-5-20251001', 'claude-sonnet-4-6']).optional().describe('Optional model override (default claude-haiku-4-5-20251001).'),
413
- }, { readOnlyHint: true, openWorldHint: true }, async ({ question, model }) => {
507
+ }, { title: 'Knowledge Q&A', ...tool_annotations_js_1.PUBLIC_READONLY_TOOL_ANNOTATIONS }, async ({ question, model }) => {
414
508
  const startMs = Date.now();
415
509
  try {
416
510
  const license = (0, license_js_1.getRequestLicense)();
@@ -492,10 +586,20 @@ function createServer() {
492
586
  // AlgoVault's quant engine — never exposed via MCP or any public surface.
493
587
  server.resource('signal-performance', 'performance://signal-performance', { description: 'Signal track record — PFE win rates by timeframe, asset, tier, and signal type. Measures whether price moved in the signal direction during the evaluation window.' }, async () => {
494
588
  const stats = await (0, signal_performance_js_1.getSignalPerformance)();
589
+ // EQUITIES-ENGINE-W1 E6: ADDITIVE `equities` key (PFE-only). Crypto keys
590
+ // byte-unchanged. Fail-open — equity DB issues must never break the crypto
591
+ // resource (graceful pre-data shape on error).
592
+ let equities;
593
+ try {
594
+ equities = await (0, equity_performance_js_1.getEquityPerformance)((0, equity_store_js_1.getEquityPool)());
595
+ }
596
+ catch {
597
+ equities = { state: 'pre_data', overall: { totalCalls: 0, totalEvaluated: 0, pfeWinRate: null } };
598
+ }
495
599
  return {
496
600
  contents: [{
497
601
  uri: 'performance://signal-performance',
498
- text: JSON.stringify(stats, null, 2),
602
+ text: JSON.stringify({ ...stats, equities }, null, 2),
499
603
  mimeType: 'application/json',
500
604
  }],
501
605
  };
@@ -1669,6 +1773,10 @@ async function startHttp() {
1669
1773
  let _analyticsQuestion = '';
1670
1774
  let _analyticsApiKey = null;
1671
1775
  let _analyticsTier = 'free';
1776
+ // GEO-MEASUREMENT-W2 (C1) enum-widening cascade: LLMProviderName widened
1777
+ // with 'perplexity' (architect-ratified). Annotate with the canonical type
1778
+ // (not a stale 4-literal) so future engines need zero touch here. Behavior
1779
+ // unchanged — type annotation only.
1672
1780
  let _analyticsProvider = 'anthropic';
1673
1781
  let _analyticsModel = 'claude-haiku-4-5-20251001';
1674
1782
  try {
@@ -1923,6 +2031,13 @@ async function startHttp() {
1923
2031
  }
1924
2032
  });
1925
2033
  });
2034
+ // X402-BAZAAR-HTTP-REDECLARE-W1: mount the HTTP x402 resource routes (the CDP Bazaar
2035
+ // discovery surface) — ONLY when X402_FACILITATOR=cdp AND BAZAAR_DISCOVERABLE=true.
2036
+ // Defaults (legacy/false) → nothing mounted → /x402/* returns 404 (byte-identical prod).
2037
+ const x402HttpRoutes = (0, x402_http_routes_js_1.mountX402HttpRoutes)(app);
2038
+ if (x402HttpRoutes.length > 0) {
2039
+ console.log(`x402 HTTP resource routes mounted (CDP Bazaar discovery): ${x402HttpRoutes.join(', ')}`);
2040
+ }
1926
2041
  const httpServer = app.listen(port, () => {
1927
2042
  console.log(`crypto-quant-signal-mcp running on http://0.0.0.0:${port}/mcp`);
1928
2043
  console.log(`Health check: http://0.0.0.0:${port}/health`);
@@ -2166,6 +2281,7 @@ function getPerformanceDashboardHtml(opts) {
2166
2281
  <meta charset="utf-8">
2167
2282
  <meta name="viewport" content="width=device-width, initial-scale=1">
2168
2283
  <title>Live Track Record — AlgoVault Labs</title>
2284
+ <meta name="description" content="AlgoVault's live trade-call track record. Every signal is Merkle-anchored on Base L2 for independent on-chain verification. Don't trust; verify.">
2169
2285
  <!-- BEGIN: AlgoVault canonical design loader (DESIGN-W3 / C4, cross-origin) -->
2170
2286
  <link rel="preconnect" href="https://fonts.googleapis.com">
2171
2287
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>