@continuumdao/ctm-mpc-defi 0.2.6 → 0.2.8

package/dist/agent/catalog.cjs

@@ -382,7 +382,7 @@ var EVM_COMMON_PARAM_DOCS = {
   useCustomGas: {
     type: "boolean",
     required: true,
-    description: "When true, apply chain gas settings from chainDetail / customGasChainDetails instead of raw RPC estimates only."
+    description: "When true, apply Custom Gas Config from chainDetail / customGasChainDetails. Omitted baseFee/priorityFee is valid \u2014 live RPC fees are used at proposal; configured values are optional floors/multipliers. When false, use live RPC estimates only."
   },
   chainId: {
     type: "number",
@@ -410,8 +410,17 @@ var EVM_COMMON_PARAM_DOCS = {
     description: "Snapshot written to extraJSON.customGasChainDetails when useCustomGas is true."
   }
 };
+var MULTISIGN_SUBMIT_OUTPUT_DOC = {
+  description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result. Do not call the same build tool again if requestId was returned.",
+  fields: {
+    requestId: {
+      type: "string",
+      description: "Sign request id from POST /multiSignRequest."
+    }
+  }
+};
 var MULTISIGN_OUTPUT_DOC = {
-  description: "Unsigned mpc-auth multiSignRequest payload. The caller must sign messageToSign (MetaMask personal_sign or Ed25519) and POST { ...bodyForSign, clientSig, signedMessage: messageToSign } to /multiSignRequest.",
+  description: "Unsigned mpc-auth multiSignRequest payload from protocol builders. MCP agents receive { requestId } instead; node-app callers sign messageToSign and POST { ...bodyForSign, clientSig, signedMessage }.",
   fields: {
     bodyForSign: {
       type: "object",
@@ -460,6 +469,21 @@ var MANAGEMENT_SIG_DOC = {
     fetchPreferredKeyGen: "GET /getPreferredKeyGen for agent default KeyGen."
   }
 };
+
+// src/agent/mcpMultisignSubmitMeta.ts
+var MCP_MULTISIGN_SUBMIT_DESCRIPTION_SUFFIX = "Builds the unsigned batch, signs the management envelope, and POSTs /multiSignRequest. Returns { requestId } on success \u2014 do not call again; use list_sign_requests to verify duplicates.";
+var MCP_MULTISIGN_SUBMIT_FOLLOW_UP = [
+  "wait_for_sign_request_ready",
+  "sign_request_agree",
+  "trigger_sign_result",
+  "broadcast_sign_result"
+];
+function withMultisignSubmitMcpMeta(description, followUp = MCP_MULTISIGN_SUBMIT_FOLLOW_UP) {
+  return {
+    description: `${description.trim()} ${MCP_MULTISIGN_SUBMIT_DESCRIPTION_SUFFIX}`,
+    followUp: [...followUp]
+  };
+}
 function zodSchemaToMcpJsonSchema(schema) {
   const raw = zodToJsonSchema.zodToJsonSchema(schema, {
     target: "openApi3",
@@ -504,7 +528,7 @@ var evmMultisignCommonInputSchema = zod.z.object({
     "Human-readable purpose for the sign request. Stored in bodyForSign.purpose (may be appended with an automatic batch suffix)."
   ),
   useCustomGas: zod.z.boolean().describe(
-    "When true, apply chain gas settings from chainDetail / customGasChainDetails instead of raw RPC estimates only."
+    "When true, apply Custom Gas Config from chainDetail / customGasChainDetails. Omitted baseFee/priorityFee is valid \u2014 builder uses live RPC fees; configured values are optional floors/multipliers. When false, use live RPC estimates only."
   ),
   chainId: zod.z.number().int().positive().describe("EVM chain id (decimal). Becomes destinationChainID on the sign request."),
   rpcUrl: zod.z.string().min(1).describe("HTTPS JSON-RPC URL for gas estimation, nonce, and allowance reads."),
@@ -520,9 +544,12 @@ var multisignOutputSchema = zod.z.object({
   ),
   messageToSign: zod.z.string().describe("JSON.stringify(bodyForSign) \u2014 exact string to sign before adding clientSig.")
 }).describe(
-  "Unsigned mpc-auth multiSignRequest payload. Sign messageToSign and POST { ...bodyForSign, clientSig, signedMessage } to /multiSignRequest."
+  "Unsigned mpc-auth multiSignRequest payload from protocol builders (used internally before management submit)."
 );
 var jsonObjectSchema = zod.z.record(zod.z.unknown());
+function parseMultisignBuilderOutput(data) {
+  return multisignOutputSchema.parse(data);
+}
 var uniswapQuoteTradeTypeSchema = zod.z.enum(["EXACT_INPUT", "EXACT_OUTPUT"]);
 var mcpUniswapV4QuoteInputSchema = zod.z.object({
   type: uniswapQuoteTradeTypeSchema.describe("EXACT_INPUT or EXACT_OUTPUT"),
@@ -741,6 +768,26 @@ var mcpCurveDaoBuildSwapMultisignInputSchema = evmMultisignCommonInputSchema.ext
   amountHuman: zod.z.string().min(1).describe("Human-readable amount of tokenIn"),
   slippagePercent: zod.z.number().gt(0).lt(100).describe("Slippage 0\u2013100 exclusive")
 });
+var mcpServerCommonInputSchema = zod.z.object({
+  keyGenId: zod.z.string().min(1).describe("KeyGen id from fetch_key_gen_result / node preferred KeyGen"),
+  chainId: zod.z.number().int().positive().describe("EVM chain id; RPC and gas config resolved from chain registry"),
+  purposeText: zod.z.string().min(1).describe("Human-readable purpose for the sign request"),
+  useCustomGas: zod.z.boolean().optional().describe("Apply chain gas settings from registry when true")
+});
+function mcpServerMultisignInput(fields) {
+  return mcpServerCommonInputSchema.extend(fields);
+}
+var mcpServerSubmitOutputSchema = zod.z.object({
+  requestId: zod.z.string().min(1).describe("Sign request id from POST /multiSignRequest \u2014 success; do not retry the same build tool.")
+}).describe(
+  "Submitted mpc-auth multiSignRequest. Continue with wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result."
+);
+var MCP_NON_SUBMIT_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "ctm_uniswap_v4_quote",
+  "ctm_uniswap_v4_create_swap"
+]);
+
+// src/agent/schemas/protocols.ts
 function mcpMultisignInput(fields) {
   return evmMultisignCommonInputSchema.extend(fields);
 }
@@ -1031,13 +1078,16 @@ var mcpGmxFetchOhlcvOutputSchema = zod.z.object({
 
 // src/agent/mcpProtocolTools.ts
 function defineProtocolMcpTool(def) {
+  const meta = withMultisignSubmitMcpMeta(def.description, def.followUp ?? MCP_MULTISIGN_SUBMIT_FOLLOW_UP);
   return {
     ...def,
-    outputZod: multisignOutputSchema,
+    description: meta.description,
+    followUp: meta.followUp,
+    outputZod: mcpServerSubmitOutputSchema,
     inputSchema: zodSchemaToMcpJsonSchema(def.inputZod),
-    outputSchema: zodSchemaToMcpJsonSchema(multisignOutputSchema),
+    outputSchema: zodSchemaToMcpJsonSchema(mcpServerSubmitOutputSchema),
     parseInput: (data) => def.inputZod.parse(data),
-    parseOutput: (data) => multisignOutputSchema.parse(data)
+    parseOutput: (data) => mcpServerSubmitOutputSchema.parse(data)
   };
 }
 var MCP_PROTOCOL_TOOL_DEFINITIONS = [
@@ -1046,9 +1096,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "lido.submit",
     protocolId: "lido",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for Lido ETH stake (submit).",
+    description: "Create and submit mpc-auth multiSignRequest for Lido ETH stake (submit).",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoSubmit" },
     inputZod: mcpLidoSubmitInputSchema
   }),
@@ -1059,7 +1108,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build batch for Lido withdrawal queue (approve + requestWithdrawals).",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoRequestWithdrawals" },
     inputZod: mcpLidoRequestWithdrawalsInputSchema
   }),
@@ -1070,7 +1118,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build tx for Lido claimWithdrawal.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoClaimWithdrawal" },
     inputZod: mcpLidoClaimWithdrawalInputSchema
   }),
