@continuumdao/ctm-mpc-defi 0.2.5 → 0.2.6

package/dist/agent/catalog.js

@@ -1,9 +1,10 @@
 import { getAddress, isAddress } from 'viem';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { z } from 'zod';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
 import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
 
 // src/core/registry.ts
 var modules = [];
@@ -876,6 +877,154 @@ var mcpEulerV2CollateralWithdrawInputSchema = mcpMultisignInput({
   collateralAsset: evmAddressSchema,
   amountHuman: z.string().min(1)
 });
+function mcpGmxMultisignInput(fields) {
+  return evmMultisignCommonInputSchema.extend(fields);
+}
+var gmxDirectionSchema = z.enum(["long", "short"]);
+var gmxOrderTypeSchema = z.enum(["market", "limit"]);
+var mcpGmxFetchMarketsInputSchema = z.object({
+  chainId: z.number().int().positive()
+});
+var mcpGmxFetchMarketsOutputSchema = z.object({
+  markets: z.array(
+    z.object({
+      symbol: z.string(),
+      marketTokenAddress: z.string(),
+      maxLeverageLabel: z.string().nullable()
+    })
+  )
+});
+var mcpGmxFetchPositionsInputSchema = z.object({
+  chainId: z.number().int().positive(),
+  executorAddress: evmAddressSchema
+});
+var mcpGmxFetchPositionsOutputSchema = z.object({
+  positions: z.array(z.record(z.unknown()))
+});
+var mcpGmxIncreaseInputSchema = mcpGmxMultisignInput({
+  symbol: z.string().min(1),
+  direction: gmxDirectionSchema,
+  orderType: gmxOrderTypeSchema,
+  sizeUsdHuman: z.string().min(1),
+  collateralToken: z.string().min(1),
+  collateralAmountHuman: z.string().min(1),
+  triggerPriceUsdHuman: z.string().optional(),
+  slippageBps: z.number().int().nonnegative().optional(),
+  executionFeeBufferBps: z.number().int().nonnegative().optional()
+});
+var mcpGmxDecreaseInputSchema = mcpGmxMultisignInput({
+  symbol: z.string().min(1),
+  direction: gmxDirectionSchema,
+  orderType: gmxOrderTypeSchema,
+  sizeUsdHuman: z.string().min(1),
+  collateralToken: z.string().min(1),
+  receiveToken: z.string().optional(),
+  triggerPriceUsdHuman: z.string().optional(),
+  keepLeverage: z.boolean().optional(),
+  slippageBps: z.number().int().nonnegative().optional(),
+  executionFeeBufferBps: z.number().int().nonnegative().optional()
+});
+var mcpGmxCancelInputSchema = mcpGmxMultisignInput({
+  orderId: z.string().min(1)
+});
+var mcpGmxGmDepositInputSchema = mcpGmxMultisignInput({
+  marketSymbol: z.string().min(1),
+  collateralToken: z.string().min(1),
+  collateralAmountHuman: z.string().min(1),
+  executionFeeBufferBps: z.number().int().nonnegative().optional(),
+  isNativeIn: z.boolean().optional(),
+  nativeWrapped: evmAddressSchema.optional()
+});
+var mcpGmxGmWithdrawInputSchema = mcpGmxMultisignInput({
+  marketSymbol: z.string().min(1),
+  gmAmountHuman: z.string().min(1),
+  gmDecimals: z.number().int().nonnegative().optional(),
+  executionFeeBufferBps: z.number().int().nonnegative().optional(),
+  isNativeOut: z.boolean().optional()
+});
+var mcpGmxStakeGmxInputSchema = mcpGmxMultisignInput({
+  amountHuman: z.string().min(1),
+  gmxDecimals: z.number().int().nonnegative().optional()
+});
+var mcpGmxUnstakeGmxInputSchema = mcpGmxMultisignInput({
+  amountHuman: z.string().min(1),
+  gmxDecimals: z.number().int().nonnegative().optional()
+});
+var mcpGmxFetchGmMarketsInputSchema = z.object({
+  chainId: z.number().int().positive()
+});
+var mcpGmxGmMarketApyRowSchema = z.object({
+  symbol: z.string(),
+  marketTokenAddress: z.string(),
+  longTokenSymbol: z.string().nullable(),
+  shortTokenSymbol: z.string().nullable(),
+  apy: z.number().nullable(),
+  baseApy: z.number().nullable(),
+  bonusApr: z.number().nullable(),
+  apyPercentLabel: z.string().nullable()
+});
+var mcpGmxFetchGmMarketsOutputSchema = z.object({
+  markets: z.array(mcpGmxGmMarketApyRowSchema)
+});
+var mcpGmxFetchGmApyInputSchema = z.object({
+  chainId: z.number().int().positive()
+});
+var mcpGmxFetchGmApyOutputSchema = z.object({
+  markets: z.array(
+    z.object({
+      symbol: z.string(),
+      marketTokenAddress: z.string(),
+      longTokenSymbol: z.string().nullable(),
+      shortTokenSymbol: z.string().nullable(),
+      apy: z.number().nullable(),
+      baseApy: z.number().nullable(),
+      bonusApr: z.number().nullable(),
+      apyPercentLabel: z.string().nullable()
+    })
+  )
+});
+var mcpGmxFetchStakingPowerInputSchema = z.object({
+  chainId: z.number().int().positive(),
+  executorAddress: evmAddressSchema
+});
+var mcpGmxFetchStakingPowerOutputSchema = z.object({
+  stakingPower: z.record(z.unknown())
+});
+var gmxOhlcvTimeframeSchema = z.enum(["1m", "5m", "15m", "1h", "4h", "1d", "1w", "1M"]);
+var gmxOhlcvCandleSchema = z.object({
+  timestampMs: z.number(),
+  timeLabel: z.string(),
+  open: z.string(),
+  high: z.string(),
+  low: z.string(),
+  close: z.string()
+});
+var mcpGmxFetchMarketPricesInputSchema = z.object({
+  chainId: z.number().int().positive(),
+  symbol: z.string().min(1),
+  collateralSymbol: z.string().min(1)
+});
+var mcpGmxFetchMarketPricesOutputSchema = z.object({
+  symbol: z.string(),
+  indexLabel: z.string(),
+  collateralSymbol: z.string(),
+  indexMarkUsd: z.string().nullable(),
+  collateralUsd: z.string().nullable(),
+  indexPerCollateral: z.string().nullable(),
+  fetchedAtMs: z.number()
+});
+var mcpGmxFetchOhlcvInputSchema = z.object({
+  chainId: z.number().int().positive(),
+  symbol: z.string().min(1),
+  timeframe: gmxOhlcvTimeframeSchema.optional(),
+  limit: z.number().int().positive().max(500).optional(),
+  sort: z.enum(["asc", "desc"]).optional()
+});
+var mcpGmxFetchOhlcvOutputSchema = z.object({
+  symbol: z.string(),
+  timeframe: gmxOhlcvTimeframeSchema,
+  candles: z.array(gmxOhlcvCandleSchema)
+});
 
 // src/agent/mcpProtocolTools.ts
 function defineProtocolMcpTool(def) {
@@ -1202,6 +1351,83 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowCollateralWithdrawBatch" },
     inputZod: mcpEulerV2CollateralWithdrawInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_increase_multisign",
+    actionId: "gmx.increase",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest for GMX classic increase order (open/add perp). Keeper executes asynchronously after on-chain broadcast.",
+    prerequisites: ["keyGen", "executorAddress", "GMX market symbol", "classic mode only \u2014 no subaccounts"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxIncreaseBatch" },
+    inputZod: mcpGmxIncreaseInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_decrease_multisign",
+    actionId: "gmx.decrease",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest for GMX classic decrease order (close/reduce perp).",
+    prerequisites: ["keyGen", "executorAddress", "position market symbol"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxDecreaseBatch" },
+    inputZod: mcpGmxDecreaseInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_cancel_multisign",
+    actionId: "gmx.cancel",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest to cancel a pending GMX order (classic on-chain).",
+    prerequisites: ["keyGen", "executorAddress", "orderId from fetchOrders"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxCancelBatch" },
+    inputZod: mcpGmxCancelInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_gm_deposit_multisign",
+    actionId: "gmx.gmDeposit",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest for GMX GM pool deposit (ExchangeRouter multicall). Keeper executes asynchronously.",
+    prerequisites: ["keyGen", "executorAddress", "marketSymbol", "collateral token"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxGmDepositBatch" },
+    inputZod: mcpGmxGmDepositInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_gm_withdraw_multisign",
+    actionId: "gmx.gmWithdraw",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest for GMX GM pool withdrawal (ExchangeRouter multicall). Keeper executes asynchronously.",
+    prerequisites: ["keyGen", "executorAddress", "GM market token balance"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxGmWithdrawBatch" },
+    inputZod: mcpGmxGmWithdrawInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_stake_gmx_multisign",
+    actionId: "gmx.stakeGmx",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest to stake GMX via RewardRouter.",
+    prerequisites: ["keyGen", "executorAddress", "GMX token balance"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxStakeGmxBatch" },
+    inputZod: mcpGmxStakeGmxInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_gmx_build_unstake_gmx_multisign",
+    actionId: "gmx.unstakeGmx",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest to unstake GMX via RewardRouter.",
+    prerequisites: ["keyGen", "executorAddress", "staked GMX balance"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "buildEvmMultisignBodyGmxUnstakeGmxBatch" },
+    inputZod: mcpGmxUnstakeGmxInputSchema
   })
 ];
 
@@ -1466,6 +1692,90 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     handler: { importPath: "protocols/evm/curve-dao", exportName: "buildEvmMultisignBodyCurveDaoBatch" },
     inputZod: mcpCurveDaoBuildSwapMultisignInputSchema,
     outputZod: multisignOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_markets",
+    actionId: "gmx.fetch-markets",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "List GMX V2 perp markets for a chain (symbol, market token, maxLeverageLabel). Read-only; uses GMX HTTP API.",
+    prerequisites: ["chainId"],
+    followUp: ["ctm_gmx_build_increase_multisign", "ctm_gmx_build_decrease_multisign"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchMarketsSummary" },
+    inputZod: mcpGmxFetchMarketsInputSchema,
+    outputZod: mcpGmxFetchMarketsOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_positions",
+    actionId: "gmx.fetch-positions",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Fetch open GMX perp positions for an executor address. Read-only.",
+    prerequisites: ["chainId", "executorAddress (MPC ethereumaddress)"],
+    followUp: ["ctm_gmx_build_decrease_multisign"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchPositionsForExecutor" },
+    inputZod: mcpGmxFetchPositionsInputSchema,
+    outputZod: mcpGmxFetchPositionsOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_market_prices",
+    actionId: "gmx.fetch-market-prices",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Latest GMX index mark and collateral USD prices for a perp market. Read-only via GMX HTTP API.",
+    prerequisites: ["chainId", "symbol from ctm_gmx_fetch_markets", "collateralSymbol e.g. USDC"],
+    followUp: ["ctm_gmx_fetch_ohlcv", "ctm_gmx_build_increase_multisign"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchMarketPrices" },
+    inputZod: mcpGmxFetchMarketPricesInputSchema,
+    outputZod: mcpGmxFetchMarketPricesOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_ohlcv",
+    actionId: "gmx.fetch-ohlcv",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "OHLCV candle table for a GMX perp index (USD). Default timeframe 15m. Read-only via GMX HTTP API.",
+    prerequisites: ["chainId", "symbol from ctm_gmx_fetch_markets"],
+    followUp: ["ctm_gmx_fetch_market_prices"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchOhlcv" },
+    inputZod: mcpGmxFetchOhlcvInputSchema,
+    outputZod: mcpGmxFetchOhlcvOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_gm_markets",
+    actionId: "gmx.fetch-gm-markets",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "List GMX GM liquidity pool markets with long/short collateral symbols and estimated APY. Read-only.",
+    prerequisites: ["chainId"],
+    followUp: ["ctm_gmx_build_gm_deposit_multisign", "ctm_gmx_build_gm_withdraw_multisign"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchGmMarkets" },
+    inputZod: mcpGmxFetchGmMarketsInputSchema,
+    outputZod: mcpGmxFetchGmMarketsOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_gm_apy",
+    actionId: "gmx.fetch-gm-apy",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Fetch estimated GM liquidity pool APY for each GMX market (sorted highest first). Read-only.",
+    prerequisites: ["chainId"],
+    followUp: ["ctm_gmx_build_gm_deposit_multisign", "ctm_gmx_fetch_gm_markets"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchGmApy" },
+    inputZod: mcpGmxFetchGmApyInputSchema,
+    outputZod: mcpGmxFetchGmApyOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_gmx_fetch_staking_power",
+    actionId: "gmx.fetch-staking-power",
+    protocolId: "gmx",
+    chainCategory: "evm",
+    description: "Fetch GMX token staking power for an executor address. Read-only.",
+    prerequisites: ["chainId", "executorAddress"],
+    followUp: ["ctm_gmx_build_stake_gmx_multisign", "ctm_gmx_build_unstake_gmx_multisign"],
+    handler: { importPath: "protocols/evm/gmx", exportName: "gmxFetchStakingPower" },
+    inputZod: mcpGmxFetchStakingPowerInputSchema,
+    outputZod: mcpGmxFetchStakingPowerOutputSchema
   })
 ];
 var MCP_TOOL_DEFINITIONS = [
@@ -1857,6 +2167,231 @@ var eulerV2ProtocolModule = {
   ]
 };
 registerProtocolModule(eulerV2ProtocolModule);
+
+// src/protocols/evm/gmx/support.ts
+var GMX_SUPPORTED_CHAIN_IDS = [42161, 43114];
+function isGmxChainSupported(chainId) {
+  return GMX_SUPPORTED_CHAIN_IDS.includes(chainId);
+}
+var require2 = createRequire(fileURLToPath(import.meta.url));
+var { GmxApiSdk } = require2("@gmx-io/sdk/v2");
+var GMX_HTTP_TIMEOUT_MS = 3e4;
+var GMX_API_BASE_URLS = {
+  42161: ["https://arbitrum.gmxapi.io/v1", "https://arbitrum.gmxapi.ai/v1"],
+  43114: ["https://avalanche.gmxapi.io/v1", "https://avalanche.gmxapi.ai/v1"]
+};
+function buildGmxUrl(baseUrl, path, query) {
+  const base = baseUrl.replace(/\/$/, "");
+  if (!query) return `${base}${path}`;
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0 && value !== null) params.set(key, String(value));
+  }
+  const qs = params.toString();
+  return qs ? `${base}${path}?${qs}` : `${base}${path}`;
+}
+function bigintReplacer(_key, value) {
+  return typeof value === "bigint" ? value.toString() : value;
+}
+async function gmxHttpFetchJson(baseUrl, path, opts) {
+  const url = buildGmxUrl(baseUrl, path, opts?.query);
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), GMX_HTTP_TIMEOUT_MS);
+  try {
+    const response = await fetch(url, {
+      headers: { Accept: "application/json" },
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      let message = `HTTP ${response.status}: ${response.statusText}`;
+      try {
+        const body = await response.json();
+        if (body?.message) message = `HTTP ${response.status}: ${body.message}`;
+      } catch {
+      }
+      throw new Error(`${message} (${url})`);
+    }
+    const json = await response.json();
+    return opts?.transform ? opts.transform(json) : json;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+async function gmxHttpPostJson(baseUrl, path, body, opts) {
+  const url = buildGmxUrl(baseUrl, path);
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), GMX_HTTP_TIMEOUT_MS);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Accept: "application/json" },
+      body: JSON.stringify(body, bigintReplacer),
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      let message = `HTTP ${response.status}: ${response.statusText}`;
+      try {
+        const errBody = await response.json();
+        if (errBody?.message) message = `HTTP ${response.status}: ${errBody.message}`;
+      } catch {
+      }
+      throw new Error(`${message} (${url})`);
+    }
+    const json = await response.json();
+    return opts?.transform ? opts.transform(json) : json;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+function createIoFirstGmxHttpApi(chainId) {
+  const urls = GMX_API_BASE_URLS[chainId];
+  if (!urls) {
+    throw new Error(`GMX API URLs are not configured for chain ${chainId}.`);
+  }
+  async function withIoFirstFallback(fn) {
+    let lastError;
+    for (const baseUrl of urls) {
+      try {
+        return await fn(baseUrl);
+      } catch (e) {
+        lastError = e;
+      }
+    }
+    const detail = lastError instanceof Error ? lastError.message : String(lastError);
+    throw new Error(
+      `GMX API request failed on all endpoints (${urls.join(", ")}). Last error: ${detail}`
+    );
+  }
+  return {
+    fetchJson: (path, opts) => withIoFirstFallback((baseUrl) => gmxHttpFetchJson(baseUrl, path, opts)),
+    postJson: (path, body, opts) => withIoFirstFallback((baseUrl) => gmxHttpPostJson(baseUrl, path, body, opts))
+  };
+}
+var sdkByChain = /* @__PURE__ */ new Map();
+function getGmxApiSdk(chainId) {
+  if (!isGmxChainSupported(chainId)) {
+    throw new Error(`GMX is not supported on chain ${chainId}. Supported: 42161 (Arbitrum), 43114 (Avalanche).`);
+  }
+  let sdk = sdkByChain.get(chainId);
+  if (!sdk) {
+    sdk = new GmxApiSdk({ chainId, api: createIoFirstGmxHttpApi(chainId) });
+    sdkByChain.set(chainId, sdk);
+  }
+  return sdk;
+}
+async function gmxFetchTokens(chainId) {
+  const sdk = getGmxApiSdk(chainId);
+  return sdk.fetchTokens();
+}
+async function gmxFetchCollateralTokens(args) {
+  const tokens = await gmxFetchTokens(args.chainId);
+  return tokens.map((t) => ({
+    symbol: t.symbol,
+    address: t.address,
+    decimals: t.decimals
+  }));
+}
+
+// src/protocols/evm/gmx/index.ts
+var GMX_PROTOCOL_ID = "gmx";
+var gmxProtocolModule = {
+  id: GMX_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    const chainId = typeof ctx.chainId === "number" ? ctx.chainId : Number(ctx.chainId);
+    return Number.isFinite(chainId) && isGmxChainSupported(chainId);
+  },
+  isTokenSupported(token) {
+    if (token.category !== "evm") return false;
+    return token.kind === "erc20";
+  },
+  actions: [
+    {
+      id: "gmx.increase",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Open or add to a GMX perp position (classic on-chain order)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        symbol: { type: "string", required: true, description: "GMX market symbol e.g. ETH/USD [WETH-USDC]" },
+        direction: { type: "string", required: true, description: "long or short" },
+        orderType: { type: "string", required: true, description: "market or limit" },
+        sizeUsdHuman: { type: "string", required: true, description: "Position size in USD" },
+        collateralToken: { type: "string", required: true, description: "Collateral token symbol e.g. USDC" },
+        collateralAmountHuman: { type: "string", required: true, description: "Collateral amount in token units" }
+      }
+    },
+    {
+      id: "gmx.decrease",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Close or reduce a GMX perp position (classic on-chain order)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        symbol: { type: "string", required: true, description: "GMX market symbol" },
+        direction: { type: "string", required: true, description: "long or short" },
+        orderType: { type: "string", required: true, description: "market or limit" },
+        sizeUsdHuman: { type: "string", required: true, description: "Size to close in USD" },
+        collateralToken: { type: "string", required: true, description: "Position collateral token symbol" }
+      }
+    },
+    {
+      id: "gmx.cancel",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Cancel a pending GMX order (classic on-chain)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        orderId: { type: "string", required: true, description: "Order key from fetchOrders" }
+      }
+    },
+    {
+      id: "gmx.gmDeposit",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Deposit collateral into a GMX GM liquidity pool (ExchangeRouter multicall)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        marketSymbol: { type: "string", required: true, description: "GM market symbol e.g. ETH/USD [WETH-USDC]" },
+        collateralToken: { type: "string", required: true, description: "Pool collateral token symbol" },
+        collateralAmountHuman: { type: "string", required: true, description: "Amount in token units" }
+      }
+    },
+    {
+      id: "gmx.gmWithdraw",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Withdraw GM market tokens from a GMX liquidity pool",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        marketSymbol: { type: "string", required: true, description: "GM market symbol" },
+        gmAmountHuman: { type: "string", required: true, description: "GM token amount to withdraw" }
+      }
+    },
+    {
+      id: "gmx.stakeGmx",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Stake GMX tokens via RewardRouter",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        amountHuman: { type: "string", required: true, description: "GMX amount to stake" }
+      }
+    },
+    {
+      id: "gmx.unstakeGmx",
+      protocolId: GMX_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Unstake GMX tokens via RewardRouter",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        amountHuman: { type: "string", required: true, description: "GMX amount to unstake" }
+      }
+    }
+  ]
+};
+registerProtocolModule(gmxProtocolModule);
 var skillsDir = join(dirname(fileURLToPath(import.meta.url)), "skills");
 var SKILL_PROTOCOL_IDS = [
   "aave-v4",
@@ -1866,7 +2401,8 @@ var SKILL_PROTOCOL_IDS = [
   "ethena",
   "euler-v2",
   "maple-syrup",
-  "sky"
+  "sky",
+  "gmx"
 ];
 function getToolsForProtocol(protocolId) {
   return MCP_TOOL_DEFINITIONS.filter((t) => t.protocolId === protocolId);
@@ -2098,6 +2634,35 @@ var PROTOCOL_SUPPORT_ADVISORS = {
         notes: "Sky Lockstake and sUSDS use fixed mainnet contract addresses in protocol builders."
       };
     }
+  }),
+  [GMX_PROTOCOL_ID]: advisor(GMX_PROTOCOL_ID, "api_underlyings", {
+    async supportedChainIds() {
+      return [42161, 43114];
+    },
+    async supportedTokens(chainId) {
+      if (!isGmxChainSupported(chainId)) {
+        return { tokens: [], notes: "GMX v1 supports Arbitrum (42161) and Avalanche (43114)." };
+      }
+      const tokens = await gmxFetchCollateralTokens({ chainId });
+      return {
+        tokens: tokens.map((t) => ({
+          address: t.address,
+          symbol: t.symbol,
+          roles: ["collateral"]
+        })),
+        notes: "Collateral ERC-20 tokens from GMX API. Perp markets listed via fetch_markets."
+      };
+    },
+    async isTokenSupported(chainId, address) {
+      if (!isGmxChainSupported(chainId)) return false;
+      const tokens = await gmxFetchCollateralTokens({ chainId });
+      try {
+        const normalized = getAddress(address).toLowerCase();
+        return tokens.some((t) => t.address.toLowerCase() === normalized);
+      } catch {
+        return false;
+      }
+    }
   })
 };
 function getProtocolSupportAdvisor(protocolId) {
@@ -2132,6 +2697,7 @@ registerProtocolModule(mapleProtocolModule);
 registerProtocolModule(skyProtocolModule);
 registerProtocolModule(aaveV4ProtocolModule);
 registerProtocolModule(eulerV2ProtocolModule);
+registerProtocolModule(gmxProtocolModule);
 function getAgentCatalog() {
   return {
     protocols: getProtocolModules(),
@@ -2148,11 +2714,12 @@ function getAgentCatalog() {
     sky: skyProtocolModule,
     aaveV4: aaveV4ProtocolModule,
     eulerV2: eulerV2ProtocolModule,
+    gmx: gmxProtocolModule,
     /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
     mcp: getAgentCatalogForMcp()
   };
 }
 
-export { EVM_COMMON_PARAM_DOCS, MANAGEMENT_SIG_DOC, MCP_NON_SUBMIT_TOOL_NAMES, MCP_TOOL_DEFINITIONS, MCP_TOOL_INPUT_SCHEMAS, MCP_TOOL_OUTPUT_SCHEMAS, MULTISIGN_OUTPUT_DOC, PROTOCOL_SUPPORT_ADVISORS, chainDetailSchema, evmAddressSchema, evmMultisignCommonInputSchema, getActionsByChainCategory, getAgentCatalog, getAgentCatalogForMcp, getMcpToolByName, getMcpToolDefinitions, getMcpToolInputSchema, getMcpToolOutputSchema, getProtocolDiscoverySummary, getProtocolModules, getProtocolSkill, getProtocolSupportAdvisor, getToolsForProtocol, jsonObjectSchema, keyGenSchema, listProtocolSupportAdvisorIds, listProtocolsWithSkills, mcpAaveV4BorrowInputSchema, mcpAaveV4DepositInputSchema, mcpAaveV4RepayInputSchema, mcpAaveV4WithdrawInputSchema, mcpCurveDaoBuildSwapMultisignInputSchema, mcpCurveDaoQuoteInputSchema, mcpCurveDaoQuoteOutputSchema, mcpEthenaClaimInputSchema, mcpEthenaCooldownInputSchema, mcpEthenaRedeemInputSchema, mcpEthenaStakeInputSchema, mcpEulerV2BorrowRepayInputSchema, mcpEulerV2CollateralDepositInputSchema, mcpEulerV2CollateralWithdrawInputSchema, mcpEulerV2IsolatedBorrowInputSchema, mcpEulerV2IsolatedLendInputSchema, mcpEulerV2VaultWithdrawInputSchema, mcpLidoClaimWithdrawalInputSchema, mcpLidoRequestWithdrawalsInputSchema, mcpLidoSubmitInputSchema, mcpLidoUnwrapWstEthInputSchema, mcpLidoWrapStEthInputSchema, mcpMapleDepositInputSchema, mcpMapleRequestRedeemInputSchema, mcpMultisignInput, multisignOutputSchema as mcpMultisignOutputSchema, mcpServerCommonInputSchema, mcpServerMultisignInput, mcpServerSubmitOutputSchema, mcpSkyLockstakeCloseInputSchema, mcpSkyLockstakeDrawInputSchema, mcpSkyLockstakeGetRewardInputSchema, mcpSkyLockstakeStakeInputSchema, mcpSkyLockstakeWipeInputSchema, mcpSkySusdsDepositInputSchema, mcpSkySusdsRedeemInputSchema, mcpUniswapV4BuildCollectFeesMultisignInputSchema, mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema, mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema, mcpUniswapV4BuildMintLiquidityMultisignInputSchema, mcpUniswapV4BuildSwapMultisignInputSchema, mcpUniswapV4CreateSwapInputSchema, mcpUniswapV4CreateSwapOutputSchema, mcpUniswapV4LpClaimInputSchema, mcpUniswapV4LpClaimOutputSchema, mcpUniswapV4LpCreatePositionInputSchema, mcpUniswapV4LpCreatePositionOutputSchema, mcpUniswapV4LpDecreaseInputSchema, mcpUniswapV4LpDecreaseOutputSchema, mcpUniswapV4LpIncreaseInputSchema, mcpUniswapV4LpIncreaseOutputSchema, mcpUniswapV4LpListPoolsInputSchema, mcpUniswapV4LpListPoolsOutputSchema, mcpUniswapV4LpListPositionsInputSchema, mcpUniswapV4LpListPositionsOutputSchema, mcpUniswapV4QuoteInputSchema, mcpUniswapV4QuoteOutputSchema, mcpUniswapV4RegisterPositionFromMintTxInputSchema, mcpUniswapV4RegisterPositionFromMintTxOutputSchema, mcpUniswapV4RegisterPositionNftInputSchema, mcpUniswapV4RegisterPositionNftOutputSchema, multisignOutputSchema, parseMcpToolInput, parseMcpToolOutput, uniswapQuoteTradeTypeSchema, zodSchemaToMcpJsonSchema };
+export { EVM_COMMON_PARAM_DOCS, MANAGEMENT_SIG_DOC, MCP_NON_SUBMIT_TOOL_NAMES, MCP_TOOL_DEFINITIONS, MCP_TOOL_INPUT_SCHEMAS, MCP_TOOL_OUTPUT_SCHEMAS, MULTISIGN_OUTPUT_DOC, PROTOCOL_SUPPORT_ADVISORS, chainDetailSchema, evmAddressSchema, evmMultisignCommonInputSchema, getActionsByChainCategory, getAgentCatalog, getAgentCatalogForMcp, getMcpToolByName, getMcpToolDefinitions, getMcpToolInputSchema, getMcpToolOutputSchema, getProtocolDiscoverySummary, getProtocolModules, getProtocolSkill, getProtocolSupportAdvisor, getToolsForProtocol, jsonObjectSchema, keyGenSchema, listProtocolSupportAdvisorIds, listProtocolsWithSkills, mcpAaveV4BorrowInputSchema, mcpAaveV4DepositInputSchema, mcpAaveV4RepayInputSchema, mcpAaveV4WithdrawInputSchema, mcpCurveDaoBuildSwapMultisignInputSchema, mcpCurveDaoQuoteInputSchema, mcpCurveDaoQuoteOutputSchema, mcpEthenaClaimInputSchema, mcpEthenaCooldownInputSchema, mcpEthenaRedeemInputSchema, mcpEthenaStakeInputSchema, mcpEulerV2BorrowRepayInputSchema, mcpEulerV2CollateralDepositInputSchema, mcpEulerV2CollateralWithdrawInputSchema, mcpEulerV2IsolatedBorrowInputSchema, mcpEulerV2IsolatedLendInputSchema, mcpEulerV2VaultWithdrawInputSchema, mcpGmxCancelInputSchema, mcpGmxDecreaseInputSchema, mcpGmxFetchGmApyInputSchema, mcpGmxFetchGmApyOutputSchema, mcpGmxFetchGmMarketsInputSchema, mcpGmxFetchGmMarketsOutputSchema, mcpGmxFetchMarketPricesInputSchema, mcpGmxFetchMarketPricesOutputSchema, mcpGmxFetchMarketsInputSchema, mcpGmxFetchMarketsOutputSchema, mcpGmxFetchOhlcvInputSchema, mcpGmxFetchOhlcvOutputSchema, mcpGmxFetchPositionsInputSchema, mcpGmxFetchPositionsOutputSchema, mcpGmxFetchStakingPowerInputSchema, mcpGmxFetchStakingPowerOutputSchema, mcpGmxGmDepositInputSchema, mcpGmxGmWithdrawInputSchema, mcpGmxIncreaseInputSchema, multisignOutputSchema as mcpGmxMultisignOutputSchema, mcpGmxStakeGmxInputSchema, mcpGmxUnstakeGmxInputSchema, mcpLidoClaimWithdrawalInputSchema, mcpLidoRequestWithdrawalsInputSchema, mcpLidoSubmitInputSchema, mcpLidoUnwrapWstEthInputSchema, mcpLidoWrapStEthInputSchema, mcpMapleDepositInputSchema, mcpMapleRequestRedeemInputSchema, mcpMultisignInput, multisignOutputSchema as mcpMultisignOutputSchema, mcpServerCommonInputSchema, mcpServerMultisignInput, mcpServerSubmitOutputSchema, mcpSkyLockstakeCloseInputSchema, mcpSkyLockstakeDrawInputSchema, mcpSkyLockstakeGetRewardInputSchema, mcpSkyLockstakeStakeInputSchema, mcpSkyLockstakeWipeInputSchema, mcpSkySusdsDepositInputSchema, mcpSkySusdsRedeemInputSchema, mcpUniswapV4BuildCollectFeesMultisignInputSchema, mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema, mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema, mcpUniswapV4BuildMintLiquidityMultisignInputSchema, mcpUniswapV4BuildSwapMultisignInputSchema, mcpUniswapV4CreateSwapInputSchema, mcpUniswapV4CreateSwapOutputSchema, mcpUniswapV4LpClaimInputSchema, mcpUniswapV4LpClaimOutputSchema, mcpUniswapV4LpCreatePositionInputSchema, mcpUniswapV4LpCreatePositionOutputSchema, mcpUniswapV4LpDecreaseInputSchema, mcpUniswapV4LpDecreaseOutputSchema, mcpUniswapV4LpIncreaseInputSchema, mcpUniswapV4LpIncreaseOutputSchema, mcpUniswapV4LpListPoolsInputSchema, mcpUniswapV4LpListPoolsOutputSchema, mcpUniswapV4LpListPositionsInputSchema, mcpUniswapV4LpListPositionsOutputSchema, mcpUniswapV4QuoteInputSchema, mcpUniswapV4QuoteOutputSchema, mcpUniswapV4RegisterPositionFromMintTxInputSchema, mcpUniswapV4RegisterPositionFromMintTxOutputSchema, mcpUniswapV4RegisterPositionNftInputSchema, mcpUniswapV4RegisterPositionNftOutputSchema, multisignOutputSchema, parseMcpToolInput, parseMcpToolOutput, uniswapQuoteTradeTypeSchema, zodSchemaToMcpJsonSchema };
 //# sourceMappingURL=catalog.js.map
 //# sourceMappingURL=catalog.js.map