crypto-quant-signal-mcp 1.13.2 โ†’ 1.15.1

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 (70) hide show
  1. package/README.md +48 -25
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +502 -18
  4. package/dist/index.js.map +1 -1
  5. package/dist/lib/chat-analytics-dashboard.d.ts +4 -0
  6. package/dist/lib/chat-analytics-dashboard.d.ts.map +1 -0
  7. package/dist/lib/chat-analytics-dashboard.js +266 -0
  8. package/dist/lib/chat-analytics-dashboard.js.map +1 -0
  9. package/dist/lib/chat-analytics.d.ts +44 -0
  10. package/dist/lib/chat-analytics.d.ts.map +1 -0
  11. package/dist/lib/chat-analytics.js +126 -0
  12. package/dist/lib/chat-analytics.js.map +1 -0
  13. package/dist/lib/chat-engine.d.ts +52 -0
  14. package/dist/lib/chat-engine.d.ts.map +1 -0
  15. package/dist/lib/chat-engine.js +98 -0
  16. package/dist/lib/chat-engine.js.map +1 -0
  17. package/dist/lib/chat-knowledge-formatter.d.ts +30 -0
  18. package/dist/lib/chat-knowledge-formatter.d.ts.map +1 -0
  19. package/dist/lib/chat-knowledge-formatter.js +22 -0
  20. package/dist/lib/chat-knowledge-formatter.js.map +1 -0
  21. package/dist/lib/chat-rate-limit.d.ts +36 -0
  22. package/dist/lib/chat-rate-limit.d.ts.map +1 -0
  23. package/dist/lib/chat-rate-limit.js +108 -0
  24. package/dist/lib/chat-rate-limit.js.map +1 -0
  25. package/dist/lib/knowledge-formatter.d.ts +73 -0
  26. package/dist/lib/knowledge-formatter.d.ts.map +1 -0
  27. package/dist/lib/knowledge-formatter.js +147 -0
  28. package/dist/lib/knowledge-formatter.js.map +1 -0
  29. package/dist/lib/knowledge-index.d.ts +29 -0
  30. package/dist/lib/knowledge-index.d.ts.map +1 -0
  31. package/dist/lib/knowledge-index.js +252 -0
  32. package/dist/lib/knowledge-index.js.map +1 -0
  33. package/dist/lib/knowledge-store.d.ts +22 -0
  34. package/dist/lib/knowledge-store.d.ts.map +1 -0
  35. package/dist/lib/knowledge-store.js +171 -0
  36. package/dist/lib/knowledge-store.js.map +1 -0
  37. package/dist/lib/llm-pricing.d.ts +41 -0
  38. package/dist/lib/llm-pricing.d.ts.map +1 -0
  39. package/dist/lib/llm-pricing.js +69 -0
  40. package/dist/lib/llm-pricing.js.map +1 -0
  41. package/dist/lib/llm-provider.d.ts +44 -0
  42. package/dist/lib/llm-provider.d.ts.map +1 -0
  43. package/dist/lib/llm-provider.js +115 -0
  44. package/dist/lib/llm-provider.js.map +1 -0
  45. package/dist/lib/mcp-usage-docs.d.ts +1 -1
  46. package/dist/lib/mcp-usage-docs.d.ts.map +1 -1
  47. package/dist/lib/mcp-usage-docs.js +142 -3
  48. package/dist/lib/mcp-usage-docs.js.map +1 -1
  49. package/dist/lib/result-cache.d.ts +13 -0
  50. package/dist/lib/result-cache.d.ts.map +1 -0
  51. package/dist/lib/result-cache.js +44 -0
  52. package/dist/lib/result-cache.js.map +1 -0
  53. package/dist/lib/search-engine.d.ts +29 -0
  54. package/dist/lib/search-engine.d.ts.map +1 -0
  55. package/dist/lib/search-engine.js +62 -0
  56. package/dist/lib/search-engine.js.map +1 -0
  57. package/dist/lib/search-knowledge-formatter.d.ts +26 -0
  58. package/dist/lib/search-knowledge-formatter.d.ts.map +1 -0
  59. package/dist/lib/search-knowledge-formatter.js +22 -0
  60. package/dist/lib/search-knowledge-formatter.js.map +1 -0
  61. package/dist/scripts/chat-analytics-digest.d.ts +19 -0
  62. package/dist/scripts/chat-analytics-digest.d.ts.map +1 -0
  63. package/dist/scripts/chat-analytics-digest.js +175 -0
  64. package/dist/scripts/chat-analytics-digest.js.map +1 -0
  65. package/dist/tool-descriptions.d.ts +3 -1
  66. package/dist/tool-descriptions.d.ts.map +1 -1
  67. package/dist/tool-descriptions.js +20 -2
  68. package/dist/tool-descriptions.js.map +1 -1
  69. package/package.json +6 -2
  70. package/server.json +2 -2
