@pmxt/mcp 2.30.2 → 2.30.5

package/dist/generated/tools.js

@@ -1,5 +1,5 @@
 // AUTO-GENERATED by mcp/scripts/generate-tools.js -- DO NOT EDIT
-// Generated from core/src/server/openapi.yaml (2026-04-11)
+// Generated from core/src/server/openapi.yaml (2026-04-13)
 export const TOOLS = [
     {
         "name": "buildOrder",
@@ -94,6 +94,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -171,6 +175,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -284,6 +292,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -379,6 +391,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -394,7 +410,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -450,6 +466,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -540,6 +560,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -555,7 +579,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -629,6 +653,10 @@ export const TOOLS = [
                 "slug": {
                     "type": "string",
                     "description": "Lookup by event slug"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -644,7 +672,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -718,6 +746,10 @@ export const TOOLS = [
                 "slug": {
                     "type": "string",
                     "description": "Lookup by event slug"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -733,7 +765,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -823,6 +855,10 @@ export const TOOLS = [
                 "similarityThreshold": {
                     "type": "number",
                     "description": "For semantic search (used by Limitless)"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -838,7 +874,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -928,6 +964,10 @@ export const TOOLS = [
                 "similarityThreshold": {
                     "type": "number",
                     "description": "For semantic search (used by Limitless)"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -943,7 +983,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -975,6 +1015,10 @@ export const TOOLS = [
                 },
                 "cursor": {
                     "type": "string"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -990,7 +1034,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -1069,6 +1113,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1084,7 +1132,7 @@ export const TOOLS = [
                 "name": "params",
                 "kind": "object",
                 "optional": true,
-                "flatten": false
+                "flatten": true
             }
         ]
     },
@@ -1139,6 +1187,10 @@ export const TOOLS = [
                 "limit": {
                     "type": "number",
                     "description": "Maximum number of results to return"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1217,6 +1269,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1288,6 +1344,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1333,6 +1393,10 @@ export const TOOLS = [
                 },
                 "id": {
                     "type": "string"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1405,6 +1469,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1463,6 +1531,10 @@ export const TOOLS = [
                 "limit": {
                     "type": "number",
                     "description": "Maximum number of results to return"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1555,6 +1627,10 @@ export const TOOLS = [
                 },
                 "amount": {
                     "type": "number"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1656,6 +1732,10 @@ export const TOOLS = [
                 },
                 "amount": {
                     "type": "number"
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1743,6 +1823,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [
@@ -1867,6 +1951,10 @@ export const TOOLS = [
                             "type": "string"
                         }
                     }
+                },
+                "verbose": {
+                    "type": "boolean",
+                    "description": "Return full uncompacted response. Default false returns a compact, agent-friendly summary."
                 }
             },
             "required": [

package/dist/server.js

@@ -9,6 +9,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 import { TOOLS } from "./generated/tools.js";
 import { callPmxtApi } from "./client.js";
 import { reconstructArgs } from "./args.js";
+import { compactResult } from "./shaper.js";
 const INSTRUCTIONS = `PMXT is a unified API for prediction markets (Polymarket, Kalshi, Limitless, and more). \
 Same methods, same response shape, regardless of venue.
 
@@ -74,7 +75,8 @@ export function createServer(config) {
         }
         // Separate credentials from the rest of the input
         const credentials = input.credentials;
-        const { exchange: _ex, credentials: _cred, ...rest } = input;
+        const { exchange: _ex, credentials: _cred, verbose: _verbose, ...rest } = input;
+        const verbose = input.verbose === true;
         const args = reconstructArgs(rest, def.args);
         try {
             const result = await callPmxtApi(config, {
@@ -83,9 +85,10 @@ export function createServer(config) {
                 args,
                 credentials,
             });
+            const shaped = compactResult(def.method, result, verbose);
             return {
                 content: [
-                    { type: "text", text: JSON.stringify(result, null, 2) },
+                    { type: "text", text: JSON.stringify(shaped, null, 2) },
                 ],
             };
         }

package/dist/shaper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compacts MCP tool responses for agent consumption.
+ * When verbose=false (default), strips fields that bloat context windows
+ * without adding decision-relevant information.
+ */
+export declare function compactResult(toolName: string, data: unknown, verbose: boolean): unknown;

package/dist/shaper.js

@@ -0,0 +1,179 @@
+/**
+ * Compacts MCP tool responses for agent consumption.
+ * When verbose=false (default), strips fields that bloat context windows
+ * without adding decision-relevant information.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function truncate(s, maxLen) {
+    if (typeof s !== "string")
+        return "";
+    if (s.length <= maxLen)
+        return s;
+    return s.slice(0, maxLen) + "...";
+}
+// Flatten outcomes into compact {marketId, outcomes: [{label, price}]}
+function compactMarket(m) {
+    const src = m;
+    const outcomes = Array.isArray(src.outcomes)
+        ? src.outcomes.map((o) => ({
+            label: o.label,
+            price: o.price,
+        }))
+        : [];
+    return {
+        marketId: src.marketId,
+        title: src.title,
+        outcomes,
+        ...(src.volume24h != null && { volume24h: src.volume24h }),
+        ...(src.liquidity != null && { liquidity: src.liquidity }),
+        ...(src.status != null && src.status !== "active" && { status: src.status }),
+    };
+}
+// Standalone market (fetchMarket) -- slightly more detail since agent asked for one specific market
+function compactSingleMarket(m) {
+    const src = m;
+    const outcomes = Array.isArray(src.outcomes)
+        ? src.outcomes.map((o) => ({
+            outcomeId: o.outcomeId,
+            label: o.label,
+            price: o.price,
+        }))
+        : [];
+    return {
+        marketId: src.marketId,
+        eventId: src.eventId,
+        title: src.title,
+        description: truncate(src.description, 200),
+        outcomes,
+        ...(src.resolutionDate != null && { resolutionDate: src.resolutionDate }),
+        ...(src.volume24h != null && { volume24h: src.volume24h }),
+        ...(src.liquidity != null && { liquidity: src.liquidity }),
+        ...(src.openInterest != null && { openInterest: src.openInterest }),
+        ...(src.status != null && { status: src.status }),
+        ...(src.tickSize != null && { tickSize: src.tickSize }),
+    };
+}
+const NESTED_MARKETS_LIMIT = 5;
+function compactEvent(e) {
+    const src = e;
+    const allMarkets = Array.isArray(src.markets)
+        ? src.markets.map(compactMarket)
+        : [];
+    const markets = allMarkets.length > NESTED_MARKETS_LIMIT
+        ? allMarkets.slice(0, NESTED_MARKETS_LIMIT)
+        : allMarkets;
+    return {
+        id: src.id,
+        title: src.title,
+        description: truncate(src.description, 200),
+        markets,
+        ...(allMarkets.length > NESTED_MARKETS_LIMIT && {
+            _totalMarkets: allMarkets.length,
+        }),
+        ...(src.volume24h != null && { volume24h: src.volume24h }),
+    };
+}
+function compactBuildOrder(data) {
+    const src = data;
+    const { raw: _raw, signedOrder: _signed, ...rest } = src;
+    return rest;
+}
+const ORDER_BOOK_DEPTH = 10;
+function compactOrderBook(data) {
+    const src = data;
+    const bids = Array.isArray(src.bids) ? src.bids.slice(0, ORDER_BOOK_DEPTH) : [];
+    const asks = Array.isArray(src.asks) ? src.asks.slice(0, ORDER_BOOK_DEPTH) : [];
+    return {
+        bids,
+        asks,
+        ...(Array.isArray(src.bids) && src.bids.length > ORDER_BOOK_DEPTH && {
+            _totalBids: src.bids.length,
+        }),
+        ...(Array.isArray(src.asks) && src.asks.length > ORDER_BOOK_DEPTH && {
+            _totalAsks: src.asks.length,
+        }),
+    };
+}
+const TRADES_LIMIT = 20;
+function compactTrades(data) {
+    if (!Array.isArray(data))
+        return data;
+    const trades = data.slice(0, TRADES_LIMIT).map((t) => {
+        const src = t;
+        return {
+            price: src.price,
+            amount: src.amount,
+            side: src.side,
+            timestamp: src.timestamp,
+        };
+    });
+    return trades;
+}
+const OHLCV_LIMIT = 50;
+function compactOHLCV(data) {
+    if (!Array.isArray(data))
+        return data;
+    return data.slice(0, OHLCV_LIMIT);
+}
+function compactOrder(o) {
+    const src = o;
+    return {
+        id: src.id,
+        marketId: src.marketId,
+        outcomeId: src.outcomeId,
+        side: src.side,
+        price: src.price,
+        amount: src.amount,
+        filled: src.filled,
+        remaining: src.remaining,
+        status: src.status,
+    };
+}
+function compactOrders(data) {
+    if (!Array.isArray(data))
+        return data;
+    return data.map(compactOrder);
+}
+// ---------------------------------------------------------------------------
+// Per-tool dispatch
+// ---------------------------------------------------------------------------
+const COMPACTORS = {
+    fetchEvents: (data) => Array.isArray(data) ? data.map(compactEvent) : data,
+    fetchEvent: (data) => compactEvent(data),
+    fetchMarkets: (data) => Array.isArray(data) ? data.map(compactSingleMarket) : data,
+    fetchMarket: (data) => compactSingleMarket(data),
+    fetchMarketsPaginated: (data) => {
+        const src = data;
+        return {
+            data: Array.isArray(src.data)
+                ? src.data.map(compactSingleMarket)
+                : src.data,
+            total: src.total,
+            nextCursor: src.nextCursor,
+        };
+    },
+    buildOrder: (data) => compactBuildOrder(data),
+    fetchOrderBook: (data) => compactOrderBook(data),
+    fetchTrades: (data) => compactTrades(data),
+    fetchMyTrades: (data) => compactTrades(data),
+    fetchOHLCV: (data) => compactOHLCV(data),
+    fetchOrder: (data) => compactOrder(data),
+    fetchOpenOrders: (data) => compactOrders(data),
+    fetchClosedOrders: (data) => compactOrders(data),
+    fetchAllOrders: (data) => compactOrders(data),
+    createOrder: (data) => compactOrder(data),
+    cancelOrder: (data) => compactOrder(data),
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function compactResult(toolName, data, verbose) {
+    if (verbose)
+        return data;
+    const compactor = COMPACTORS[toolName];
+    if (!compactor)
+        return data;
+    return compactor(data);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmxt/mcp",
-  "version": "2.30.2",
+  "version": "2.30.5",
   "description": "MCP server for PMXT - the unified prediction market API",
   "type": "module",
   "bin": {