@pgnio/helios-mcp 0.2.8 → 0.4.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 +19 -2
- package/dist/chunk-5LIHYXEF.mjs +4274 -0
- package/dist/chunk-LPDQG4WK.mjs +4274 -0
- package/dist/cli.js +2292 -1370
- package/dist/cli.mjs +8 -4
- package/dist/index.d.mts +1020 -141
- package/dist/index.d.ts +1020 -141
- package/dist/index.js +2245 -992
- package/dist/index.mjs +73 -3
- package/docs/ai-agent-indicators/00_columns.txt +3 -1
- package/docs/ai-agent-mcp/04_trading/01_tools.txt +2 -1
- package/package.json +9 -16
- package/dist/chunk-52XY4KRG.mjs +0 -3038
- package/dist/chunk-7EDI4KLD.mjs +0 -3042
- package/dist/chunk-EIAUO3XE.mjs +0 -2955
- package/dist/chunk-NCF7ASJB.mjs +0 -2986
- package/dist/chunk-NWGWXYTS.mjs +0 -2964
- package/dist/chunk-UHFLF3UG.mjs +0 -3051
- package/dist/chunk-UYCUR7QV.mjs +0 -2994
- package/dist/chunk-V453JYRN.mjs +0 -3051
- package/dist/chunk-WLCFIWFP.mjs +0 -3048
- package/dist/chunk-XE6HRID3.mjs +0 -2992
package/dist/index.mjs
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
|
+
DEFAULT_HELIOS_BASE_URL,
|
|
3
|
+
DEFAULT_HELIOS_SESSION_ISSUER,
|
|
2
4
|
DEFAULT_SNAPSHOT_FIELDS,
|
|
3
5
|
DEFAULT_SNAPSHOT_TOP,
|
|
4
6
|
FileAgentSessionStore,
|
|
@@ -10,7 +12,14 @@ import {
|
|
|
10
12
|
HeliosAgentMcpMarketService,
|
|
11
13
|
HeliosAgentMcpProviderService,
|
|
12
14
|
HeliosAgentMcpTradingService,
|
|
15
|
+
MAX_TOOL_INPUT_ELEMENTS,
|
|
16
|
+
MCP_PROFILES,
|
|
13
17
|
MemoryAgentMcpSessionStore,
|
|
18
|
+
TRADE_KEY_WINDOW_SECONDS,
|
|
19
|
+
accountInputSchema,
|
|
20
|
+
ago,
|
|
21
|
+
assertHeliosBaseUrl,
|
|
22
|
+
candlesInputSchema,
|
|
14
23
|
compactSymbolDetail,
|
|
15
24
|
createHeliosAccountToolDefinitions,
|
|
16
25
|
createHeliosAgentMcpServer,
|
|
@@ -20,17 +29,45 @@ import {
|
|
|
20
29
|
createHeliosMarketToolDefinitions,
|
|
21
30
|
createHeliosProviderToolDefinitions,
|
|
22
31
|
createHeliosTradingToolDefinitions,
|
|
32
|
+
createLeanToolDefinitions,
|
|
33
|
+
entryText,
|
|
23
34
|
formatHeliosLoginPrompt,
|
|
24
35
|
getDefaultHeliosAgentMcpDocsRoot,
|
|
25
36
|
getDefaultHeliosAgentMcpSessionPath,
|
|
37
|
+
isSameHeliosIssuer,
|
|
38
|
+
leanToolsFor,
|
|
39
|
+
marketInputSchema,
|
|
40
|
+
moveText,
|
|
41
|
+
pct,
|
|
26
42
|
pendingAgentLoginSchema,
|
|
43
|
+
positionLine,
|
|
44
|
+
price,
|
|
45
|
+
protectInputSchema,
|
|
46
|
+
renderAccount,
|
|
47
|
+
renderBoard,
|
|
48
|
+
renderCandles,
|
|
49
|
+
renderCoin,
|
|
50
|
+
renderMarket,
|
|
51
|
+
renderMoves,
|
|
52
|
+
renderTrades,
|
|
27
53
|
retryAfterUnauthorizedRefresh,
|
|
54
|
+
smBoardInputSchema,
|
|
55
|
+
smCoinInputSchema,
|
|
56
|
+
smMovesInputSchema,
|
|
28
57
|
toolAnnotations,
|
|
29
58
|
topOfSnapshot,
|
|
59
|
+
tradeInputSchema,
|
|
60
|
+
tradeKeyFor,
|
|
61
|
+
trader,
|
|
62
|
+
tradesInputSchema,
|
|
63
|
+
usd,
|
|
30
64
|
withDataText,
|
|
31
|
-
withSnapshotDefaults
|
|
32
|
-
|
|
65
|
+
withSnapshotDefaults,
|
|
66
|
+
wrongSideTpSl
|
|
67
|
+
} from "./chunk-5LIHYXEF.mjs";
|
|
33
68
|
export {
|
|
69
|
+
DEFAULT_HELIOS_BASE_URL,
|
|
70
|
+
DEFAULT_HELIOS_SESSION_ISSUER,
|
|
34
71
|
DEFAULT_SNAPSHOT_FIELDS,
|
|
35
72
|
DEFAULT_SNAPSHOT_TOP,
|
|
36
73
|
FileAgentSessionStore,
|
|
@@ -42,7 +79,14 @@ export {
|
|
|
42
79
|
HeliosAgentMcpMarketService,
|
|
43
80
|
HeliosAgentMcpProviderService,
|
|
44
81
|
HeliosAgentMcpTradingService,
|
|
82
|
+
MAX_TOOL_INPUT_ELEMENTS,
|
|
83
|
+
MCP_PROFILES,
|
|
45
84
|
MemoryAgentMcpSessionStore,
|
|
85
|
+
TRADE_KEY_WINDOW_SECONDS,
|
|
86
|
+
accountInputSchema,
|
|
87
|
+
ago,
|
|
88
|
+
assertHeliosBaseUrl,
|
|
89
|
+
candlesInputSchema,
|
|
46
90
|
compactSymbolDetail,
|
|
47
91
|
createHeliosAccountToolDefinitions,
|
|
48
92
|
createHeliosAgentMcpServer,
|
|
@@ -52,13 +96,39 @@ export {
|
|
|
52
96
|
createHeliosMarketToolDefinitions,
|
|
53
97
|
createHeliosProviderToolDefinitions,
|
|
54
98
|
createHeliosTradingToolDefinitions,
|
|
99
|
+
createLeanToolDefinitions,
|
|
100
|
+
entryText,
|
|
55
101
|
formatHeliosLoginPrompt,
|
|
56
102
|
getDefaultHeliosAgentMcpDocsRoot,
|
|
57
103
|
getDefaultHeliosAgentMcpSessionPath,
|
|
104
|
+
isSameHeliosIssuer,
|
|
105
|
+
leanToolsFor,
|
|
106
|
+
marketInputSchema,
|
|
107
|
+
moveText,
|
|
108
|
+
pct,
|
|
58
109
|
pendingAgentLoginSchema,
|
|
110
|
+
positionLine,
|
|
111
|
+
price,
|
|
112
|
+
protectInputSchema,
|
|
113
|
+
renderAccount,
|
|
114
|
+
renderBoard,
|
|
115
|
+
renderCandles,
|
|
116
|
+
renderCoin,
|
|
117
|
+
renderMarket,
|
|
118
|
+
renderMoves,
|
|
119
|
+
renderTrades,
|
|
59
120
|
retryAfterUnauthorizedRefresh,
|
|
121
|
+
smBoardInputSchema,
|
|
122
|
+
smCoinInputSchema,
|
|
123
|
+
smMovesInputSchema,
|
|
60
124
|
toolAnnotations,
|
|
61
125
|
topOfSnapshot,
|
|
126
|
+
tradeInputSchema,
|
|
127
|
+
tradeKeyFor,
|
|
128
|
+
trader,
|
|
129
|
+
tradesInputSchema,
|
|
130
|
+
usd,
|
|
62
131
|
withDataText,
|
|
63
|
-
withSnapshotDefaults
|
|
132
|
+
withSnapshotDefaults,
|
|
133
|
+
wrongSideTpSl
|
|
64
134
|
};
|
|
@@ -71,4 +71,6 @@ WHAT HAS HELD UP IN BACKTESTS (out of sample, last 2 years)
|
|
|
71
71
|
- Buying a sharp turn up (hmiv > 0, r15m and r1h turning positive) in a coin whose
|
|
72
72
|
reg is BREAKDOWN or CRASH, especially when the whole market is down (os high, Mti < 0).
|
|
73
73
|
- Fading stretched moves beat chasing them.
|
|
74
|
-
- Shorts did not hold up. Edges are small
|
|
74
|
+
- Shorts did not hold up. Edges are small: about +0.1% a trade after a 0.38% round-trip cost,
|
|
75
|
+
on holds of 1-3 days. Frequent in-and-out trading pays fees without that edge.
|
|
76
|
+
Size small, always use a stop.
|
|
@@ -60,7 +60,8 @@ FINALITY
|
|
|
60
60
|
|
|
61
61
|
TOOL: helios_trading_close
|
|
62
62
|
WHAT IT DOES
|
|
63
|
-
Closes the full open position for a symbol.
|
|
63
|
+
Closes the full open position for a symbol (reduce-only, sized from the live position, so no dust is left).
|
|
64
|
+
HIP-3 symbols take their dex prefix, e.g. xyz:SNDK.
|
|
64
65
|
SCOPE
|
|
65
66
|
orders:write
|
|
66
67
|
INPUT
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pgnio/helios-mcp",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Helios MCP server: connect an AI agent to your Helios account to read markets and your portfolio and
|
|
3
|
+
"version": "0.4.0",
|
|
4
|
+
"description": "Helios MCP server: connect an AI agent to your Helios account to follow the top Hyperliquid traders, read markets and your portfolio, and trade. Most apps can use the hosted URL https://helios.pgn.io/mcp instead.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"homepage": "https://helios.pgn.io/?connect=ai",
|
|
7
7
|
"main": "dist/index.js",
|
|
@@ -33,23 +33,18 @@
|
|
|
33
33
|
"trading"
|
|
34
34
|
],
|
|
35
35
|
"dependencies": {
|
|
36
|
-
"@modelcontextprotocol/sdk": "1.
|
|
37
|
-
"zod": "4.
|
|
36
|
+
"@modelcontextprotocol/sdk": "1.32.2",
|
|
37
|
+
"zod": "4.6.7"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
|
-
"@trivago/prettier-plugin-sort-imports": "6.0.0",
|
|
41
40
|
"@types/node": "24.10.1",
|
|
42
|
-
"@
|
|
43
|
-
"@typescript-eslint/parser": "8.46.4",
|
|
44
|
-
"@vitest/coverage-v8": "4.0.9",
|
|
41
|
+
"@vitest/coverage-v8": "4.1.12",
|
|
45
42
|
"eslint": "9.39.1",
|
|
46
|
-
"eslint-config-prettier": "10.1.8",
|
|
47
|
-
"eslint-plugin-prettier": "5.5.4",
|
|
48
43
|
"prettier": "3.6.2",
|
|
49
44
|
"tsup": "8.5.1",
|
|
50
45
|
"typescript": "5.9.3",
|
|
51
46
|
"typescript-eslint": "8.46.4",
|
|
52
|
-
"vitest": "4.
|
|
47
|
+
"vitest": "4.1.12",
|
|
53
48
|
"@supercodebros/helios-agent": "0.1.0"
|
|
54
49
|
},
|
|
55
50
|
"engines": {
|
|
@@ -58,12 +53,10 @@
|
|
|
58
53
|
"scripts": {
|
|
59
54
|
"build": "tsup",
|
|
60
55
|
"dev": "tsup --watch",
|
|
61
|
-
"lint": "eslint src/**/*.ts",
|
|
62
|
-
"lint:fix": "eslint src/**/*.ts --fix",
|
|
56
|
+
"lint": "eslint \"src/**/*.ts\"",
|
|
57
|
+
"lint:fix": "eslint \"src/**/*.ts\" --fix",
|
|
63
58
|
"test": "vitest run",
|
|
64
59
|
"test:watch": "vitest",
|
|
65
|
-
"typecheck": "tsc --noEmit --project tsconfig.json"
|
|
66
|
-
"format": "prettier . --write",
|
|
67
|
-
"format:check": "prettier . --check"
|
|
60
|
+
"typecheck": "tsc --noEmit --project tsconfig.json"
|
|
68
61
|
}
|
|
69
62
|
}
|