@continuumdao/ctm-mpc-defi 0.2.16 → 0.2.17

package/dist/agent/catalog.d.ts

@@ -83,7 +83,7 @@ declare function getAgentCatalogForMcp(): {
         };
     };
     multisignSubmitOutput: {
-        readonly description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with wait_for_sign_request_ready → sign_request_agree → trigger_sign_result → broadcast_sign_result. Do not call the same build tool again if requestId was returned.";
+        readonly description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with sign_request_agree → trigger_sign_result → broadcast_sign_result. Do not poll wait_for_sign_request_ready after submit (Join may take days). Do not call the same build tool again if requestId was returned.";
         readonly fields: {
             readonly requestId: {
                 readonly type: "string";
@@ -95,7 +95,7 @@ declare function getAgentCatalogForMcp(): {
             };
             readonly followUp: {
                 readonly type: "string";
-                readonly description: "Lifecycle next steps (wait_for_sign_request_ready → agree → trigger → broadcast).";
+                readonly description: "Lifecycle next steps (sign_request_agree → trigger_sign_result → broadcast_sign_result). No polling after submit.";
             };
         };
     };
@@ -223,12 +223,15 @@ declare const mcpServerSubmitOutputSchema: z.ZodObject<{
     requestId: z.ZodString;
     status: z.ZodOptional<z.ZodLiteral<"submitted">>;
     followUp: z.ZodOptional<z.ZodString>;
+    fees: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     requestId: string;
+    fees?: Record<string, unknown> | undefined;
     status?: "submitted" | undefined;
     followUp?: string | undefined;
 }, {
     requestId: string;
+    fees?: Record<string, unknown> | undefined;
     status?: "submitted" | undefined;
     followUp?: string | undefined;
 }>;
@@ -239,7 +242,7 @@ declare const MCP_NON_SUBMIT_TOOL_NAMES: Set<string>;
 declare const EVM_COMMON_PARAM_DOCS: Record<string, ParamDoc>;
 /** MCP agent path: build_* tools auto-submit and return requestId. */
 declare const MULTISIGN_SUBMIT_OUTPUT_DOC: {
-    readonly description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with wait_for_sign_request_ready → sign_request_agree → trigger_sign_result → broadcast_sign_result. Do not call the same build tool again if requestId was returned.";
+    readonly description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with sign_request_agree → trigger_sign_result → broadcast_sign_result. Do not poll wait_for_sign_request_ready after submit (Join may take days). Do not call the same build tool again if requestId was returned.";
     readonly fields: {
         readonly requestId: {
             readonly type: "string";
@@ -251,7 +254,7 @@ declare const MULTISIGN_SUBMIT_OUTPUT_DOC: {
         };
         readonly followUp: {
             readonly type: "string";
-            readonly description: "Lifecycle next steps (wait_for_sign_request_ready → agree → trigger → broadcast).";
+            readonly description: "Lifecycle next steps (sign_request_agree → trigger_sign_result → broadcast_sign_result). No polling after submit.";
         };
     };
 };
@@ -5484,6 +5487,7 @@ declare function getAgentCatalog(): {
     gmx: ProtocolModule;
     hyperliquid: ProtocolModule;
     morpho: ProtocolModule;
+    circleCctp: ProtocolModule;
     /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
     mcp: {
         tools: readonly McpToolDefinition[];
@@ -5503,7 +5507,7 @@ declare function getAgentCatalog(): {
             };
         };
         multisignSubmitOutput: {
-            readonly description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with wait_for_sign_request_ready → sign_request_agree → trigger_sign_result → broadcast_sign_result. Do not call the same build tool again if requestId was returned.";
+            readonly description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with sign_request_agree → trigger_sign_result → broadcast_sign_result. Do not poll wait_for_sign_request_ready after submit (Join may take days). Do not call the same build tool again if requestId was returned.";
             readonly fields: {
                 readonly requestId: {
                     readonly type: "string";
@@ -5515,7 +5519,7 @@ declare function getAgentCatalog(): {
                 };
                 readonly followUp: {
                     readonly type: "string";
-                    readonly description: "Lifecycle next steps (wait_for_sign_request_ready → agree → trigger → broadcast).";
+                    readonly description: "Lifecycle next steps (sign_request_agree → trigger_sign_result → broadcast_sign_result). No polling after submit.";
                 };
             };
         };

package/dist/agent/catalog.js

@@ -408,7 +408,7 @@ var EVM_COMMON_PARAM_DOCS = {
   }
 };
 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.",
+  description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result. Do not poll wait_for_sign_request_ready after submit (Join may take days). Do not call the same build tool again if requestId was returned.",
   fields: {
     requestId: {
       type: "string",
@@ -420,7 +420,7 @@ var MULTISIGN_SUBMIT_OUTPUT_DOC = {
     },
     followUp: {
       type: "string",
-      description: "Lifecycle next steps (wait_for_sign_request_ready \u2192 agree \u2192 trigger \u2192 broadcast)."
+      description: "Lifecycle next steps (sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result). No polling after submit."
     }
   }
 };
@@ -478,7 +478,6 @@ var MANAGEMENT_SIG_DOC = {
 // 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"
@@ -1256,9 +1255,10 @@ var mcpServerSubmitOutputSchema = z.object({
   status: z.literal("submitted").optional().describe("Present when POST /multiSignRequest succeeded. Confirms the request exists on the node."),
   followUp: z.string().optional().describe(
     "Next MCP lifecycle steps. Do not call the same build_*_multisign tool again unless the user explicitly wants a duplicate order."
-  )
+  ),
+  fees: z.record(z.unknown()).optional().describe("Protocol fee summary when available (e.g. Circle CCTP Forwarding Service quote used at propose).")
 }).describe(
-  "Submitted mpc-auth multiSignRequest. Continue with wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result."
+  "Submitted mpc-auth multiSignRequest. Continue with sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result. Do not poll wait_for_sign_request_ready \u2014 Join agreement may take days."
 );
 var MCP_NON_SUBMIT_TOOL_NAMES = /* @__PURE__ */ new Set([
   "ctm_uniswap_v4_quote",
@@ -2031,6 +2031,70 @@ var mcpHyperliquidUndelegateInputSchema = mcpHyperliquidMultisignInput(
   },
   preprocessHyperliquidUndelegateInput
 );
+var mcpCctpFeeFieldsSchema = z.object({
+  feeTierUsed: z.enum(["low", "med", "high"]),
+  maxFee: z.string().describe("Selected tier max fee in USDC base units (6 decimals)"),
+  maxFeeHuman: z.string().describe("Human-readable USDC max forwarding fee for feeTierUsed"),
+  forwardFeeLow: z.string(),
+  forwardFeeLowHuman: z.string(),
+  forwardFeeMed: z.string(),
+  forwardFeeMedHuman: z.string(),
+  forwardFeeHigh: z.string(),
+  forwardFeeHighHuman: z.string(),
+  transferAmount: z.string().optional(),
+  transferAmountHuman: z.string().optional(),
+  totalBurn: z.string().optional().describe("transferAmount + maxFee when transferAmountHuman was provided"),
+  totalBurnHuman: z.string().optional(),
+  feeSummary: z.string().describe("Plain-language fee summary for agents")
+});
+var mcpCctpFetchSupportedRoutesInputSchema = z.object({
+  network: z.enum(["mainnet", "testnet"]).optional().describe("Filter routes by network; omit for all")
+});
+var mcpCctpFetchSupportedRoutesOutputSchema = jsonObjectSchema.describe(
+  "{ routes: [{ sourceChainId, destChainId, sourceDomain, destDomain, sourceLabel, destLabel, network }] }"
+);
+var mcpCctpFetchBurnFeesInputSchema = z.object({
+  sourceChainId: agentEvmChainIdSchema.describe("Source chain EIP-155 id (burn chain)"),
+  destChainId: agentEvmChainIdSchema.describe("Destination chain EIP-155 id (mint chain)"),
+  transferAmountHuman: z.string().min(1).optional().describe("Human USDC amount recipient receives (6 decimals). Omit for tier fees only; include for totalBurn."),
+  feeTier: z.enum(["low", "med", "high"]).optional().describe("Iris forwardFee tier; default med")
+});
+var mcpCctpFetchBurnFeesOutputSchema = z.object({
+  sourceChainId: z.number(),
+  destChainId: z.number(),
+  sourceDomain: z.number(),
+  destDomain: z.number(),
+  sourceLabel: z.string(),
+  destLabel: z.string(),
+  network: z.enum(["mainnet", "testnet"]),
+  fees: mcpCctpFeeFieldsSchema
+}).passthrough().describe("Iris Forwarding Service fee quote with human-readable USDC amounts in fees and top-level fee fields");
+var mcpCctpFetchUsdcBalanceInputSchema = z.object({
+  chainId: agentEvmChainIdSchema.describe("Source chain to read USDC balance on"),
+  executorAddress: evmAddressSchema.optional().describe("Server-filled from keyGenId when omitted"),
+  rpcUrl: z.string().min(1).optional().describe("Server-filled from chain registry"),
+  transferAmountHuman: z.string().min(1).optional().describe("When set with feeSnapshot, returns requiredTotalBurn* and sufficientForTransfer"),
+  feeSnapshot: jsonObjectSchema.optional().describe("Output from ctm_cctp_fetch_burn_fees (uses maxFee) for balance sufficiency check")
+});
+var mcpCctpFetchUsdcBalanceOutputSchema = jsonObjectSchema.describe(
+  "{ balanceUsdcHuman, balanceRaw, usdcAddress, requiredTotalBurnHuman?, sufficientForTransfer?, feeSummary? }"
+);
+var mcpCctpFetchTransferStatusInputSchema = z.object({
+  sourceChainId: agentEvmChainIdSchema.describe("Source chain where burn was executed"),
+  sourceDomain: z.number().int().min(0).describe("CCTP domain id of source chain"),
+  burnTxHash: z.string().min(1).describe("Burn transaction hash (0x-prefixed or raw)")
+});
+var mcpCctpFetchTransferStatusOutputSchema = jsonObjectSchema.describe(
+  "{ status, attestation?, message?, eventNonce? } from Iris /v2/messages"
+);
+var mcpCctpBuildBurnMultisignInputSchema = mcpMultisignInput({
+  destChainId: agentEvmChainIdSchema.describe("Destination chain EIP-155 id (mint chain)"),
+  transferAmountHuman: z.string().min(1).describe("Human USDC amount recipient receives"),
+  mintRecipient: evmAddressSchema.optional().describe("Recipient on destination chain; defaults to MPC executor address"),
+  feeTier: z.enum(["low", "med", "high"]).optional(),
+  minFinalityThreshold: z.number().int().positive().optional(),
+  feeSnapshot: jsonObjectSchema.optional().describe("Optional output from ctm_cctp_fetch_burn_fees")
+});
 
 // src/agent/mcpProtocolTools.ts
 function defineProtocolMcpTool(def) {
@@ -2585,6 +2649,26 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     prerequisites: ["keyGen", "executorAddress", "delegation from fetch_delegations"],
     handler: { importPath: "protocols/evm/hyperliquid", exportName: "buildEvmMultisignBodyHyperliquidUndelegateBatch" },
     inputZod: mcpHyperliquidUndelegateInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_cctp_build_burn_multisign",
+    actionId: "circle-cctp.burn-forward",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Create and submit mpc-auth multiSignRequest for CCTP Forwarding Service USDC transfer (approve + depositForBurnWithHook on source chain).",
+    prerequisites: [
+      "ctm_cctp_fetch_burn_fees (required)",
+      "keyGenId",
+      "chainId = source chain",
+      "destChainId",
+      "transferAmountHuman",
+      "sufficient USDC on source"
+    ],
+    handler: {
+      importPath: "protocols/evm/circle-cctp",
+      exportName: "buildEvmMultisignBodyCctpBurnBatchFromMcp"
+    },
+    inputZod: mcpCctpBuildBurnMultisignInputSchema
   })
 ];
 
@@ -3119,6 +3203,54 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpEulerV2FetchLendVaultsInputSchema,
     outputZod: mcpEulerV2FetchLendVaultsOutputSchema
   }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_supported_routes",
+    actionId: "circle-cctp.fetch-routes",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "List supported Circle CCTP V2 Forwarding Service routes (EVM source \u2192 destination pairs on mainnet or testnet). Read-only.",
+    prerequisites: ["load_defi_protocol", "get_chain_registry"],
+    followUp: ["ctm_cctp_fetch_burn_fees"],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchSupportedRoutes" },
+    inputZod: mcpCctpFetchSupportedRoutesInputSchema,
+    outputZod: mcpCctpFetchSupportedRoutesOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_burn_fees",
+    actionId: "circle-cctp.fetch-fees",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Quote Circle Iris Forwarding Service burn fees (?forward=true) for a CCTP route. Returns human-readable USDC fee tiers and totalBurn when transferAmountHuman is set. Does NOT create a sign request.",
+    prerequisites: ["supported route (ctm_cctp_fetch_supported_routes)"],
+    followUp: ["ctm_cctp_fetch_usdc_balance", "ctm_cctp_build_burn_multisign"],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchBurnFeesForRoute" },
+    inputZod: mcpCctpFetchBurnFeesInputSchema,
+    outputZod: mcpCctpFetchBurnFeesOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_usdc_balance",
+    actionId: "circle-cctp.fetch-usdc-balance",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Read MPC wallet USDC balance on a CCTP source chain. Read-only.",
+    prerequisites: ["chainId (source)", "executorAddress or keyGenId"],
+    followUp: ["ctm_cctp_build_burn_multisign"],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchUsdcBalance" },
+    inputZod: mcpCctpFetchUsdcBalanceInputSchema,
+    outputZod: mcpCctpFetchUsdcBalanceOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_transfer_status",
+    actionId: "circle-cctp.fetch-status",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Poll Circle Iris for CCTP message/attestation status after source-chain burn Execute. Read-only.",
+    prerequisites: ["sourceChainId", "sourceDomain", "burnTxHash from broadcast"],
+    followUp: [],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchTransferStatus" },
+    inputZod: mcpCctpFetchTransferStatusInputSchema,
+    outputZod: mcpCctpFetchTransferStatusOutputSchema
+  }),
   defineMcpTool({
     name: "ctm_morpho_fetch_earn_vaults",
     actionId: "morpho.fetch-earn-vaults",
@@ -3186,7 +3318,7 @@ function getAgentCatalogForMcp() {
         "1. Quote (protocol-specific API if needed)",
         "2. Build protocol calldata (e.g. create_swap)",
         "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"
+        "4. sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result (do not poll wait_for_sign_request_ready \u2014 Join may take days)"
       ],
       evmSwapManualTypical: [
         "1. Quote (protocol-specific API if needed)",
@@ -3205,7 +3337,7 @@ function getAgentCatalogForMcp() {
         "1. load_defi_protocol for the target protocol",
         "2. get_defi_protocol_supported_chains / get_token_registry to pick chainId and tokens",
         "3. MCP build_* tool with keyGenId + chainId \u2192 { requestId }",
-        "4. Base MCP: wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result"
+        "4. Base MCP: sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result (no wait_for_sign_request_ready polling after submit)"
       ]
     }
   };
@@ -4090,6 +4222,185 @@ var morphoProtocolModule = {
   ]
 };
 registerProtocolModule(morphoProtocolModule);