package/README.md CHANGED
@@ -1,4 +1,3 @@
1
-
2
1
  <p align="center">
3
2
  <a href="https://algovault.com">
4
3
  <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/logo.png" alt="AlgoVault" width="120" />
@@ -33,20 +32,14 @@
33
32
 
34
33
  ---
35
34
 
36
- ## ๐Ÿ“Š Live Track Record โ€” Public, Verifiable, On-Chain
37
-
38
- <p align="center">
39
- <a href="https://algovault.com/track-record">
40
- <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/track-record-2026-05-16.png" alt="AlgoVault Live Track Record โ€” 90.5% PFE Win Rate across 92,995 trade calls, 36 Merkle batches anchored on Base L2" width="100%" />
41
- </a>
42
- </p>
35
+ ## ๐Ÿ“Š Live Track Record
43
36
 
44
37
  <p align="center">
45
- <strong><span data-tr-field="pfe_wr">90.5%</span> PFE Win Rate</strong> ยท <strong><span data-tr-field="total_calls">92,995</span> trade calls</strong> ยท <strong><span data-tr-field="merkle_batches">36</span> on-chain batches</strong> ยท <strong><span data-tr-field="hold_rate">99%</span> HOLD rate</strong> <!-- SNAPSHOT-LINE -->
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 -->
46
39
  </p>
47
40
 
48
41
  <p align="center">
49
- 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>
42
+ Every call is hashed at emission and anchored on Base L2 daily. We can't edit history.
50
43
  </p>
51
44
 
52
45
  <p align="center">
@@ -85,27 +78,56 @@ AlgoVault MCP serves Streamable HTTP at `https://api.algovault.com/mcp` โ€” MCP-
85
78
 
86
79
  MCP `tools/list` + `resources/list` is the API surface. No `@algovault/sdk`; the protocol is the contract.
87
80
 
81
+ Building inside an agent framework? See the **Framework integrations** section below for drop-in tutorials.
82
+
83
+ ---
84
+
85
+ ## Framework integrations
86
+
87
+ Drop-in tutorials for the major Python agent frameworks. Each tutorial pairs AlgoVault MCP with the framework's canonical MCP-adapter library โ€” copy-pasteable demo code, no AlgoVault SDK required.
88
+
89
+ | Framework | Tutorial | Runnable demo | Mirror |
90
+ |---|---|---|---|
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
+
96
+ 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
+
88
98
  ---
89
99
 
90
- ## What's new in v1.13.2
100
+ ## What's new in v1.15.1
101
+
102
+ Live since 2026-05-18:
103
+
104
+ - **๐Ÿ“Š Chat usage analytics.** Admin-gated `/admin/chat-analytics` dashboard with weekly Telegram digest. PII-safe per-call telemetry.
105
+ - **๐ŸŽจ Track-record dashboard polish.** LATEST TRADE CALLS panel now matches surrounding card surfaces (visual unification).
106
+ - **๐Ÿ“ฆ npm catches up.** v1.15.0 was published to MCP Registry + LobeHub + DXT + GitHub Release but skipped `npm publish`. v1.15.1 publishes to all surfaces simultaneously.
107
+
108
+ ### v1.15.0 highlights (recap)
109
+
110
+ - **๐Ÿ”Ž `search_knowledge` MCP tool.** BM25 lexical search over AlgoVault's full knowledge bundle. Free, fast, no LLM call, no quota cost. Also available via `POST /api/search`.
111
+ - **๐Ÿ’ฌ `chat_knowledge` MCP tool.** Natural-language Q&A with citations, grounded in the canonical knowledge bundle. Backed by Claude Haiku 4.5 with prompt caching. Also available via `POST /api/chat`.
112
+ - **๐Ÿ” Zero manual refresh.** Both tools index the auto-generated `dist/knowledge/latest.json` bundle via an in-process `fs.watchFile` poll (30s).
91
113
 