@@ -1081,7 +1128,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build batch for wstETH wrap.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoWrapStEth" },
     inputZod: mcpLidoWrapStEthInputSchema
   }),
@@ -1092,7 +1138,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build tx for wstETH unwrap.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoUnwrapWstEth" },
     inputZod: mcpLidoUnwrapWstEthInputSchema
   }),
@@ -1103,7 +1148,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build batch: USDe approve + sUSDe deposit.",
     prerequisites: ["keyGen", "executorAddress", "Ethereum mainnet RPC"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaUsdeStakeToSusde" },
     inputZod: mcpEthenaStakeInputSchema
   }),
@@ -1114,7 +1158,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build sUSDe redeem when cooldown is off.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaSusdeRedeemToUsde" },
     inputZod: mcpEthenaRedeemInputSchema
   }),
@@ -1125,7 +1168,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build sUSDe cooldownShares batch step.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaSusdeCooldownShares" },
     inputZod: mcpEthenaCooldownInputSchema
   }),
@@ -1136,7 +1178,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build unstake claim after cooldown.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaUnstakeClaim" },
     inputZod: mcpEthenaClaimInputSchema
   }),
@@ -1147,7 +1188,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Maple Syrup router deposit batch.",
     prerequisites: ["keyGen", "executorAddress", "router + pool addresses"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/maple", exportName: "buildEvmMultisignBodyMapleSyrupDeposit" },
     inputZod: mcpMapleDepositInputSchema
   }),
