@continuumdao/ctm-mpc-defi 0.2.5 → 0.2.6

package/dist/agent/catalog.cjs

@@ -3,9 +3,10 @@
 var viem = require('viem');
 var zodToJsonSchema = require('zod-to-json-schema');
 var zod = require('zod');
+var module$1 = require('module');
+var url = require('url');
 var fs = require('fs');
 var path = require('path');
-var url = require('url');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // src/core/registry.ts
@@ -879,6 +880,154 @@ var mcpEulerV2CollateralWithdrawInputSchema = mcpMultisignInput({
   collateralAsset: evmAddressSchema,
   amountHuman: zod.z.string().min(1)
 });
+function mcpGmxMultisignInput(fields) {
+  return evmMultisignCommonInputSchema.extend(fields);
+}
+var gmxDirectionSchema = zod.z.enum(["long", "short"]);
+var gmxOrderTypeSchema = zod.z.enum(["market", "limit"]);
+var mcpGmxFetchMarketsInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive()
+});
+var mcpGmxFetchMarketsOutputSchema = zod.z.object({
+  markets: zod.z.array(
+    zod.z.object({
+      symbol: zod.z.string(),
+      marketTokenAddress: zod.z.string(),
+      maxLeverageLabel: zod.z.string().nullable()
+    })
+  )
+});
+var mcpGmxFetchPositionsInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive(),
+  executorAddress: evmAddressSchema
+});
+var mcpGmxFetchPositionsOutputSchema = zod.z.object({
+  positions: zod.z.array(zod.z.record(zod.z.unknown()))
+});
+var mcpGmxIncreaseInputSchema = mcpGmxMultisignInput({
+  symbol: zod.z.string().min(1),
+  direction: gmxDirectionSchema,
+  orderType: gmxOrderTypeSchema,
+  sizeUsdHuman: zod.z.string().min(1),
+  collateralToken: zod.z.string().min(1),
+  collateralAmountHuman: zod.z.string().min(1),
+  triggerPriceUsdHuman: zod.z.string().optional(),
+  slippageBps: zod.z.number().int().nonnegative().optional(),
+  executionFeeBufferBps: zod.z.number().int().nonnegative().optional()
+});
+var mcpGmxDecreaseInputSchema = mcpGmxMultisignInput({
+  symbol: zod.z.string().min(1),
+  direction: gmxDirectionSchema,
+  orderType: gmxOrderTypeSchema,
+  sizeUsdHuman: zod.z.string().min(1),
+  collateralToken: zod.z.string().min(1),
+  receiveToken: zod.z.string().optional(),
+  triggerPriceUsdHuman: zod.z.string().optional(),
+  keepLeverage: zod.z.boolean().optional(),
+  slippageBps: zod.z.number().int().nonnegative().optional(),
+  executionFeeBufferBps: zod.z.number().int().nonnegative().optional()
+});
+var mcpGmxCancelInputSchema = mcpGmxMultisignInput({
+  orderId: zod.z.string().min(1)
+});
+var mcpGmxGmDepositInputSchema = mcpGmxMultisignInput({
+  marketSymbol: zod.z.string().min(1),
+  collateralToken: zod.z.string().min(1),
+  collateralAmountHuman: zod.z.string().min(1),
+  executionFeeBufferBps: zod.z.number().int().nonnegative().optional(),
+  isNativeIn: zod.z.boolean().optional(),
+  nativeWrapped: evmAddressSchema.optional()
+});
+var mcpGmxGmWithdrawInputSchema = mcpGmxMultisignInput({
+  marketSymbol: zod.z.string().min(1),
+  gmAmountHuman: zod.z.string().min(1),
+  gmDecimals: zod.z.number().int().nonnegative().optional(),
+  executionFeeBufferBps: zod.z.number().int().nonnegative().optional(),
+  isNativeOut: zod.z.boolean().optional()
+});
+var mcpGmxStakeGmxInputSchema = mcpGmxMultisignInput({
+  amountHuman: zod.z.string().min(1),
+  gmxDecimals: zod.z.number().int().nonnegative().optional()
+});
+var mcpGmxUnstakeGmxInputSchema = mcpGmxMultisignInput({
+  amountHuman: zod.z.string().min(1),
+  gmxDecimals: zod.z.number().int().nonnegative().optional()
+});
+var mcpGmxFetchGmMarketsInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive()
+});
+var mcpGmxGmMarketApyRowSchema = zod.z.object({
+  symbol: zod.z.string(),
+  marketTokenAddress: zod.z.string(),
+  longTokenSymbol: zod.z.string().nullable(),
+  shortTokenSymbol: zod.z.string().nullable(),
+  apy: zod.z.number().nullable(),
+  baseApy: zod.z.number().nullable(),
+  bonusApr: zod.z.number().nullable(),
+  apyPercentLabel: zod.z.string().nullable()
+});
+var mcpGmxFetchGmMarketsOutputSchema = zod.z.object({
+  markets: zod.z.array(mcpGmxGmMarketApyRowSchema)
+});
+var mcpGmxFetchGmApyInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive()
+});
+var mcpGmxFetchGmApyOutputSchema = zod.z.object({
+  markets: zod.z.array(
+    zod.z.object({
+      symbol: zod.z.string(),
+      marketTokenAddress: zod.z.string(),
+      longTokenSymbol: zod.z.string().nullable(),
+      shortTokenSymbol: zod.z.string().nullable(),
+      apy: zod.z.number().nullable(),
+      baseApy: zod.z.number().nullable(),
+      bonusApr: zod.z.number().nullable(),
+      apyPercentLabel: zod.z.string().nullable()
+    })
+  )
+});
+var mcpGmxFetchStakingPowerInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive(),
+  executorAddress: evmAddressSchema
+});
+var mcpGmxFetchStakingPowerOutputSchema = zod.z.object({
+  stakingPower: zod.z.record(zod.z.unknown())
+});
+var gmxOhlcvTimeframeSchema = zod.z.enum(["1m", "5m", "15m", "1h", "4h", "1d", "1w", "1M"]);
+var gmxOhlcvCandleSchema = zod.z.object({
+  timestampMs: zod.z.number(),
+  timeLabel: zod.z.string(),
+  open: zod.z.string(),
+  high: zod.z.string(),
+  low: zod.z.string(),
+  close: zod.z.string()
+});
+var mcpGmxFetchMarketPricesInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive(),
+  symbol: zod.z.string().min(1),
+  collateralSymbol: zod.z.string().min(1)
+});
+var mcpGmxFetchMarketPricesOutputSchema = zod.z.object({
+  symbol: zod.z.string(),
+  indexLabel: zod.z.string(),
+  collateralSymbol: zod.z.string(),
+  indexMarkUsd: zod.z.string().nullable(),
+  collateralUsd: zod.z.string().nullable(),
+  indexPerCollateral: zod.z.string().nullable(),
+  fetchedAtMs: zod.z.number()
+});
+var mcpGmxFetchOhlcvInputSchema = zod.z.object({
+  chainId: zod.z.number().int().positive(),
+  symbol: zod.z.string().min(1),
+  timeframe: gmxOhlcvTimeframeSchema.optional(),
+  limit: zod.z.number().int().positive().max(500).optional(),
+  sort: zod.z.enum(["asc", "desc"]).optional()
+});
+var mcpGmxFetchOhlcvOutputSchema = zod.z.object({
+  symbol: zod.z.string(),
+  timeframe: gmxOhlcvTimeframeSchema,
+  candles: zod.z.array(gmxOhlcvCandleSchema)
+});
 
 // src/agent/mcpProtocolTools.ts
 function defineProtocolMcpTool(def) {
@@ -1205,6 +1354,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
   })
 ];
 
