crypto-quant-signal-mcp 1.1.0 → 1.2.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 (58) hide show
  1. package/README.md +34 -0
  2. package/dist/facilitator.d.ts +3 -0
  3. package/dist/facilitator.d.ts.map +1 -0
  4. package/dist/facilitator.js +99 -0
  5. package/dist/facilitator.js.map +1 -0
  6. package/dist/index.d.ts +2 -1
  7. package/dist/index.d.ts.map +1 -1
  8. package/dist/index.js +465 -15
  9. package/dist/index.js.map +1 -1
  10. package/dist/lib/adapters/hyperliquid.d.ts.map +1 -1
  11. package/dist/lib/adapters/hyperliquid.js +5 -3
  12. package/dist/lib/adapters/hyperliquid.js.map +1 -1
  13. package/dist/lib/analytics.d.ts +17 -0
  14. package/dist/lib/analytics.d.ts.map +1 -0
  15. package/dist/lib/analytics.js +81 -0
  16. package/dist/lib/analytics.js.map +1 -0
  17. package/dist/lib/license.d.ts +20 -1
  18. package/dist/lib/license.d.ts.map +1 -1
  19. package/dist/lib/license.js +31 -5
  20. package/dist/lib/license.js.map +1 -1
  21. package/dist/lib/performance-db.d.ts +14 -1
  22. package/dist/lib/performance-db.d.ts.map +1 -1
  23. package/dist/lib/performance-db.js +96 -6
  24. package/dist/lib/performance-db.js.map +1 -1
  25. package/dist/lib/x402.d.ts +24 -23
  26. package/dist/lib/x402.d.ts.map +1 -1
  27. package/dist/lib/x402.js +213 -36
  28. package/dist/lib/x402.js.map +1 -1
  29. package/dist/resources/analytics-summary.d.ts +2 -0
  30. package/dist/resources/analytics-summary.d.ts.map +1 -0
  31. package/dist/resources/analytics-summary.js +16 -0
  32. package/dist/resources/analytics-summary.js.map +1 -0
  33. package/dist/resources/signal-performance.d.ts +1 -0
  34. package/dist/resources/signal-performance.d.ts.map +1 -1
  35. package/dist/resources/signal-performance.js +24 -8
  36. package/dist/resources/signal-performance.js.map +1 -1
  37. package/dist/scripts/backfill-outcomes.d.ts +19 -0
  38. package/dist/scripts/backfill-outcomes.d.ts.map +1 -0
  39. package/dist/scripts/backfill-outcomes.js +131 -0
  40. package/dist/scripts/backfill-outcomes.js.map +1 -0
  41. package/dist/scripts/seed-signals.d.ts +24 -0
  42. package/dist/scripts/seed-signals.d.ts.map +1 -0
  43. package/dist/scripts/seed-signals.js +122 -0
  44. package/dist/scripts/seed-signals.js.map +1 -0
  45. package/dist/tools/get-market-regime.js +5 -5
  46. package/dist/tools/get-market-regime.js.map +1 -1
  47. package/dist/tools/get-trade-signal.d.ts.map +1 -1
  48. package/dist/tools/get-trade-signal.js +129 -42
  49. package/dist/tools/get-trade-signal.js.map +1 -1
  50. package/dist/tools/scan-funding-arb.d.ts.map +1 -1
  51. package/dist/tools/scan-funding-arb.js +16 -1
  52. package/dist/tools/scan-funding-arb.js.map +1 -1
  53. package/dist/types.d.ts +7 -4
  54. package/dist/types.d.ts.map +1 -1
  55. package/logo.png +0 -0
  56. package/package.json +9 -1
  57. package/server.json +8 -7
  58. package/smithery.yaml +1 -1
package/README.md CHANGED
@@ -1,3 +1,7 @@
1
+ <p align="center">
2
+ <img src="logo.png" alt="AlgoVault" width="120" />
3
+ </p>
4
+
1
5
  # crypto-quant-signal-mcp