@@ -1158,7 +1198,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Maple PoolV2 requestRedeem batch.",
     prerequisites: ["keyGen", "executorAddress", "pool address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/maple", exportName: "buildEvmMultisignBodyMaplePoolRequestRedeem" },
     inputZod: mcpMapleRequestRedeemInputSchema
   }),
@@ -1169,7 +1208,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Sky Lockstake open/stake batch.",
     prerequisites: ["keyGen", "executorAddress", "Ethereum mainnet RPC"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeStakePositionBatch" },
     inputZod: mcpSkyLockstakeStakeInputSchema
   }),
@@ -1180,7 +1218,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Lockstake draw (borrow USDS).",
     prerequisites: ["keyGen", "executorAddress", "open urn"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeDrawBatch" },
     inputZod: mcpSkyLockstakeDrawInputSchema
   }),
@@ -1191,7 +1228,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Lockstake repay/wipe batch.",
     prerequisites: ["keyGen", "executorAddress", "urn index"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeWipeBatch" },
     inputZod: mcpSkyLockstakeWipeInputSchema
   }),
@@ -1202,7 +1238,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Lockstake close position batch.",
     prerequisites: ["keyGen", "executorAddress", "urn index"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeCloseBatch" },
     inputZod: mcpSkyLockstakeCloseInputSchema
   }),
@@ -1213,7 +1248,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Lockstake getReward batch.",
     prerequisites: ["keyGen", "executorAddress", "urn index"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeGetRewardBatch" },
     inputZod: mcpSkyLockstakeGetRewardInputSchema
   }),
@@ -1224,7 +1258,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build USDS \u2192 sUSDS ERC-4626 deposit batch.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkySusdsDepositFromUsdsBatch" },
     inputZod: mcpSkySusdsDepositInputSchema
   }),
@@ -1235,7 +1268,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build sUSDS redeem to USDS batch.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/sky", exportName: "buildSkySusdsRedeemToUsdsBatch" },
     inputZod: mcpSkySusdsRedeemInputSchema
   }),
@@ -1246,7 +1278,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Aave v4 Spoke supply/deposit batch (wrap native, approve, supply).",
     prerequisites: ["keyGenId", "chainId", "underlying", "amountHuman", "get_defi_protocol_skill for hubs/spokes"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4DepositBatch" },
     inputZod: mcpAaveV4DepositInputSchema
   }),