+
+// src/protocols/evm/circle-cctp/constants.ts
+var CIRCLE_CCTP_PROTOCOL_ID = "circle-cctp";
+var TOKEN_MESSENGER_V2_MAINNET = "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+var TOKEN_MESSENGER_V2_TESTNET = "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+var CCTP_EVM_CHAINS = [
+  {
+    chainId: 1,
+    domain: 0,
+    network: "mainnet",
+    usdc: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Ethereum"
+  },
+  {
+    chainId: 43114,
+    domain: 1,
+    network: "mainnet",
+    usdc: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Avalanche"
+  },
+  {
+    chainId: 10,
+    domain: 2,
+    network: "mainnet",
+    usdc: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "OP Mainnet"
+  },
+  {
+    chainId: 42161,
+    domain: 3,
+    network: "mainnet",
+    usdc: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Arbitrum"
+  },
+  {
+    chainId: 8453,
+    domain: 6,
+    network: "mainnet",
+    usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Base"
+  },
+  {
+    chainId: 137,
+    domain: 7,
+    network: "mainnet",
+    usdc: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Polygon PoS"
+  },
+  {
+    chainId: 11155111,
+    domain: 0,
+    network: "testnet",
+    usdc: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Ethereum Sepolia"
+  },
+  {
+    chainId: 43113,
+    domain: 1,
+    network: "testnet",
+    usdc: "0x5425890298aed601595a70AB815c96711a31Bc65",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Avalanche Fuji"
+  },
+  {
+    chainId: 11155420,
+    domain: 2,
+    network: "testnet",
+    usdc: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "OP Sepolia"
+  },
+  {
+    chainId: 421614,
+    domain: 3,
+    network: "testnet",
+    usdc: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Arbitrum Sepolia"
+  },
+  {
+    chainId: 84532,
+    domain: 6,
+    network: "testnet",
+    usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Base Sepolia"
+  },
+  {
+    chainId: 80002,
+    domain: 7,
+    network: "testnet",
+    usdc: "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Polygon Amoy"
+  }
+];
+function cctpChainConfig(chainId) {
+  return CCTP_EVM_CHAINS.find((c) => c.chainId === chainId) ?? null;
+}
+function parseCctpEvmChainId(chainId) {
+  if (typeof chainId === "number") {
+    return Number.isFinite(chainId) ? chainId : Number.NaN;
+  }
+  const t = String(chainId).trim();
+  if (!t) return Number.NaN;
+  const low = t.toLowerCase();
+  if (low.startsWith("eip155:")) {
+    const n2 = Number.parseInt(t.slice("eip155:".length).trim(), 10);
+    return Number.isFinite(n2) ? n2 : Number.NaN;
+  }
+  if (low.startsWith("0x")) {
+    const n2 = Number.parseInt(t, 16);
+    return Number.isFinite(n2) ? n2 : Number.NaN;
+  }
+  const n = Number.parseInt(t, 10);
+  return Number.isFinite(n) ? n : Number.NaN;
+}
+function isCctpSourceChainSupported(chainId) {
+  const n = parseCctpEvmChainId(chainId);
+  return Number.isFinite(n) && cctpChainConfig(n) != null;
+}
+
+// src/protocols/evm/circle-cctp/index.ts
+var circleCctpProtocolModule = {
+  id: CIRCLE_CCTP_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    return isCctpSourceChainSupported(ctx.chainId);
+  },
+  isTokenSupported(token) {
+    return token.category === "evm" && token.kind === "erc20";
+  },
+  actions: [
+    {
+      id: "circle-cctp.fetch-routes",
+      protocolId: CIRCLE_CCTP_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "List supported CCTP Forwarding Service routes (EVM)",
+      commonParams: [],
+      params: {
+        network: { type: "string", required: false, description: "mainnet | testnet" }
+      }
+    },
+    {
+      id: "circle-cctp.fetch-fees",
+      protocolId: CIRCLE_CCTP_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Quote Iris Forwarding Service burn fees for a route",
+      commonParams: [],
+      params: {
+        sourceChainId: { type: "number", required: true, description: "Source EIP-155 chain id" },
+        destChainId: { type: "number", required: true, description: "Destination EIP-155 chain id" },
+        transferAmountHuman: { type: "string", required: true, description: "USDC amount recipient receives" }
+      }
+    },
+    {
+      id: "circle-cctp.burn-forward",
+      protocolId: CIRCLE_CCTP_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Burn USDC on source chain via CCTP Forwarding Service (approve + depositForBurnWithHook batch)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        sourceChainId: { type: "number", required: true, description: "Source EIP-155 chain id" },
+        destChainId: { type: "number", required: true, description: "Destination EIP-155 chain id" },
+        transferAmountHuman: { type: "string", required: true, description: "USDC amount recipient receives" },
+        mintRecipient: { type: "address", required: false, description: "Destination mint recipient (default executor)" }
+      }
+    }
+  ]
+};
+registerProtocolModule(circleCctpProtocolModule);
 var skillsDir = join(dirname(fileURLToPath(import.meta.url)), "skills");
 var SKILL_PROTOCOL_IDS = [
   "aave-v4",
@@ -4102,7 +4413,8 @@ var SKILL_PROTOCOL_IDS = [
   "sky",
   "gmx",
   "hyperliquid",
-  "morpho"
+  "morpho",
+  "circle-cctp"
 ];
 function getToolsForProtocol(protocolId) {
   return MCP_TOOL_DEFINITIONS.filter((t) => t.protocolId === protocolId);
@@ -4429,6 +4741,7 @@ registerProtocolModule(eulerV2ProtocolModule);
 registerProtocolModule(gmxProtocolModule);
 registerProtocolModule(hyperliquidProtocolModule);
 registerProtocolModule(morphoProtocolModule);
+registerProtocolModule(circleCctpProtocolModule);
 function getAgentCatalog() {
   return {
     protocols: getProtocolModules(),
@@ -4448,6 +4761,7 @@ function getAgentCatalog() {
     gmx: gmxProtocolModule,
     hyperliquid: hyperliquidProtocolModule,
     morpho: morphoProtocolModule,
+    circleCctp: circleCctpProtocolModule,
     /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
     mcp: getAgentCatalogForMcp()
   };