2
6
 
3
7
  AI trading brain for crypto perps — composite signals, funding rate arb scanning, and market regime detection via MCP. Powered by Hyperliquid data. Remote-first with x402 micropayments.
@@ -159,6 +163,26 @@ docker compose up -d
159
163
  - **Exchange adapter:** Pluggable — Hyperliquid today, Binance/Bybit adapters in Phase 2
160
164
  - **x402 payments:** USDC on Base chain per x402.org spec
161
165
 
166
+ ## Examples
167
+
168
+ **Get a trade signal:**
169
+ ```
170
+ User: "Get me a trade signal for BTC on the 1h timeframe"
171
+ → Returns: BUY/SELL/HOLD with 72% confidence, RSI=66.7, EMA cross bullish, funding neutral
172
+ ```
173
+
174
+ **Scan funding arbitrage:**
175
+ ```
176
+ User: "Scan for funding rate arbitrage opportunities"
177
+ → Returns: Top 5 cross-venue spreads (HL vs Binance vs Bybit), annualized returns
178
+ ```
179
+
180
+ **Check market regime:**
181
+ ```
182
+ User: "What's the market regime for ETH?"
183
+ → Returns: TRENDING_UP, ADX=34.2, volatility moderate, cross-venue funding sentiment
184
+ ```
185
+
162
186
  ## Suite Compatibility
163
187
 
164
188
  All tools output an `_algovault` metadata block for composability with future AlgoVault tools:
@@ -169,6 +193,16 @@ All tools output an `_algovault` metadata block for composability with future Al
169
193
  | `scan_funding_arb` | `crypto-quant-risk-mcp`, `crypto-quant-execution-mcp` |
170
194
  | `get_market_regime` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
171
195
 
196
+ ## Privacy Policy
197
+
198
+ crypto-quant-signal-mcp connects to Hyperliquid's public API (api.hyperliquid.xyz) to fetch market data. In local/stdio mode:
199
+ - No data is sent to AlgoVault Labs servers
200
+ - Signal history is stored locally in SQLite (~/.crypto-quant-signal/performance.db)
201
+ - No personal information is collected
202
+ - No telemetry or analytics in local mode
203
+
204
+ In remote mode (api.algovault.com/mcp), requests are logged for analytics (IP hashed, never stored raw). See https://algovault.com/privacy for full details.
205
+
172
206
  ## License
173
207
 
