@pgnio/helios-mcp 0.2.2 → 0.2.4

package/dist/cli.js

@@ -220,7 +220,9 @@ var marketSnapshotResolvedScopeSchema = import_zod.z.enum(["selected", "all", "e
 var marketSnapshotValueSchema = import_zod.z.union([import_zod.z.string(), import_zod.z.number(), import_zod.z.boolean(), import_zod.z.null()]);
 var marketSnapshotInputSchema = import_zod.z.object({
   scope: marketSnapshotScopeSchema.optional(),
-  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional()
+  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional(),
+  fields: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional().describe("Table columns to return; sym and base always come back. Ids: rank, lp, bv, qv, ts, r1m, r3m, r5m, r15m, r30m, r1h, r2h, r4h, r6h, r8h, r12h, r24h, r3d, r7d, hmi, hmiv, reg, ob, de, hfi, ar, ms, vcc, vcp, obosd, obosp, vwap, vwz, poc, pocd, vap, macdh, macds, macdd, srs, srr, sr, az, hfiw, trv, tri, trh, hs."),
+  sort: import_zod.z.enum(["rank"]).optional().describe('"rank" orders rows by market cap rank, unranked last.')
 });
 var marketSnapshotChunkInputSchema = marketSnapshotInputSchema.extend({
   offset: import_zod.z.number().int().nonnegative().optional(),
@@ -1423,6 +1425,46 @@ function asPending(login) {
 }
 
 // src/market-service.ts
+var DEFAULT_SNAPSHOT_TOP = 50;
+var DEFAULT_SNAPSHOT_FIELDS = [
+  // Price, size and returns.
+  "rank",
+  "lp",
+  "qv",
+  "r15m",
+  "r1h",
+  "r4h",
+  "r24h",
+  "r7d",
+  // Regime and momentum turn: the one edge that held out of sample is buying a sharp turn up in a BREAKDOWN/CRASH coin.
+  "reg",
+  "hmi",
+  "hmiv",
+  "hs",
+  // Stretch and location: fades beat chases in the wallet research.
+  "ob",
+  "obosp",
+  "de",
+  "ms",
+  "srs",
+  "srr",
+  "vwz",
+  "tri"
+];
+function withSnapshotDefaults(input) {
+  return {
+    ...input,
+    fields: input.fields ?? [...DEFAULT_SNAPSHOT_FIELDS],
+    sort: input.sort ?? "rank"
+  };
+}
+function topOfSnapshot(snapshot, input, top = DEFAULT_SNAPSHOT_TOP) {
+  if (input.symbols?.length || snapshot.table.rows.length <= top) return snapshot;
+  const baseIndex = snapshot.table.fieldIds.indexOf("base");
+  const rows = snapshot.table.rows.slice(0, top);
+  const returnedSymbols = baseIndex === -1 ? snapshot.returnedSymbols.slice(0, top) : rows.map((row) => String(row[baseIndex]));
+  return { ...snapshot, symbolCount: rows.length, returnedSymbols, table: { ...snapshot.table, rows } };
+}
 var HeliosAgentMcpMarketService = class {
   constructor(options) {
     __publicField(this, "authService");
@@ -1445,7 +1487,7 @@ var HeliosAgentMcpMarketService = class {
     }
     const session = await this.authService.requireSession();
     try {
-      const snapshot = await this.dataBridgeClient.getMarketSnapshot(session.accessToken, input);
+      const snapshot = topOfSnapshot(await this.dataBridgeClient.getMarketSnapshot(session.accessToken, withSnapshotDefaults(input)), input);
       return {
         status: "connected",
         connected: true,
@@ -1457,7 +1499,7 @@ var HeliosAgentMcpMarketService = class {
         error,
         loginOptions,
         retry: async (accessToken) => {
-          const snapshot = await this.dataBridgeClient.getMarketSnapshot(accessToken, input);
+          const snapshot = topOfSnapshot(await this.dataBridgeClient.getMarketSnapshot(accessToken, withSnapshotDefaults(input)), input);
           return {
             status: "connected",
             connected: true,
@@ -1486,7 +1528,7 @@ var HeliosAgentMcpMarketService = class {
     }
     const session = await this.authService.requireSession();
     try {
-      const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(session.accessToken, input);
+      const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(session.accessToken, withSnapshotDefaults(input));
       return {
         status: "connected",
         connected: true,
@@ -1498,7 +1540,7 @@ var HeliosAgentMcpMarketService = class {
         error,
         loginOptions,
         retry: async (accessToken) => {
-          const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(accessToken, input);
+          const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(accessToken, withSnapshotDefaults(input));
           return {
             status: "connected",
             connected: true,
@@ -2567,7 +2609,7 @@ function createHeliosMarketToolDefinitions(service) {
     {
       name: "helios_market_get_snapshot",
       title: "Get Helios Market Snapshot",
-      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols.",
+      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols. By default: the top 50 coins by market cap with the main columns; name symbols to get other coins, pass fields for other columns.",
       inputSchema: marketSnapshotInputSchema,
       async execute(input) {
         const result = marketSnapshotToolOutputSchema.parse(await service.getSnapshot(input));
@@ -2835,7 +2877,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.2"
+    version: "0.2.4"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createHeliosAgentMcpServer
-} from "./chunk-XE6HRID3.mjs";
+} from "./chunk-52XY4KRG.mjs";
 
 // src/cli.ts
 async function main() {

package/dist/index.d.mts

@@ -206,6 +206,10 @@ declare const marketSnapshotInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
 }, z.core.$strip>;
 declare const marketSnapshotChunkInputSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodEnum<{
@@ -213,6 +217,10 @@ declare const marketSnapshotChunkInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -945,6 +953,17 @@ type MarketSymbolDetailResult = {
     connected: false;
     message: string;
 } & StartLoginResult);
+/** Coins in a default snapshot: the top ones by market cap. Asking for symbols by name returns exactly those. */
+declare const DEFAULT_SNAPSHOT_TOP = 50;
+/**
+ * Columns an agent gets when it doesn't pass `fields`: price, volume, the main returns and the core Helios indicators.
+ * The full table (~50 columns) is too much context for most models; `fields` still reaches every column.
+ */
+declare const DEFAULT_SNAPSHOT_FIELDS: readonly string[];
+/** Fills in the default columns and market cap order unless the agent chose its own. */
+declare function withSnapshotDefaults<T extends MarketSnapshotInput>(input: T): T;
+/** A ranked snapshot cut to its top coins, unless the agent named its symbols. */
+declare function topOfSnapshot(snapshot: MarketSnapshot, input: MarketSnapshotInput, top?: number): MarketSnapshot;
 declare class HeliosAgentMcpMarketService {
     private readonly authService;
     private readonly dataBridgeClient;
@@ -1457,10 +1476,16 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
     }): Promise<{
         content: {
             type: "text";
@@ -1497,12 +1522,18 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
         offset: z.ZodOptional<z.ZodNumber>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
         offset?: number | undefined;
         limit?: number | undefined;
     }): Promise<{
@@ -2147,4 +2178,4 @@ declare function createHeliosTradingToolDefinitions(service: HeliosAgentMcpTradi
     }>;
 }];
 
-export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, withDataText };
+export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, DEFAULT_SNAPSHOT_FIELDS, DEFAULT_SNAPSHOT_TOP, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, topOfSnapshot, withDataText, withSnapshotDefaults };

package/dist/index.d.ts

@@ -206,6 +206,10 @@ declare const marketSnapshotInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
 }, z.core.$strip>;
 declare const marketSnapshotChunkInputSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodEnum<{
@@ -213,6 +217,10 @@ declare const marketSnapshotChunkInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -945,6 +953,17 @@ type MarketSymbolDetailResult = {
     connected: false;
     message: string;
 } & StartLoginResult);
+/** Coins in a default snapshot: the top ones by market cap. Asking for symbols by name returns exactly those. */
+declare const DEFAULT_SNAPSHOT_TOP = 50;
+/**
+ * Columns an agent gets when it doesn't pass `fields`: price, volume, the main returns and the core Helios indicators.
+ * The full table (~50 columns) is too much context for most models; `fields` still reaches every column.
+ */
+declare const DEFAULT_SNAPSHOT_FIELDS: readonly string[];
+/** Fills in the default columns and market cap order unless the agent chose its own. */
+declare function withSnapshotDefaults<T extends MarketSnapshotInput>(input: T): T;
+/** A ranked snapshot cut to its top coins, unless the agent named its symbols. */
+declare function topOfSnapshot(snapshot: MarketSnapshot, input: MarketSnapshotInput, top?: number): MarketSnapshot;
 declare class HeliosAgentMcpMarketService {
     private readonly authService;
     private readonly dataBridgeClient;
@@ -1457,10 +1476,16 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
     }): Promise<{
         content: {
             type: "text";
@@ -1497,12 +1522,18 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
         offset: z.ZodOptional<z.ZodNumber>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
         offset?: number | undefined;
         limit?: number | undefined;
     }): Promise<{
@@ -2147,4 +2178,4 @@ declare function createHeliosTradingToolDefinitions(service: HeliosAgentMcpTradi
     }>;
 }];
 
-export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, withDataText };
+export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, DEFAULT_SNAPSHOT_FIELDS, DEFAULT_SNAPSHOT_TOP, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, topOfSnapshot, withDataText, withSnapshotDefaults };

package/dist/index.js

@@ -32,6 +32,8 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_SNAPSHOT_FIELDS: () => DEFAULT_SNAPSHOT_FIELDS,
+  DEFAULT_SNAPSHOT_TOP: () => DEFAULT_SNAPSHOT_TOP,
   FileAgentSessionStore: () => FileAgentSessionStore,
   HOSTED_RECONNECT_MESSAGE: () => HOSTED_RECONNECT_MESSAGE,
   HeliosAgentMcpAccountService: () => HeliosAgentMcpAccountService,
@@ -56,7 +58,9 @@ __export(index_exports, {
   pendingAgentLoginSchema: () => pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh: () => retryAfterUnauthorizedRefresh,
   toolAnnotations: () => toolAnnotations,
-  withDataText: () => withDataText
+  topOfSnapshot: () => topOfSnapshot,
+  withDataText: () => withDataText,
+  withSnapshotDefaults: () => withSnapshotDefaults
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -255,7 +259,9 @@ var marketSnapshotResolvedScopeSchema = import_zod.z.enum(["selected", "all", "e
 var marketSnapshotValueSchema = import_zod.z.union([import_zod.z.string(), import_zod.z.number(), import_zod.z.boolean(), import_zod.z.null()]);
 var marketSnapshotInputSchema = import_zod.z.object({
   scope: marketSnapshotScopeSchema.optional(),
-  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional()
+  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional(),
+  fields: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional().describe("Table columns to return; sym and base always come back. Ids: rank, lp, bv, qv, ts, r1m, r3m, r5m, r15m, r30m, r1h, r2h, r4h, r6h, r8h, r12h, r24h, r3d, r7d, hmi, hmiv, reg, ob, de, hfi, ar, ms, vcc, vcp, obosd, obosp, vwap, vwz, poc, pocd, vap, macdh, macds, macdd, srs, srr, sr, az, hfiw, trv, tri, trh, hs."),
+  sort: import_zod.z.enum(["rank"]).optional().describe('"rank" orders rows by market cap rank, unranked last.')
 });
 var marketSnapshotChunkInputSchema = marketSnapshotInputSchema.extend({
   offset: import_zod.z.number().int().nonnegative().optional(),
@@ -1458,6 +1464,46 @@ function asPending(login) {
 }
 
 // src/market-service.ts
+var DEFAULT_SNAPSHOT_TOP = 50;
+var DEFAULT_SNAPSHOT_FIELDS = [
+  // Price, size and returns.
+  "rank",
+  "lp",
+  "qv",
+  "r15m",
+  "r1h",
+  "r4h",
+  "r24h",
+  "r7d",
+  // Regime and momentum turn: the one edge that held out of sample is buying a sharp turn up in a BREAKDOWN/CRASH coin.
+  "reg",
+  "hmi",
+  "hmiv",
+  "hs",
+  // Stretch and location: fades beat chases in the wallet research.
+  "ob",
+  "obosp",
+  "de",
+  "ms",
+  "srs",
+  "srr",
+  "vwz",
+  "tri"
+];
+function withSnapshotDefaults(input) {
+  return {
+    ...input,
+    fields: input.fields ?? [...DEFAULT_SNAPSHOT_FIELDS],
+    sort: input.sort ?? "rank"
+  };
+}
+function topOfSnapshot(snapshot, input, top = DEFAULT_SNAPSHOT_TOP) {
+  if (input.symbols?.length || snapshot.table.rows.length <= top) return snapshot;
+  const baseIndex = snapshot.table.fieldIds.indexOf("base");
+  const rows = snapshot.table.rows.slice(0, top);
+  const returnedSymbols = baseIndex === -1 ? snapshot.returnedSymbols.slice(0, top) : rows.map((row) => String(row[baseIndex]));
+  return { ...snapshot, symbolCount: rows.length, returnedSymbols, table: { ...snapshot.table, rows } };
+}
 var HeliosAgentMcpMarketService = class {
   constructor(options) {
     __publicField(this, "authService");
@@ -1480,7 +1526,7 @@ var HeliosAgentMcpMarketService = class {
     }
     const session = await this.authService.requireSession();
     try {
-      const snapshot = await this.dataBridgeClient.getMarketSnapshot(session.accessToken, input);
+      const snapshot = topOfSnapshot(await this.dataBridgeClient.getMarketSnapshot(session.accessToken, withSnapshotDefaults(input)), input);
       return {
         status: "connected",
         connected: true,
@@ -1492,7 +1538,7 @@ var HeliosAgentMcpMarketService = class {
         error,
         loginOptions,
         retry: async (accessToken) => {
-          const snapshot = await this.dataBridgeClient.getMarketSnapshot(accessToken, input);
+          const snapshot = topOfSnapshot(await this.dataBridgeClient.getMarketSnapshot(accessToken, withSnapshotDefaults(input)), input);
           return {
             status: "connected",
             connected: true,
@@ -1521,7 +1567,7 @@ var HeliosAgentMcpMarketService = class {
     }
     const session = await this.authService.requireSession();
     try {
-      const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(session.accessToken, input);
+      const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(session.accessToken, withSnapshotDefaults(input));
       return {
         status: "connected",
         connected: true,
@@ -1533,7 +1579,7 @@ var HeliosAgentMcpMarketService = class {
         error,
         loginOptions,
         retry: async (accessToken) => {
-          const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(accessToken, input);
+          const snapshotChunk = await this.dataBridgeClient.getMarketSnapshotChunk(accessToken, withSnapshotDefaults(input));
           return {
             status: "connected",
             connected: true,
@@ -2636,7 +2682,7 @@ function createHeliosMarketToolDefinitions(service) {
     {
       name: "helios_market_get_snapshot",
       title: "Get Helios Market Snapshot",
-      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols.",
+      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols. By default: the top 50 coins by market cap with the main columns; name symbols to get other coins, pass fields for other columns.",
       inputSchema: marketSnapshotInputSchema,
       async execute(input) {
         const result = marketSnapshotToolOutputSchema.parse(await service.getSnapshot(input));
@@ -2904,7 +2950,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.2"
+    version: "0.2.4"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({
@@ -3022,6 +3068,8 @@ function registerTool(server, tool) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_SNAPSHOT_FIELDS,
+  DEFAULT_SNAPSHOT_TOP,
   FileAgentSessionStore,
   HOSTED_RECONNECT_MESSAGE,
   HeliosAgentMcpAccountService,
@@ -3046,5 +3094,7 @@ function registerTool(server, tool) {
   pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh,
   toolAnnotations,
-  withDataText
+  topOfSnapshot,
+  withDataText,
+  withSnapshotDefaults
 });

package/dist/index.mjs

@@ -1,4 +1,6 @@
 import {
+  DEFAULT_SNAPSHOT_FIELDS,
+  DEFAULT_SNAPSHOT_TOP,
   FileAgentSessionStore,
   HOSTED_RECONNECT_MESSAGE,
   HeliosAgentMcpAccountService,
@@ -23,9 +25,13 @@ import {
   pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh,
   toolAnnotations,
-  withDataText
-} from "./chunk-XE6HRID3.mjs";
+  topOfSnapshot,
+  withDataText,
+  withSnapshotDefaults
+} from "./chunk-52XY4KRG.mjs";
 export {
+  DEFAULT_SNAPSHOT_FIELDS,
+  DEFAULT_SNAPSHOT_TOP,
   FileAgentSessionStore,
   HOSTED_RECONNECT_MESSAGE,
   HeliosAgentMcpAccountService,
@@ -50,5 +56,7 @@ export {
   pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh,
   toolAnnotations,
-  withDataText
+  topOfSnapshot,
+  withDataText,
+  withSnapshotDefaults
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgnio/helios-mcp",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Helios MCP server: connect an AI agent to your Helios account to read markets and your portfolio and to trade on Hyperliquid. Most apps can use the hosted URL https://helios.pgn.io/mcp instead.",
   "license": "UNLICENSED",
   "homepage": "https://helios.pgn.io/?connect=ai",