@@ -1257,7 +1288,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Aave v4 Spoke withdraw; health-factor preview when user has borrow debt.",
     prerequisites: ["keyGenId", "chainId", "underlying (supplied asset)", "amountHuman"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeWithdraw" },
     inputZod: mcpAaveV4WithdrawInputSchema
   }),
@@ -1274,7 +1304,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
       "amountHuman",
       "collateral supplied via deposit"
     ],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeBorrow" },
     inputZod: mcpAaveV4BorrowInputSchema
   }),
@@ -1285,7 +1314,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Aave v4 Spoke repay (approve if needed + repay).",
     prerequisites: ["keyGenId", "chainId", "underlying (debt token)", "amountHuman"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeRepay" },
     inputZod: mcpAaveV4RepayInputSchema
   }),
@@ -1296,7 +1324,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Euler v2 vault deposit/lend batch.",
     prerequisites: ["keyGen", "executorAddress", "vault address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2IsolatedLendDepositBatch" },
     inputZod: mcpEulerV2IsolatedLendInputSchema
   }),
@@ -1307,7 +1334,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Euler v2 isolated borrow loop batch.",
     prerequisites: ["keyGen", "executorAddress", "vault + collateral"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2IsolatedBorrowBatch" },
     inputZod: mcpEulerV2IsolatedBorrowInputSchema
   }),
@@ -1318,7 +1344,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Euler v2 vault withdraw/redeem batch.",
     prerequisites: ["keyGen", "executorAddress", "vault address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2VaultWithdraw" },
     inputZod: mcpEulerV2VaultWithdrawInputSchema
   }),
@@ -1329,7 +1354,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Euler v2 borrow repay batch.",
     prerequisites: ["keyGen", "executorAddress", "vault address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowRepayBatch" },
     inputZod: mcpEulerV2BorrowRepayInputSchema
   }),
@@ -1340,7 +1364,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Euler v2 borrow collateral deposit batch.",
     prerequisites: ["keyGen", "executorAddress", "vault + collateral asset"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowCollateralDepositBatch" },
     inputZod: mcpEulerV2CollateralDepositInputSchema
   }),
@@ -1351,7 +1374,6 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build Euler v2 borrow collateral withdraw batch.",
     prerequisites: ["keyGen", "executorAddress", "vault + collateral asset"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowCollateralWithdrawBatch" },
     inputZod: mcpEulerV2CollateralWithdrawInputSchema
   }),
@@ -1360,9 +1382,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     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.",
+    description: "Create and submit 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
   }),
@@ -1371,9 +1392,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "gmx.decrease",
     protocolId: "gmx",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for GMX classic decrease order (close/reduce perp).",
+    description: "Create and submit 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
   }),
@@ -1382,9 +1402,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "gmx.cancel",
     protocolId: "gmx",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest to cancel a pending GMX order (classic on-chain).",
+    description: "Create and submit 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
   }),
@@ -1393,9 +1412,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "gmx.gmDeposit",
     protocolId: "gmx",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for GMX GM pool deposit (ExchangeRouter multicall). Keeper executes asynchronously.",
+    description: "Create and submit 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
   }),
@@ -1404,9 +1422,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "gmx.gmWithdraw",
     protocolId: "gmx",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for GMX GM pool withdrawal (ExchangeRouter multicall). Keeper executes asynchronously.",
+    description: "Create and submit 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
   }),
@@ -1415,9 +1432,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "gmx.stakeGmx",
     protocolId: "gmx",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest to stake GMX via RewardRouter.",
+    description: "Create and submit 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
   }),
@@ -1426,9 +1442,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "gmx.unstakeGmx",
     protocolId: "gmx",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest to unstake GMX via RewardRouter.",
+    description: "Create and submit 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
   })
@@ -1444,6 +1459,15 @@ function defineMcpTool(def) {
     parseOutput: (data) => def.outputZod.parse(data)
   };
 }