174
208
  MIT
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=facilitator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../src/facilitator.ts"],"names":[],"mappings":""}
@@ -0,0 +1,99 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ var __importDefault = (this && this.__importDefault) || function (mod) {
4
+ return (mod && mod.__esModule) ? mod : { "default": mod };
5
+ };
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ /**
8
+ * Self-hosted x402 Facilitator for Base mainnet.
9
+ *
10
+ * Verifies ERC-3009 signatures and settles USDC transfers on-chain.
11
+ * The facilitator wallet only needs ETH for gas (~$0.001-0.01 per tx).
12
+ * USDC flows directly from payer → recipient (your Rabby wallet).
13
+ *
14
+ * Endpoints (matching HTTPFacilitatorClient expectations):
15
+ * POST /verify — verify a payment signature
16
+ * POST /settle — submit the on-chain transfer
17
+ * GET /supported — list supported schemes/networks
18
+ * GET /health — health check
19
+ *
20
+ * Env vars:
21
+ * FACILITATOR_PRIVATE_KEY — hex private key for the gas wallet
22
+ * FACILITATOR_PORT — port to listen on (default: 4022)
23
+ */
24
+ const express_1 = __importDefault(require("express"));
25
+ const viem_1 = require("viem");
26
+ const accounts_1 = require("viem/accounts");
27
+ const chains_1 = require("viem/chains");
28
+ const facilitator_1 = require("@x402/core/facilitator");
29
+ const evm_1 = require("@x402/evm");
30
+ // Facilitator-side ExactEvmScheme (different from the client-side one)
31
+ const facilitator_2 = require("@x402/evm/exact/facilitator");
32
+ const PORT = parseInt(process.env.FACILITATOR_PORT || '4022', 10);
33
+ const PRIVATE_KEY = process.env.FACILITATOR_PRIVATE_KEY;
34
+ if (!PRIVATE_KEY) {
35
+ console.error('FACILITATOR_PRIVATE_KEY is required');
36
+ process.exit(1);
37
+ }
38
+ // ── EVM Wallet ──
39
+ const account = (0, accounts_1.privateKeyToAccount)(PRIVATE_KEY);
40
+ const viemClient = (0, viem_1.createWalletClient)({
41
+ account,
42
+ chain: chains_1.base,
43
+ transport: (0, viem_1.http)(), // viem default Base RPC
44
+ }).extend(viem_1.publicActions);
45
+ const evmSigner = (0, evm_1.toFacilitatorEvmSigner)({
46
+ address: account.address,
47
+ getCode: (args) => viemClient.getCode(args),
48
+ readContract: (args) => viemClient.readContract({ ...args, args: args.args || [] }),
49
+ verifyTypedData: (args) => viemClient.verifyTypedData(args),
50
+ writeContract: (args) => viemClient.writeContract({ ...args, args: args.args || [] }),
51
+ sendTransaction: (args) => viemClient.sendTransaction(args),
52
+ waitForTransactionReceipt: (args) => viemClient.waitForTransactionReceipt(args),
53
+ });
54
+ // ── Facilitator ──
55
+ const facilitator = new facilitator_1.x402Facilitator();
56
+ facilitator.register('eip155:8453', new facilitator_2.ExactEvmScheme(evmSigner));
57
+ facilitator.onAfterSettle(async (ctx) => {
58
+ console.log(`[settle] tx=${ctx.result.transaction} payer=${ctx.result.payer} success=${ctx.result.success}`);
59
+ });
60
+ facilitator.onSettleFailure(async (ctx) => {
61
+ console.error(`[settle-fail] ${ctx.error.message}`);
62
+ });
63
+ // ── HTTP Server ──
64
+ const app = (0, express_1.default)();
65
+ app.use(express_1.default.json());
66
+ app.post('/verify', async (req, res) => {
67
+ try {
68
+ const { paymentPayload, paymentRequirements } = req.body;
69
+ const result = await facilitator.verify(paymentPayload, paymentRequirements);
70
+ res.json(result);
71
+ }
72
+ catch (err) {
73
+ console.error('verify error:', err);
74
+ res.status(500).json({ error: err instanceof Error ? err.message : 'Unknown error' });
75
+ }
76
+ });
77
+ app.post('/settle', async (req, res) => {
78
+ try {
79
+ const { paymentPayload, paymentRequirements } = req.body;
80
+ const result = await facilitator.settle(paymentPayload, paymentRequirements);
81
+ res.json(result);
82
+ }
83
+ catch (err) {
84
+ console.error('settle error:', err);
85
+ res.status(500).json({ error: err instanceof Error ? err.message : 'Unknown error' });
86
+ }
87
+ });
88
+ app.get('/supported', (_req, res) => {
89
+ res.json(facilitator.getSupported());
90
+ });
91
+ app.get('/health', (_req, res) => {
92
+ res.json({ status: 'ok', wallet: account.address, network: 'eip155:8453' });
93
+ });
94
+ app.listen(PORT, () => {
95
+ console.log(`x402 facilitator running on http://0.0.0.0:${PORT}`);
96
+ console.log(`Network: Base mainnet (eip155:8453)`);
97
+ console.log(`Gas wallet: ${account.address}`);
98
+ });
99
+ //# sourceMappingURL=facilitator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../src/facilitator.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,3 +1,4 @@
1
1
  #!/usr/bin/env node
2
- export {};
2
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
+ export declare function createSandboxServer(): McpServer;
3
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+pBpE,wBAAgB,mBAAmB,cAElC"}