@pgnio/helios-mcp 0.2.8 → 0.4.0

package/README.md

@@ -1,6 +1,7 @@
 # @pgnio/helios-mcp
 
-Connect an AI agent to your Helios account: read markets and your portfolio, and trade on Hyperliquid.
+Connect an AI agent to your Helios account: follow what the top Hyperliquid traders are doing, read markets and your
+portfolio, and trade.
 
 ## Easiest: the hosted link (no install)
 
@@ -14,6 +15,20 @@ https://helios.pgn.io/mcp
 Step-by-step for Claude, ChatGPT, Cursor, VS Code and Claude Code: Helios → Account → AI agents, or
 https://helios.pgn.io/?connect=ai.
 
+## Tool profiles
+
+| URL (hosted) | `HELIOS_MCP_PROFILE` (local) | Tools | For |
+| --- | --- | --- | --- |
+| `/mcp` | `lean` (default) | `sm_board`, `sm_moves`, `sm_coin`, `market`, `account`, `trades`, `trade`, `protect`, `candles` | Most agents, and small local models |
+| `/mcp/signals` | `signals` | the reads above, no `trade` or `protect` | Agents that watch but never trade |
+| `/mcp/full` | `full` | lean plus the full ~50-column snapshot, symbol detail with raw indicators, fills and the indicator docs | Strong models doing their own analysis |
+
+Every lean answer is short text (a first line that answers, then one line per row) plus the same data as structured
+JSON for apps that read it. `sm_moves` takes `since=<next>` from its last answer, so polling for new trades is cheap.
+
+Small local models (Qwen 27B with a 32k context): use the lean profile and turn thinking down (`reasoning_effort` low
+or `enable_thinking` false); the lean tool list is about 1.5k tokens.
+
 ## Local server (apps that only run local MCP servers)
 
 ```json
@@ -21,7 +36,8 @@ https://helios.pgn.io/?connect=ai.
   "mcpServers": {
     "helios": {
       "command": "npx",
-      "args": ["-y", "@pgnio/helios-mcp"]
+      "args": ["-y", "@pgnio/helios-mcp"],
+      "env": { "HELIOS_MCP_PROFILE": "lean" }
     }
   }
 }
@@ -31,6 +47,7 @@ The first tool call prints a Helios link to approve.
 
 Optional environment variables (defaults point at Helios):
 
+- `HELIOS_MCP_PROFILE`: `lean` (default), `signals` or `full`
 - `HELIOS_IDENTITY_SERVICE_URL`
 - `HELIOS_DATA_BRIDGE_URL`
 - `HELIOS_AGENT_MCP_SESSION_PATH`