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.
- package/README.md +34 -0
- package/dist/facilitator.d.ts +3 -0
- package/dist/facilitator.d.ts.map +1 -0
- package/dist/facilitator.js +99 -0
- package/dist/facilitator.js.map +1 -0
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +465 -15
- package/dist/index.js.map +1 -1
- package/dist/lib/adapters/hyperliquid.d.ts.map +1 -1
- package/dist/lib/adapters/hyperliquid.js +5 -3
- package/dist/lib/adapters/hyperliquid.js.map +1 -1
- package/dist/lib/analytics.d.ts +17 -0
- package/dist/lib/analytics.d.ts.map +1 -0
- package/dist/lib/analytics.js +81 -0
- package/dist/lib/analytics.js.map +1 -0
- package/dist/lib/license.d.ts +20 -1
- package/dist/lib/license.d.ts.map +1 -1
- package/dist/lib/license.js +31 -5
- package/dist/lib/license.js.map +1 -1
- package/dist/lib/performance-db.d.ts +14 -1
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +96 -6
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/x402.d.ts +24 -23
- package/dist/lib/x402.d.ts.map +1 -1
- package/dist/lib/x402.js +213 -36
- package/dist/lib/x402.js.map +1 -1
- package/dist/resources/analytics-summary.d.ts +2 -0
- package/dist/resources/analytics-summary.d.ts.map +1 -0
- package/dist/resources/analytics-summary.js +16 -0
- package/dist/resources/analytics-summary.js.map +1 -0
- package/dist/resources/signal-performance.d.ts +1 -0
- package/dist/resources/signal-performance.d.ts.map +1 -1
- package/dist/resources/signal-performance.js +24 -8
- package/dist/resources/signal-performance.js.map +1 -1
- package/dist/scripts/backfill-outcomes.d.ts +19 -0
- package/dist/scripts/backfill-outcomes.d.ts.map +1 -0
- package/dist/scripts/backfill-outcomes.js +131 -0
- package/dist/scripts/backfill-outcomes.js.map +1 -0
- package/dist/scripts/seed-signals.d.ts +24 -0
- package/dist/scripts/seed-signals.d.ts.map +1 -0
- package/dist/scripts/seed-signals.js +122 -0
- package/dist/scripts/seed-signals.js.map +1 -0
- package/dist/tools/get-market-regime.js +5 -5
- package/dist/tools/get-market-regime.js.map +1 -1
- package/dist/tools/get-trade-signal.d.ts.map +1 -1
- package/dist/tools/get-trade-signal.js +129 -42
- package/dist/tools/get-trade-signal.js.map +1 -1
- package/dist/tools/scan-funding-arb.d.ts.map +1 -1
- package/dist/tools/scan-funding-arb.js +16 -1
- package/dist/tools/scan-funding-arb.js.map +1 -1
- package/dist/types.d.ts +7 -4
- package/dist/types.d.ts.map +1 -1
- package/logo.png +0 -0
- package/package.json +9 -1
- package/server.json +8 -7
- 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 @@
|
|
|
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
package/dist/index.d.ts.map
CHANGED
|
@@ -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"}
|