@@ -1469,6 +1695,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 = [
@@ -1860,6 +2170,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 = module$1.createRequire(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('catalog.cjs', document.baseURI).href))));
+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 = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('catalog.cjs', document.baseURI).href)))), "skills");
 var SKILL_PROTOCOL_IDS = [
   "aave-v4",
@@ -1869,7 +2404,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);
@@ -2101,6 +2637,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 = viem.getAddress(address).toLowerCase();
+        return tokens.some((t) => t.address.toLowerCase() === normalized);
+      } catch {
+        return false;
+      }
+    }
   })
 };
 function getProtocolSupportAdvisor(protocolId) {
@@ -2135,6 +2700,7 @@ registerProtocolModule(mapleProtocolModule);
 registerProtocolModule(skyProtocolModule);
 registerProtocolModule(aaveV4ProtocolModule);
 registerProtocolModule(eulerV2ProtocolModule);
+registerProtocolModule(gmxProtocolModule);
 function getAgentCatalog() {
   return {
     protocols: getProtocolModules(),
@@ -2151,6 +2717,7 @@ function getAgentCatalog() {
     sky: skyProtocolModule,
     aaveV4: aaveV4ProtocolModule,
     eulerV2: eulerV2ProtocolModule,
+    gmx: gmxProtocolModule,
     /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
     mcp: getAgentCatalogForMcp()
   };
@@ -2200,6 +2767,28 @@ exports.mcpEulerV2CollateralWithdrawInputSchema = mcpEulerV2CollateralWithdrawIn
 exports.mcpEulerV2IsolatedBorrowInputSchema = mcpEulerV2IsolatedBorrowInputSchema;
 exports.mcpEulerV2IsolatedLendInputSchema = mcpEulerV2IsolatedLendInputSchema;
 exports.mcpEulerV2VaultWithdrawInputSchema = mcpEulerV2VaultWithdrawInputSchema;
+exports.mcpGmxCancelInputSchema = mcpGmxCancelInputSchema;
+exports.mcpGmxDecreaseInputSchema = mcpGmxDecreaseInputSchema;
+exports.mcpGmxFetchGmApyInputSchema = mcpGmxFetchGmApyInputSchema;
+exports.mcpGmxFetchGmApyOutputSchema = mcpGmxFetchGmApyOutputSchema;
+exports.mcpGmxFetchGmMarketsInputSchema = mcpGmxFetchGmMarketsInputSchema;
+exports.mcpGmxFetchGmMarketsOutputSchema = mcpGmxFetchGmMarketsOutputSchema;
+exports.mcpGmxFetchMarketPricesInputSchema = mcpGmxFetchMarketPricesInputSchema;
+exports.mcpGmxFetchMarketPricesOutputSchema = mcpGmxFetchMarketPricesOutputSchema;
+exports.mcpGmxFetchMarketsInputSchema = mcpGmxFetchMarketsInputSchema;
+exports.mcpGmxFetchMarketsOutputSchema = mcpGmxFetchMarketsOutputSchema;
+exports.mcpGmxFetchOhlcvInputSchema = mcpGmxFetchOhlcvInputSchema;
+exports.mcpGmxFetchOhlcvOutputSchema = mcpGmxFetchOhlcvOutputSchema;
+exports.mcpGmxFetchPositionsInputSchema = mcpGmxFetchPositionsInputSchema;
+exports.mcpGmxFetchPositionsOutputSchema = mcpGmxFetchPositionsOutputSchema;
+exports.mcpGmxFetchStakingPowerInputSchema = mcpGmxFetchStakingPowerInputSchema;
+exports.mcpGmxFetchStakingPowerOutputSchema = mcpGmxFetchStakingPowerOutputSchema;
+exports.mcpGmxGmDepositInputSchema = mcpGmxGmDepositInputSchema;
+exports.mcpGmxGmWithdrawInputSchema = mcpGmxGmWithdrawInputSchema;
+exports.mcpGmxIncreaseInputSchema = mcpGmxIncreaseInputSchema;
+exports.mcpGmxMultisignOutputSchema = multisignOutputSchema;
+exports.mcpGmxStakeGmxInputSchema = mcpGmxStakeGmxInputSchema;
+exports.mcpGmxUnstakeGmxInputSchema = mcpGmxUnstakeGmxInputSchema;
 exports.mcpLidoClaimWithdrawalInputSchema = mcpLidoClaimWithdrawalInputSchema;
 exports.mcpLidoRequestWithdrawalsInputSchema = mcpLidoRequestWithdrawalsInputSchema;
 exports.mcpLidoSubmitInputSchema = mcpLidoSubmitInputSchema;