92
- Live since 2026-05-16:
114
+ ### v1.14.1 highlights (recap)
93
115
 
94
- - **๐ŸŽฏ Tool descriptions rewritten for Anthropic Tool Search.** `get_trade_call`, `scan_funding_arb`, `get_market_regime` (plus the `get_trade_signal` alias) now rank cleanly under BOTH `tool_search_tool_regex_20251119` + `tool_search_tool_bm25_20251119`, which retrieve over `tools/list` name + description + arg-name + arg-description. Combined-text coverage hits โ‰ฅ15 of 20 canonical search phrases AI-agent builders actually type. `get_market_regime` no longer claims "for a Hyperliquid perp" โ€” description now reflects the actual 5-venue coverage. Zero schema mutation; same enum members, same defaults, same Zod constraints.
95
- - **Cache-refresh recommended.** MCP clients cache tools/list at session start. To pick up the refreshed tool descriptions โ€” Claude.ai / Claude Desktop: toggle connector off+on. Cursor / Cline: restart MCP server connection.
116
+ - **๐Ÿง  Auto-generated knowledge bundle JSON.** New public endpoints `https://api.algovault.com/knowledge/latest.json` (+ versioned `/knowledge/v1.14.1.json` + index `/knowledge/index.json`) serve a single source-derived `KnowledgeBundle` (every MCP tool description, response-shape audit snapshot, integration tutorial, package metadata, README "What's new" section) indexed for LLM consumption. Discoverable via MCP resource scheme `algovault://knowledge/latest`. Also attached as a GitHub Release asset on every `npm version`. Cache-Control: 1 hour. Foundation for v1.15.0's `search_knowledge` / `chat_knowledge` agent tools above.
117
+ - **๐Ÿชช `get_trade_signal` alias description refreshed.** The `[ALIAS]` tag prefix replaces the prior parenthetical suffix. Future tool aliases follow the same shape.
96
118
 
97
- ### v1.13.0 highlights (recap)
119
+ ### v1.14.0 highlights (recap)
98
120
 