+function defineMultisignSubmitMcpTool(def) {
+  const meta = withMultisignSubmitMcpMeta(def.description, def.followUp ?? MCP_MULTISIGN_SUBMIT_FOLLOW_UP);
+  return defineMcpTool({
+    ...def,
+    description: meta.description,
+    followUp: meta.followUp,
+    outputZod: mcpServerSubmitOutputSchema
+  });
+}
 var CORE_MCP_TOOL_DEFINITIONS = [
   defineMcpTool({
     name: "ctm_uniswap_v4_quote",
@@ -1476,20 +1500,18 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpUniswapV4CreateSwapInputSchema,
     outputZod: mcpUniswapV4CreateSwapOutputSchema
   }),
-  defineMcpTool({
+  defineMultisignSubmitMcpTool({
     name: "ctm_uniswap_v4_build_swap_multisign",
     actionId: "uniswap-v4.swap-exact-input",
     protocolId: "uniswap-v4",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest body for a Uniswap V4 swap. May batch 1\u20133 EVM txs: ERC-20 approve(s) to Permit2/router path + Universal Router swap (or 1 tx for native-in). Estimates gas, serializes unsigned txs, sets proposalTxParams. Output must be signed and POSTed to /multiSignRequest by the caller.",
+    description: "Create and submit mpc-auth multiSignRequest for a Uniswap V4 swap. May batch 1\u20133 EVM txs: ERC-20 approve(s) + Universal Router swap (or 1 tx for native-in).",
     prerequisites: [
       "ctm_uniswap_v4_create_swap output + matching quote snapshot and swapDeadlineUnix",
       "keyGenId + chainId + purposeText"
     ],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
     handler: { importPath: "protocols/evm/uniswap-v4", exportName: "buildEvmMultisignBodyUniswapV4SkipPermit2Batch" },
-    inputZod: mcpUniswapV4BuildSwapMultisignInputSchema,
-    outputZod: multisignOutputSchema
+    inputZod: mcpUniswapV4BuildSwapMultisignInputSchema
   }),
   defineMcpTool({
     name: "ctm_uniswap_v4_list_lp_pools",
@@ -1519,24 +1541,22 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpUniswapV4LpCreatePositionInputSchema,
     outputZod: mcpUniswapV4LpCreatePositionOutputSchema
   }),
-  defineMcpTool({
+  defineMultisignSubmitMcpTool({
     name: "ctm_uniswap_v4_build_mint_liquidity_multisign",
     actionId: "uniswap-v4.mint-liquidity",
     protocolId: "uniswap-v4",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for minting a Uniswap V4 LP position. Batches ERC-20 approve(s) + Position Manager tx from LP create response.",
+    description: "Create and submit mpc-auth multiSignRequest for minting a Uniswap V4 LP position. Batches ERC-20 approve(s) + Position Manager tx from LP create response.",
     prerequisites: ["ctm_uniswap_v4_lp_create_position output", "keyGenId + chainId + purposeText"],
     followUp: [
-      "Sign messageToSign",
-      "POST /multiSignRequest",
-      "After execute: ctm_uniswap_v4_register_position_from_mint_tx (mint tx hash)"
+      ...MCP_MULTISIGN_SUBMIT_FOLLOW_UP,
+      "After broadcast: ctm_uniswap_v4_register_position_from_mint_tx (mint tx hash)"
     ],
     handler: {
       importPath: "protocols/evm/uniswap-v4",
       exportName: "buildEvmMultisignBodyUniswapV4MintLiquidityBatch"
     },
-    inputZod: mcpUniswapV4BuildMintLiquidityMultisignInputSchema,
-    outputZod: multisignOutputSchema
+    inputZod: mcpUniswapV4BuildMintLiquidityMultisignInputSchema
   }),
   defineMcpTool({
     name: "ctm_uniswap_v4_lp_increase",
@@ -1550,20 +1570,18 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpUniswapV4LpIncreaseInputSchema,
     outputZod: mcpUniswapV4LpIncreaseOutputSchema
   }),
-  defineMcpTool({
+  defineMultisignSubmitMcpTool({
     name: "ctm_uniswap_v4_build_increase_liquidity_multisign",
     actionId: "uniswap-v4.increase-liquidity",
     protocolId: "uniswap-v4",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest to increase Uniswap V4 position liquidity.",
+    description: "Create and submit mpc-auth multiSignRequest to increase Uniswap V4 position liquidity.",
     prerequisites: ["ctm_uniswap_v4_lp_increase output"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: {
       importPath: "protocols/evm/uniswap-v4",
       exportName: "buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch"
     },
-    inputZod: mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema,
-    outputZod: multisignOutputSchema
+    inputZod: mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema
   }),
   defineMcpTool({
     name: "ctm_uniswap_v4_lp_decrease",
@@ -1577,20 +1595,18 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpUniswapV4LpDecreaseInputSchema,
     outputZod: mcpUniswapV4LpDecreaseOutputSchema
   }),
-  defineMcpTool({
+  defineMultisignSubmitMcpTool({
     name: "ctm_uniswap_v4_build_decrease_liquidity_multisign",
     actionId: "uniswap-v4.decrease-liquidity",
     protocolId: "uniswap-v4",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest to decrease Uniswap V4 position liquidity.",
+    description: "Create and submit mpc-auth multiSignRequest to decrease Uniswap V4 position liquidity.",
     prerequisites: ["ctm_uniswap_v4_lp_decrease output"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: {
       importPath: "protocols/evm/uniswap-v4",
       exportName: "buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch"
     },
-    inputZod: mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema,
-    outputZod: multisignOutputSchema
+    inputZod: mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema
   }),
   defineMcpTool({
     name: "ctm_uniswap_v4_lp_collect",
@@ -1604,20 +1620,18 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpUniswapV4LpClaimInputSchema,
     outputZod: mcpUniswapV4LpClaimOutputSchema
   }),
-  defineMcpTool({
+  defineMultisignSubmitMcpTool({
     name: "ctm_uniswap_v4_build_collect_fees_multisign",
     actionId: "uniswap-v4.collect-fees",
     protocolId: "uniswap-v4",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest to collect fees from a Uniswap V4 position.",
+    description: "Create and submit mpc-auth multiSignRequest to collect fees from a Uniswap V4 position.",
     prerequisites: ["ctm_uniswap_v4_lp_collect output"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: {
       importPath: "protocols/evm/uniswap-v4",
       exportName: "buildEvmMultisignBodyUniswapV4CollectFeesBatch"
     },
-    inputZod: mcpUniswapV4BuildCollectFeesMultisignInputSchema,
-    outputZod: multisignOutputSchema
+    inputZod: mcpUniswapV4BuildCollectFeesMultisignInputSchema
   }),
   defineMcpTool({
     name: "ctm_uniswap_v4_lp_list_positions",
@@ -1680,21 +1694,19 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpCurveDaoQuoteInputSchema,
     outputZod: mcpCurveDaoQuoteOutputSchema
   }),
-  defineMcpTool({
+  defineMultisignSubmitMcpTool({
     name: "ctm_curve_dao_build_swap_multisign",
     actionId: "curve-dao.swap",
     protocolId: "curve-dao",
     chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for a Curve Router NG swap via @curvefi/api populateSwap. Optionally batches ERC-20 approve txs when allowance is insufficient, then exchange. Requires JSON-RPC and Curve-supported chain.",
+    description: "Create and submit mpc-auth multiSignRequest for a Curve Router NG swap via @curvefi/api populateSwap. Optionally batches ERC-20 approve txs when allowance is insufficient, then exchange.",
     prerequisites: [
       "ctm_curve_dao_quote (recommended)",
       "keyGenId + chainId + purposeText + slippagePercent (0\u2013100 exclusive)",
       "get_defi_protocol_skill for tokenIn address rules"
     ],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
     handler: { importPath: "protocols/evm/curve-dao", exportName: "buildEvmMultisignBodyCurveDaoBatch" },
-    inputZod: mcpCurveDaoBuildSwapMultisignInputSchema,
-    outputZod: multisignOutputSchema
+    inputZod: mcpCurveDaoBuildSwapMultisignInputSchema
   }),
   defineMcpTool({
     name: "ctm_gmx_fetch_markets",
@@ -1822,6 +1834,7 @@ function getAgentCatalogForMcp() {
     protocols: getProtocolModules(),
     commonParams: EVM_COMMON_PARAM_DOCS,
     multisignOutput: MULTISIGN_OUTPUT_DOC,
+    multisignSubmitOutput: MULTISIGN_SUBMIT_OUTPUT_DOC,
     managementSig: MANAGEMENT_SIG_DOC,
     /** Zod schemas for MCP tool I/O — source of truth for continuum-mcp-server validation. */
     inputSchemas: MCP_TOOL_INPUT_SCHEMAS,
@@ -1830,9 +1843,14 @@ function getAgentCatalogForMcp() {
       evmSwapTypical: [
         "1. Quote (protocol-specific API if needed)",
         "2. Build protocol calldata (e.g. create_swap)",
-        "3. build_*_multisign \u2192 { bodyForSign, messageToSign }",
-        "4. Sign messageToSign (MetaMask or Ed25519)",
-        "5. POST /multiSignRequest with clientSig and signedMessage"
+        "3. build_*_multisign \u2192 { requestId } (MCP auto-submits)",
+        "4. wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result"
+      ],
+      evmSwapManualTypical: [
+        "1. Quote (protocol-specific API if needed)",
+        "2. Build protocol calldata",
+        "3. Protocol builder \u2192 { bodyForSign, messageToSign } (node app only)",
+        "4. Sign messageToSign and POST /multiSignRequest with clientSig and signedMessage"
       ],
       managementPostTypical: [
         "1. GET /getNodeKey \u2192 nodeKey (128 hex)",
@@ -2180,8 +2198,8 @@ var require2 = module$1.createRequire(url.fileURLToPath((typeof document === 'un
 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"]
+  42161: ["https://arbitrum.gmxapi.io", "https://arbitrum.gmxapi.ai"],
+  43114: ["https://avalanche.gmxapi.io", "https://avalanche.gmxapi.ai"]
 };
 function buildGmxUrl(baseUrl, path, query) {
   const base = baseUrl.replace(/\/$/, "");
@@ -2410,12 +2428,26 @@ var SKILL_PROTOCOL_IDS = [
 function getToolsForProtocol(protocolId) {
   return MCP_TOOL_DEFINITIONS.filter((t) => t.protocolId === protocolId);
 }
+function readSharedMultisignMcpGasSection() {
+  try {
+    return fs.readFileSync(path.join(skillsDir, "_shared", "multisign-mcp-gas.md"), "utf8").trim();
+  } catch {
+    return "";
+  }
+}
 function getProtocolSkill(protocolId) {
   if (!SKILL_PROTOCOL_IDS.includes(protocolId)) {
     return void 0;
   }
   try {
-    return fs.readFileSync(path.join(skillsDir, protocolId, "SKILL.md"), "utf8");
+    const skill = fs.readFileSync(path.join(skillsDir, protocolId, "SKILL.md"), "utf8").trim();
+    const shared = readSharedMultisignMcpGasSection();
+    if (!shared) return skill;
+    if (skill.includes("## Gas and MCP submit")) return skill;
+    return `${skill}
+
+${shared}
+`;
   } catch {
     return void 0;
   }
@@ -2674,22 +2706,6 @@ function getProtocolSupportAdvisor(protocolId) {
 function listProtocolSupportAdvisorIds() {
   return Object.keys(PROTOCOL_SUPPORT_ADVISORS);
 }
-var mcpServerCommonInputSchema = zod.z.object({
-  keyGenId: zod.z.string().min(1).describe("KeyGen id from fetch_key_gen_result / node preferred KeyGen"),
-  chainId: zod.z.number().int().positive().describe("EVM chain id; RPC and gas config resolved from chain registry"),
-  purposeText: zod.z.string().min(1).describe("Human-readable purpose for the sign request"),
-  useCustomGas: zod.z.boolean().optional().describe("Apply chain gas settings from registry when true")
-});
-function mcpServerMultisignInput(fields) {
-  return mcpServerCommonInputSchema.extend(fields);
-}
-var mcpServerSubmitOutputSchema = zod.z.object({
-  requestId: zod.z.string().min(1)
-}).describe("mpc-auth multiSignRequest id; continue with trigger_sign_result / broadcast_sign_result");
-var MCP_NON_SUBMIT_TOOL_NAMES = /* @__PURE__ */ new Set([
-  "ctm_uniswap_v4_quote",
-  "ctm_uniswap_v4_create_swap"
-]);
 
 // src/agent/catalog.ts
 registerProtocolModule(uniswapV4ProtocolModule);
@@ -2730,6 +2746,7 @@ exports.MCP_TOOL_DEFINITIONS = MCP_TOOL_DEFINITIONS;
 exports.MCP_TOOL_INPUT_SCHEMAS = MCP_TOOL_INPUT_SCHEMAS;
 exports.MCP_TOOL_OUTPUT_SCHEMAS = MCP_TOOL_OUTPUT_SCHEMAS;
 exports.MULTISIGN_OUTPUT_DOC = MULTISIGN_OUTPUT_DOC;
+exports.MULTISIGN_SUBMIT_OUTPUT_DOC = MULTISIGN_SUBMIT_OUTPUT_DOC;
 exports.PROTOCOL_SUPPORT_ADVISORS = PROTOCOL_SUPPORT_ADVISORS;
 exports.chainDetailSchema = chainDetailSchema;
 exports.evmAddressSchema = evmAddressSchema;
@@ -2786,7 +2803,7 @@ exports.mcpGmxFetchStakingPowerOutputSchema = mcpGmxFetchStakingPowerOutputSchem
 exports.mcpGmxGmDepositInputSchema = mcpGmxGmDepositInputSchema;
 exports.mcpGmxGmWithdrawInputSchema = mcpGmxGmWithdrawInputSchema;
 exports.mcpGmxIncreaseInputSchema = mcpGmxIncreaseInputSchema;
-exports.mcpGmxMultisignOutputSchema = multisignOutputSchema;
+exports.mcpGmxMultisignOutputSchema = mcpServerSubmitOutputSchema;
 exports.mcpGmxStakeGmxInputSchema = mcpGmxStakeGmxInputSchema;
 exports.mcpGmxUnstakeGmxInputSchema = mcpGmxUnstakeGmxInputSchema;
 exports.mcpLidoClaimWithdrawalInputSchema = mcpLidoClaimWithdrawalInputSchema;
@@ -2798,6 +2815,7 @@ exports.mcpMapleDepositInputSchema = mcpMapleDepositInputSchema;
 exports.mcpMapleRequestRedeemInputSchema = mcpMapleRequestRedeemInputSchema;
 exports.mcpMultisignInput = mcpMultisignInput;
 exports.mcpMultisignOutputSchema = multisignOutputSchema;
+exports.mcpMultisignSubmitOutputSchema = mcpServerSubmitOutputSchema;
 exports.mcpServerCommonInputSchema = mcpServerCommonInputSchema;
 exports.mcpServerMultisignInput = mcpServerMultisignInput;
 exports.mcpServerSubmitOutputSchema = mcpServerSubmitOutputSchema;
@@ -2836,6 +2854,7 @@ exports.mcpUniswapV4RegisterPositionNftOutputSchema = mcpUniswapV4RegisterPositi
 exports.multisignOutputSchema = multisignOutputSchema;
 exports.parseMcpToolInput = parseMcpToolInput;
 exports.parseMcpToolOutput = parseMcpToolOutput;
+exports.parseMultisignBuilderOutput = parseMultisignBuilderOutput;
 exports.uniswapQuoteTradeTypeSchema = uniswapQuoteTradeTypeSchema;
 exports.zodSchemaToMcpJsonSchema = zodSchemaToMcpJsonSchema;
 //# sourceMappingURL=catalog.cjs.map