99
- - **๐Ÿชช ERC-8004 Verified Agent on Base.** AlgoVault MCP is now registered on the canonical ERC-8004 Identity Registry at [`0x8004A169...e539a432`](https://basescan.org/address/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432). Each call you make traces back to a portable, censorship-resistant agent identity on Base L2. Same on-chain track record, plus a verified agent handle that AI orchestrators can resolve. agentId [`44544`](https://basescan.org/token/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432?a=44544). Verify on Basescan.
100
- - **๐Ÿ”Œ New `/api/erc-8004-reputation` endpoint.** Read-only JSON aggregator exposing agentId, identity registry address, registration timestamp, and Basescan link. Cached 5 minutes. Drop-in for any agent that wants to verify AlgoVault's on-chain handle programmatically. See `curl -s api.algovault.com/api/erc-8004-reputation | jq`.
101
- - **๐Ÿงญ Attestation pipeline rolling out separately.** The per-call on-chain attestation flow is in active design. v1.13.0 ships the identity layer cleanly; reputation scoring lands once the canonical ValidationRegistry deployment on Base mainnet is finalized upstream.
121
+ - **๐Ÿงฉ Framework integrations live.** 4 drop-in tutorials shipped in [algovault-skills](https://github.com/AlgoVaultLabs/algovault-skills): LangChain, LlamaIndex, Microsoft Agent Framework, CrewAI. Each tutorial pairs AlgoVault MCP with the framework's canonical MCP-adapter library. Copy-pasteable demo code; no SDK required. See the [Framework integrations](#framework-integrations) section above.
122
+ - **๐Ÿ“ฆ Cross-linked from algovault-skills + signal-MCP READMEs.** Both repos surface the 4 tutorials so framework users discovering AlgoVault from either side find the right entry point.
102
123
 
103
- ### v1.12.0 highlights (recap)
124
+ ### v1.13.2 highlights (recap)
104
125
 
105
- - **๐Ÿช DEX adapters added โ€” Aster + edgeX (experimental).** AlgoVault now produces signals on 2 DEX venues in shadow phase. DEX signals are produced internally for validation; promotion to the public `get_trade_call` exchange parameter happens after the shadow cohort meets the same performance bar as the 5 CEX. Direct callers continue to target the 5 CEX (Binance / Hyperliquid / Bybit / OKX / Bitget).
106
- - **๐Ÿท๏ธ Per-CEX TradFi symbol aliasing (v1.11.1).** `get_trade_call({coin:"GOLD", exchange:"BINANCE"})` now resolves to `XAUUSDT` natively. 4 CEX ร— 4-6 TradFi aliases (GOLD/SILVER/PLATINUM/PALLADIUM, plus COPPER/NATGAS on OKX). Unsupported venue + asset combinations return a structured `TRADFI_SYMBOL_UNSUPPORTED_ON_VENUE` error with `suggested_venues` so agents can self-retry.
126
+ - **๐Ÿ”Ž Tool descriptions rewritten for retrieval ranking.** `get_trade_call`, `scan_funding_arb`, `get_market_regime` descriptions rewritten for Anthropic Tool Search (BM25 + regex retrieval over `tools/list`). Param `describe()` strings tightened. Zero schema mutation โ€” same enum members, same defaults, same Zod constraints. Pure prose payload change.
127
+ - **๐Ÿชช 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.
128
+ - **๐Ÿ”Œ `/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`.
107
129
 
108
- > **Upgrading from v1.12.x or earlier?** The MCP tool surface is unchanged structurally โ€” `get_trade_call`, `scan_funding_arb`, `get_market_regime` keep their parameter shapes. v1.13.0 only adds a new HTTP endpoint (`/api/erc-8004-reputation`) and a public-facing badge. MCP clients (Claude Desktop, Cursor, Cline) cache `tools/list` at session start โ€” toggle the connector off/on to pick up the latest catalog metadata.
130
+ > **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.
109
131
 
110
132
  ---
111
133
 
@@ -122,8 +144,9 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
122
144
  - **Cross-venue intelligence.** Full signal generation on 5 exchanges with native candle, OI, funding, and volume data per venue. 2 DEX venues (Aster, edgeX) in experimental shadow phase. Cross-venue funding arbitrage scanning across the major CEX โ€” nobody else does multi-exchange derivatives analysis via MCP. <!-- SNAPSHOT-LINE -->
123
145
  - **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.**
124
146
  - **ERC-8004 verified agent.** AlgoVault MCP holds a registered agentId on the Base L2 Identity Registry. The agent identity is portable and on-chain.
147
+ - **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.
125
148
  - **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.
126
- - **Crypto + TradFi coverage.** 730+ assets โ€” standard crypto perps on all 5 CEX; TradFi perps (stocks, indices, commodities, FX); liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
149
+ - **Crypto + TradFi coverage.** 740+ assets โ€” standard crypto perps on all 5 CEX; TradFi perps (stocks, indices, commodities, FX); liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
127
150
 
128
151
  ---
129
152
 
@@ -198,7 +221,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
198
221
  { "coin": "SOL", "timeframe": "15m", "confidence": 73 }
199
222
  ],
200
223
  "_algovault": {
201
- "version": "1.13.1",
224
+ "version": "1.14.0",
202
225
  "tool": "get_trade_call",
203
226
  "compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
204
227
  }
@@ -259,7 +282,7 @@ or pay per call via x402.
259
282
  | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
260
283
  |---------|------|-------------------|-------------|---------------------|-----------------|
261
284
  | Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
262
- | Assets | All 730+ | All 730+ | All 730+ | All 730+ | All 730+ | <!-- SNAPSHOT-LINE-TABLE -->
285
+ | Assets | All 740+ | All 740+ | All 740+ | All 740+ | All 740+ | <!-- SNAPSHOT-LINE-TABLE -->
263
286
  | Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
264
287
  | Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
265
288
  | Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAwxEtF,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;AA6yFtF,wBAAgB,mBAAmB,cAElC"}