agent-swarm-kit 1.1.6 → 1.1.7

package/build/index.cjs

@@ -53,6 +53,7 @@ const connectionServices$1 = {
     stateConnectionService: Symbol('stateConnectionService'),
     sharedStateConnectionService: Symbol('sharedStateConnectionService'),
     policyConnectionService: Symbol('policyConnectionService'),
+    mcpConnectionService: Symbol('mcpConnectionService'),
 };
 const schemaServices$1 = {
     completionSchemaService: Symbol('completionSchemaService'),
@@ -65,6 +66,7 @@ const schemaServices$1 = {
     memorySchemaService: Symbol('memorySchemaService'),
     policySchemaService: Symbol('policySchemaService'),
     wikiSchemaService: Symbol('wikiSchemaService'),
+    mcpSchemaService: Symbol('mcpSchemaService'),
 };
 const metaServices$1 = {
     agentMetaService: Symbol('agentMetaService'),
@@ -80,6 +82,7 @@ const publicServices$1 = {
     statePublicService: Symbol('statePublicService'),
     sharedStatePublicService: Symbol('sharedStatePublicService'),
     policyPublicService: Symbol('policyPublicService'),
+    mcpPublicService: Symbol('mcpPublicService'),
 };
 const validationServices$1 = {
     agentValidationService: Symbol('agentValidationService'),
@@ -92,6 +95,7 @@ const validationServices$1 = {
     policyValidationService: Symbol('policyValidationService'),
     navigationValidationService: Symbol('navigationValidationService'),
     wikiValidationService: Symbol('wikiValidationService'),
+    mcpValidationService: Symbol('mcpValidationService'),
 };
 const TYPES = {
     ...baseServices$1,
@@ -2611,6 +2615,7 @@ class LoggerUtils {
                 stateName: "",
                 storageName: "",
                 swarmName: "",
+                mcpName: "",
             });
         });
         /**
@@ -2639,6 +2644,7 @@ class LoggerUtils {
                 stateName: "",
                 storageName: "",
                 swarmName: "",
+                mcpName: "",
             });
         });
         /**
@@ -2667,6 +2673,7 @@ class LoggerUtils {
                 stateName: "",
                 storageName: "",
                 swarmName: "",
+                mcpName: "",
             });
         });
         /**
@@ -3434,6 +3441,16 @@ class AgentSchemaService {
             if (agentSchema.tools?.some((value) => typeof value !== "string")) {
                 throw new Error(`agent-swarm agent schema validation failed: invalid tools for agentName=${agentSchema.agentName} tools=[${agentSchema.tools}]`);
             }
+            if (agentSchema.mcp && !Array.isArray(agentSchema.mcp)) {
+                throw new Error(`agent-swarm agent schema validation failed: invalid mcp for agentName=${agentSchema.agentName} mcp=${agentSchema.mcp}`);
+            }
+            if (agentSchema.mcp &&
+                agentSchema.mcp.length !== new Set(agentSchema.mcp).size) {
+                throw new Error(`agent-swarm agent schema validation failed: found duplicate mcp for agentName=${agentSchema.agentName} mcp=[${agentSchema.mcp}]`);
+            }
+            if (agentSchema.mcp?.some((value) => typeof value !== "string")) {
+                throw new Error(`agent-swarm agent schema validation failed: invalid mcp for agentName=${agentSchema.agentName} mcp=[${agentSchema.mcp}]`);
+            }
         };
         /**
          * Registers a new agent schema in the registry after validation.
@@ -3579,6 +3596,51 @@ const createToolCall = async (idx, tool, toolCalls, targetFn, self) => {
         self._toolErrorSubject.next(TOOL_ERROR_SYMBOL);
     }
 };
+/**
+ * Maps an MCP (Model-Context-Protocol) tool definition to an `IAgentTool` object.
+ * This function transforms the MCP tool's schema and properties into a format compatible with the agent's tool system.
+ * It also defines the tool's behavior, including its call method and parameter validation.
+ *
+ * @param {Object} tool - The MCP tool definition containing its name, description, and input schema.
+ * @param {string} tool.name - The name of the MCP tool.
+ * @param {string} [tool.description=tool.name] - A description of the MCP tool. Defaults to the tool's name if not provided.
+ * @param {Object} [tool.inputSchema] - The input schema for the MCP tool, defining its parameters and validation rules.
+ * @param {Object} [tool.inputSchema.properties] - The properties of the input schema, where each key represents a parameter.
+ * @param {string[]} [tool.inputSchema.required] - An array of required parameter names for the tool.
+ * @param {ClientAgent} self - The `ClientAgent` instance, providing context such as the agent's name, client ID, and logger.
+ *
+ * @returns {IAgentTool} An object representing the mapped tool, including its name, type, function definition, and call behavior.
+ */
+const mapMcpToolCall = ({ name, description = name, inputSchema }, self) => {
+    const mcpProperties = inputSchema
+        ? inputSchema.properties ?? {}
+        : {};
+    return {
+        toolName: `mcp_${name}`,
+        type: "function",
+        function: {
+            name,
+            description,
+            parameters: {
+                type: "object",
+                properties: Object.entries(mcpProperties).reduce((acm, [key, { type, description = type, enum: e }]) => ({
+                    ...acm,
+                    [key]: {
+                        type,
+                        description,
+                        enum: e,
+                    },
+                }), {}),
+                required: inputSchema.required,
+            },
+        },
+        call: async (dto) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+                self.params.logger.debug(`ClientAgent agentName=${self.params.agentName} clientId=${self.params.clientId} calling MCP tool toolName=${name}`);
+            await self.params.mcp.callTool(name, dto);
+        },
+    };
+};
 /**
  * Runs a stateless completion for the incoming message, returning the transformed result.
  * Returns an empty string if tool calls are present or validation fails, avoiding further processing.
@@ -3604,7 +3666,7 @@ const RUN_FN = async (incoming, self) => {
         agentName: self.params.agentName,
         messages,
         mode: "user",
-        tools: self.params.tools?.map((t) => lodashEs.omit(t, "toolName", "docNote", "call", "validate", "callbacks")),
+        tools: [],
     };
     const rawMessage = await self.params.completion.getCompletion(args);
     self.params.completion.callbacks?.onComplete &&
@@ -3660,7 +3722,8 @@ const EXECUTE_FN = async (incoming, mode, self) => {
         agentName: self.params.agentName,
         content: incoming.trim(),
     });
-    const rawMessage = await self.getCompletion(mode);
+    const toolList = await self._resolveTools();
+    const rawMessage = await self.getCompletion(mode, toolList);
     const message = await self.params.map(rawMessage, self.params.clientId, self.params.agentName);
     if (message.tool_calls?.length) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
@@ -3679,10 +3742,10 @@ const EXECUTE_FN = async (incoming, mode, self) => {
         const [runAwaiter, { resolve: run }] = functoolsKit.createAwaiter();
         for (let idx = 0; idx !== toolCalls.length; idx++) {
             const tool = toolCalls[idx];
-            const targetFn = self.params.tools?.find((t) => t.function.name === tool.function.name);
+            const targetFn = toolList.find((t) => t.function.name === tool.function.name);
             if (!targetFn) {
                 GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
-                    self.params.logger.debug(`ClientAgent agentName=${self.params.agentName} clientId=${self.params.clientId} functionName=${tool.function.name} tool function not found`, self.params.tools);
+                    self.params.logger.debug(`ClientAgent agentName=${self.params.agentName} clientId=${self.params.clientId} functionName=${tool.function.name} tool function not found`, toolList);
                 const result = await self._resurrectModel(mode, `No target function for ${tool.function.name}`);
                 GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
                     self.params.logger.debug(`ClientAgent agentName=${self.params.agentName} clientId=${self.params.clientId} execute end result=${result}`);
@@ -3887,6 +3950,33 @@ class ClientAgent {
             });
         this.params.onInit && this.params.onInit(params.clientId, params.agentName);
     }
+    async _resolveTools() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} _resolveTools`);
+        const seen = new Set();
+        const agentToolList = this.params.tools
+            ? this.params.tools
+            : [];
+        const mcpToolList = await this.params.mcp.listTools(this.params.clientId);
+        if (mcpToolList.length) {
+            return agentToolList
+                .concat(mcpToolList.map((tool) => mapMcpToolCall(tool, this)))
+                .filter(({ function: { name } }) => {
+                if (!seen.has(name)) {
+                    seen.add(name);
+                    return true;
+                }
+                return false;
+            });
+        }
+        return agentToolList.filter(({ function: { name } }) => {
+            if (!seen.has(name)) {
+                seen.add(name);
+                return true;
+            }
+            return false;
+        });
+    }
     /**
      * Resolves the system prompt by combining static and dynamic system messages.
      * Static messages are directly included from the `systemStatic` parameter, while dynamic messages
@@ -4013,7 +4103,7 @@ class ClientAgent {
             await this._resqueSubject.next(MODEL_RESQUE_SYMBOL);
             return placeholder;
         }
-        const rawMessage = await this.getCompletion(mode);
+        const rawMessage = await this.getCompletion(mode, []);
         if (rawMessage.tool_calls?.length) {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
                 this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} _resurrectModel should not emit tool_calls`);
@@ -4066,7 +4156,7 @@ class ClientAgent {
      * @param {ExecutionMode} mode - The execution mode (e.g., "user" or "tool"), determining context.
      * @returns {Promise<IModelMessage>} The completion message from the model, with content defaulted to an empty string if null.
      */
-    async getCompletion(mode) {
+    async getCompletion(mode, tools) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} getCompletion`);
         const messages = await this.params.history.toArrayForAgent(this.params.prompt ?? "", await this._resolveSystemPrompt());
@@ -4075,7 +4165,7 @@ class ClientAgent {
             agentName: this.params.agentName,
             messages,
             mode,
-            tools: this.params.tools?.map((t) => lodashEs.omit(t, "toolName", "docNote", "call", "validate", "callbacks")),
+            tools: tools.map((t) => lodashEs.omit(t, "toolName", "docNote", "call", "validate", "callbacks")),
         };
         const output = await this.params.completion.getCompletion(args);
         if (GLOBAL_CONFIG.CC_RESQUE_STRATEGY === "flush") {
@@ -4119,7 +4209,7 @@ class ClientAgent {
                 agentName: this.params.agentName,
                 messages,
                 mode,
-                tools: this.params.tools?.map((t) => lodashEs.omit(t, "toolName", "docNote", "call", "validate", "callbacks")),
+                tools: tools.map((t) => lodashEs.omit(t, "toolName", "docNote", "call", "validate", "callbacks")),
             };
             const output = await this.params.completion.getCompletion(args);
             this.params.completion.callbacks?.onComplete &&
@@ -4557,6 +4647,84 @@ class ClientOperator {
     }
 }
 
+class NoopMCP {
+    constructor(agentName) {
+        this.agentName = agentName;
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP CTOR agentName=${agentName}`);
+    }
+    async listTools(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP listTools agentName=${this.agentName}`, {
+                clientId,
+            });
+        return [];
+    }
+    hasTool(toolName, clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP hasTool agentName=${this.agentName}`, {
+                toolName,
+                clientId,
+            });
+        return Promise.resolve(false);
+    }
+    async callTool(toolName, dto) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP callTool agentName=${this.agentName}`, {
+                toolName,
+                dto,
+            });
+        throw new Error(`NoopPolicy callTool should not be called agentName=${this.agentName} toolName=${toolName}`);
+    }
+}
+class MergeMCP {
+    constructor(mcpList, agentName) {
+        this.mcpList = mcpList;
+        this.agentName = agentName;
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP CTOR agentName=${agentName}`, {
+                mcpList,
+            });
+    }
+    async listTools(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP listTools agentName=${this.agentName}`, {
+                clientId,
+            });
+        const toolList = [];
+        for (const mcp of this.mcpList) {
+            toolList.push(await mcp.listTools(clientId));
+        }
+        return toolList.flatMap((tools) => tools);
+    }
+    async hasTool(toolName, clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP hasTool agentName=${this.agentName}`, {
+                toolName,
+                clientId,
+            });
+        for (const mcp of this.mcpList) {
+            if (await mcp.hasTool(toolName, clientId)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async callTool(toolName, dto) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP callTool agentName=${this.agentName}`, {
+                toolName,
+                dto,
+            });
+        for (const mcp of this.mcpList) {
+            if (await mcp.hasTool(toolName, dto.clientId)) {
+                return await mcp.callTool(toolName, dto);
+            }
+        }
+        throw new Error(`MergeMCP callTool agentName=${this.agentName} tool not found toolName=${toolName}`);
+    }
+}
+
 /**
  * Service class for managing agent connections and operations in the swarm system.
  * Implements IAgent to provide an interface for agent instantiation, execution, message handling, and lifecycle management.
@@ -4637,6 +4805,13 @@ class AgentConnectionService {
          * @private
          */
         this.completionSchemaService = inject(TYPES.completionSchemaService);
+        /**
+         * MCP connection service instance, injected via DI, for retrieving external tools
+         * Provides mcp integration logic to ClientAgent in getAgent, supporting agent tool execution.
+         * @type {CompletionSchemaService}
+         * @private
+         */
+        this.mcpConnectionService = inject(TYPES.mcpConnectionService);
         /**
          * Retrieves or creates a memoized ClientAgent instance for a given client and agent.
          * Uses functools-kit’s memoize to cache instances by a composite key (clientId-agentName), ensuring efficient reuse across calls.
@@ -4647,7 +4822,7 @@ class AgentConnectionService {
          * @returns {ClientAgent} The memoized ClientAgent instance configured for the client and agent.
          */
         this.getAgent = functoolsKit.memoize(([clientId, agentName]) => `${clientId}-${agentName}`, (clientId, agentName) => {
-            const { prompt, system, operator, systemStatic = system, systemDynamic, tools, transform = GLOBAL_CONFIG.CC_AGENT_OUTPUT_TRANSFORM, map = GLOBAL_CONFIG.CC_AGENT_OUTPUT_MAP, maxToolCalls = GLOBAL_CONFIG.CC_MAX_TOOL_CALLS, mapToolCalls = GLOBAL_CONFIG.CC_AGENT_MAP_TOOLS, callbacks, storages, states, connectOperator = GLOBAL_CONFIG.CC_DEFAULT_CONNECT_OPERATOR, completion: completionName, validate = validateDefault, } = this.agentSchemaService.get(agentName);
+            const { prompt, system, operator, systemStatic = system, systemDynamic, tools, transform = GLOBAL_CONFIG.CC_AGENT_OUTPUT_TRANSFORM, map = GLOBAL_CONFIG.CC_AGENT_OUTPUT_MAP, maxToolCalls = GLOBAL_CONFIG.CC_MAX_TOOL_CALLS, mapToolCalls = GLOBAL_CONFIG.CC_AGENT_MAP_TOOLS, callbacks, storages, states, mcp, connectOperator = GLOBAL_CONFIG.CC_DEFAULT_CONNECT_OPERATOR, completion: completionName, validate = validateDefault, } = this.agentSchemaService.get(agentName);
             const history = this.historyConnectionService.getHistory(clientId, agentName);
             this.sessionValidationService.addAgentUsage(clientId, agentName);
             storages?.forEach((storageName) => this.storageConnectionService
@@ -4675,6 +4850,9 @@ class AgentConnectionService {
                 mapToolCalls,
                 logger: this.loggerService,
                 bus: this.busService,
+                mcp: mcp
+                    ? new MergeMCP(mcp.map(this.mcpConnectionService.getMCP), agentName)
+                    : new NoopMCP(agentName),
                 history,
                 prompt,
                 systemStatic,
@@ -4840,7 +5018,7 @@ class AgentConnectionService {
 }
 
 /** @private Constant defining the method name for logging purposes */
-const METHOD_NAME$1b = "function.common.getPayload";
+const METHOD_NAME$1d = "function.common.getPayload";
 /**
  * Retrieves the payload from the current PayloadContextService context.
  * Returns null if no context is available. Logs the operation if logging is enabled.
@@ -4851,7 +5029,7 @@ const METHOD_NAME$1b = "function.common.getPayload";
  * console.log(payload); // { id: number } or null
  */
 const getPayload = () => {
-    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$1b);
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$1d);
     if (PayloadContextService.hasContext()) {
         const { payload } = swarm$1.payloadContextService.context;
         return payload;
@@ -7129,6 +7307,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7161,6 +7340,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7191,6 +7371,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7219,6 +7400,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7251,6 +7433,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7281,6 +7464,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7311,6 +7495,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7342,6 +7527,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7370,6 +7556,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7398,6 +7585,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7426,6 +7614,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7454,6 +7643,7 @@ class AgentPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -7509,6 +7699,7 @@ class HistoryPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7537,6 +7728,7 @@ class HistoryPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7566,6 +7758,7 @@ class HistoryPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7594,6 +7787,7 @@ class HistoryPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7621,6 +7815,7 @@ class HistoryPublicService {
                 swarmName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -7696,6 +7891,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7726,6 +7922,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7757,6 +7954,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7786,6 +7984,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7868,6 +8067,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7898,6 +8098,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7928,6 +8129,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7959,6 +8161,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -7986,6 +8189,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8013,6 +8217,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8041,6 +8246,7 @@ class SessionPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -8096,6 +8302,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8123,6 +8330,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8150,6 +8358,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8178,6 +8387,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8206,6 +8416,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8233,6 +8444,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8265,6 +8477,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8295,6 +8508,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -8323,6 +8537,7 @@ class SwarmPublicService {
                 agentName: "",
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -8362,6 +8577,14 @@ class AgentValidationService {
          * @readonly
          */
         this.wikiValidationService = inject(TYPES.wikiValidationService);
+        /**
+         * MCP validation service instance for validating mcp associated with agents.
+         * Injected via DI, used in validate method to check agent mcp list.
+         * @type {WikiValidationService}
+         * @private
+         * @readonly
+         */
+        this.mcpValidationService = inject(TYPES.mcpValidationService);
         /**
          * Completion validation service instance for validating completion configurations of agents.
          * Injected via DI, used in validate method to check agent completion.
@@ -8589,6 +8812,12 @@ class AgentValidationService {
                 }
                 this.wikiValidationService.validate(wikiName, source);
             });
+            agent.mcp?.forEach((mcpName) => {
+                if (typeof mcpName !== "string") {
+                    throw new Error(`agent-swarm agent ${agentName} mcp list is invalid (mcpName=${String(mcpName)}) source=${source}`);
+                }
+                this.mcpValidationService.validate(mcpName, source);
+            });
         });
     }
 }
@@ -10195,6 +10424,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -10224,6 +10454,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -10253,6 +10484,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -10283,6 +10515,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -10312,6 +10545,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -10340,6 +10574,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -10367,6 +10602,7 @@ class StoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -11008,6 +11244,7 @@ class StatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
         /**
@@ -11036,6 +11273,7 @@ class StatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
         /**
@@ -11063,6 +11301,7 @@ class StatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
         /**
@@ -11091,6 +11330,7 @@ class StatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
     }
@@ -11815,7 +12055,7 @@ class DocService {
                 result.push("```");
                 result.push("");
             }
-            if (agentSchema.system) {
+            if (agentSchema.systemStatic) {
                 result.push(`## System prompt`);
                 result.push("");
                 for (let i = 0; i !== agentSchema.system.length; i++) {
@@ -11826,6 +12066,10 @@ class DocService {
                     result.push("");
                 }
             }
+            if (agentSchema.systemDynamic) {
+                result.push("***Dynamic system prompt found***");
+                result.push("");
+            }
             if (agentSchema.dependsOn) {
                 result.push(`## Depends on`);
                 result.push("");
@@ -12433,6 +12677,7 @@ class SharedStatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12459,6 +12704,7 @@ class SharedStatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12484,6 +12730,7 @@ class SharedStatePublicService {
                 agentName: "",
                 swarmName: "",
                 storageName: "",
+                mcpName: "",
             });
         };
     }
@@ -12541,6 +12788,7 @@ class SharedStoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12568,6 +12816,7 @@ class SharedStoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12595,6 +12844,7 @@ class SharedStoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12623,6 +12873,7 @@ class SharedStoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12650,6 +12901,7 @@ class SharedStoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -12676,6 +12928,7 @@ class SharedStoragePublicService {
                 agentName: "",
                 swarmName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -13518,6 +13771,7 @@ class PolicyPublicService {
                 policyName,
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -13548,6 +13802,7 @@ class PolicyPublicService {
                 policyName,
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -13580,6 +13835,7 @@ class PolicyPublicService {
                 policyName,
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -13612,6 +13868,7 @@ class PolicyPublicService {
                 policyName,
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -13642,6 +13899,7 @@ class PolicyPublicService {
                 policyName,
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
         /**
@@ -13672,6 +13930,7 @@ class PolicyPublicService {
                 policyName,
                 storageName: "",
                 stateName: "",
+                mcpName: "",
             });
         };
     }
@@ -14385,6 +14644,239 @@ class WikiValidationService {
     }
 }
 
+class ClientMCP {
+    constructor(params) {
+        this.params = params;
+        this.fetchTools = functoolsKit.memoize(([clientId]) => `${clientId}`, async (clientId) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+                this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} fetchTools`, {
+                    clientId,
+                });
+            const toolList = await this.params.listTools(clientId);
+            return new Map(toolList.map((tool) => [tool.name, tool]));
+        });
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} CTOR`, {
+                params,
+            });
+        if (this.params.callbacks?.onInit) {
+            this.params.callbacks.onInit();
+        }
+    }
+    async listTools(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} listTools`, {
+                clientId,
+            });
+        if (this.params.callbacks?.onList) {
+            this.params.callbacks.onList(clientId);
+        }
+        const toolMap = await this.fetchTools(clientId);
+        return Array.from(toolMap.values());
+    }
+    async hasTool(toolName, clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} hasTool`, {
+                toolName,
+                clientId,
+            });
+        const toolMap = await this.fetchTools(clientId);
+        return toolMap.has(toolName);
+    }
+    async callTool(toolName, dto) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} callTool`, {
+                toolName,
+                dto,
+            });
+        if (this.params.callbacks?.onCall) {
+            this.params.callbacks.onCall(toolName, dto);
+        }
+        return await this.params.callTool(toolName, dto);
+    }
+    dispose(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} dispose`, {
+                clientId,
+            });
+        this.fetchTools.clear(clientId);
+        if (this.params.callbacks?.onDispose) {
+            this.params.callbacks.onDispose(clientId);
+        }
+    }
+}
+
+class MCPConnectionService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.busService = inject(TYPES.busService);
+        this.methodContextService = inject(TYPES.methodContextService);
+        this.mcpSchemaService = inject(TYPES.mcpSchemaService);
+        this.getMCP = functoolsKit.memoize(([mcpName]) => `${mcpName}`, (mcpName) => {
+            const schema = this.mcpSchemaService.get(mcpName);
+            return new ClientMCP({
+                mcpName,
+                bus: this.busService,
+                logger: this.loggerService,
+                ...schema,
+            });
+        });
+    }
+    async listTools(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService listTools`, {
+                clientId,
+            });
+        return await this.getMCP(this.methodContextService.context.mcpName).listTools(clientId);
+    }
+    async hasTool(toolName, clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService hasTool`, {
+                toolName,
+                clientId,
+            });
+        return await this.getMCP(this.methodContextService.context.mcpName).hasTool(toolName, clientId);
+    }
+    async callTool(toolName, dto) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService hasTool`, {
+                toolName,
+                dto,
+            });
+        return await this.getMCP(this.methodContextService.context.mcpName).callTool(toolName, dto);
+    }
+}
+
+class MCPSchemaService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.registry = new functoolsKit.ToolRegistry("mcpSchemaService");
+        this.validateShallow = (mcpSchema) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`mcpSchemaService validateShallow`, {
+                    mcpSchema,
+                });
+            if (typeof mcpSchema.mcpName !== "string") {
+                throw new Error(`agent-swarm mcp schema validation failed: missing mcpName`);
+            }
+            if (typeof mcpSchema.callTool !== "function") {
+                throw new Error(`agent-swarm mcp schema validation failed: callTool must be provided mcpName=${mcpSchema.mcpName}`);
+            }
+            if (typeof mcpSchema.listTools !== "function") {
+                throw new Error(`agent-swarm mcp schema validation failed: listTools must be provided mcpName=${mcpSchema.mcpName}`);
+            }
+        };
+        this.register = (key, value) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`mcpSchemaService register`, { key });
+            this.validateShallow(value);
+            this.registry = this.registry.register(key, value);
+        };
+        this.override = (key, value) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`mcpSchemaService override`, { key });
+            this.registry = this.registry.override(key, value);
+            return this.registry.get(key);
+        };
+        this.get = (key) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`mcpSchemaService get`, { key });
+            return this.registry.get(key);
+        };
+    }
+}
+
+class MCPPublicService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.mcpConnectionService = inject(TYPES.mcpConnectionService);
+    }
+    async listTools(methodName, clientId, mcpName) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService listTools`, {
+                clientId,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.listTools(clientId);
+        }, {
+            methodName,
+            clientId,
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+        });
+    }
+    async hasTool(methodName, clientId, mcpName, toolName) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService hasTool`, {
+                toolName,
+                clientId,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.hasTool(toolName, clientId);
+        }, {
+            methodName,
+            clientId,
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+        });
+    }
+    async callTool(methodName, clientId, mcpName, toolName, dto) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService callTool`, {
+                toolName,
+                dto,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.callTool(toolName, dto);
+        }, {
+            methodName,
+            clientId,
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+        });
+    }
+}
+
+class MCPValidationService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this._mcpMap = new Map();
+        this.addMCP = (mcpName, mcpSchema) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("mcpValidationService addMCP", {
+                    mcpName,
+                    mcpSchema,
+                });
+            if (this._mcpMap.has(mcpName)) {
+                throw new Error(`agent-swarm mcp ${mcpName} already exist`);
+            }
+            this._mcpMap.set(mcpName, mcpSchema);
+        };
+        this.validate = functoolsKit.memoize(([mcpName]) => mcpName, (mcpName, source) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("mcpValidationService validate", {
+                    mcpName,
+                    source,
+                });
+            if (!this._mcpMap.has(mcpName)) {
+                throw new Error(`agent-swarm mcp ${mcpName} not found source=${source}`);
+            }
+        });
+    }
+}
+
 {
     provide(TYPES.docService, () => new DocService());
     provide(TYPES.busService, () => new BusService());
@@ -14407,6 +14899,7 @@ class WikiValidationService {
     provide(TYPES.stateConnectionService, () => new StateConnectionService());
     provide(TYPES.sharedStateConnectionService, () => new SharedStateConnectionService());
     provide(TYPES.policyConnectionService, () => new PolicyConnectionService());
+    provide(TYPES.mcpConnectionService, () => new MCPConnectionService());
 }
 {
     provide(TYPES.agentSchemaService, () => new AgentSchemaService());
@@ -14419,6 +14912,7 @@ class WikiValidationService {
     provide(TYPES.memorySchemaService, () => new MemorySchemaService());
     provide(TYPES.policySchemaService, () => new PolicySchemaService());
     provide(TYPES.wikiSchemaService, () => new WikiSchemaService());
+    provide(TYPES.mcpSchemaService, () => new MCPSchemaService());
 }
 {
     provide(TYPES.agentPublicService, () => new AgentPublicService());
@@ -14430,6 +14924,7 @@ class WikiValidationService {
     provide(TYPES.statePublicService, () => new StatePublicService());
     provide(TYPES.sharedStatePublicService, () => new SharedStatePublicService());
     provide(TYPES.policyPublicService, () => new PolicyPublicService());
+    provide(TYPES.mcpPublicService, () => new MCPPublicService());
 }
 {
     provide(TYPES.swarmMetaService, () => new SwarmMetaService());
@@ -14446,6 +14941,7 @@ class WikiValidationService {
     provide(TYPES.policyValidationService, () => new PolicyValidationService());
     provide(TYPES.navigationValidationService, () => new NavigationValidationService());
     provide(TYPES.wikiValidationService, () => new WikiValidationService());
+    provide(TYPES.mcpValidationService, () => new MCPValidationService());
 }
 
 const baseServices = {
@@ -14470,6 +14966,7 @@ const connectionServices = {
     stateConnectionService: inject(TYPES.stateConnectionService),
     sharedStateConnectionService: inject(TYPES.sharedStateConnectionService),
     policyConnectionService: inject(TYPES.policyConnectionService),
+    mcpConnectionService: inject(TYPES.mcpConnectionService),
 };
 const schemaServices = {
     agentSchemaService: inject(TYPES.agentSchemaService),
@@ -14482,6 +14979,7 @@ const schemaServices = {
     memorySchemaService: inject(TYPES.memorySchemaService),
     policySchemaService: inject(TYPES.policySchemaService),
     wikiSchemaService: inject(TYPES.wikiSchemaService),
+    mcpSchemaService: inject(TYPES.mcpSchemaService),
 };
 const publicServices = {
     agentPublicService: inject(TYPES.agentPublicService),
@@ -14493,6 +14991,7 @@ const publicServices = {
     statePublicService: inject(TYPES.statePublicService),
     sharedStatePublicService: inject(TYPES.sharedStatePublicService),
     policyPublicService: inject(TYPES.policyPublicService),
+    mcpPublicService: inject(TYPES.mcpPublicService),
 };
 const metaServices = {
     agentMetaService: inject(TYPES.agentMetaService),
@@ -14509,6 +15008,7 @@ const validationServices = {
     policyValidationService: inject(TYPES.policyValidationService),
     navigationValidationService: inject(TYPES.navigationValidationService),
     wikiValidationService: inject(TYPES.wikiValidationService),
+    mcpValidationService: inject(TYPES.mcpValidationService),
 };
 /** @inheritDoc */
 const swarm = {
@@ -14523,7 +15023,7 @@ const swarm = {
 init();
 var swarm$1 = swarm;
 
-const METHOD_NAME$1a = "cli.dumpDocs";
+const METHOD_NAME$1c = "cli.dumpDocs";
 /**
  * Dumps the documentation for the agents and swarms.
  *
@@ -14533,7 +15033,7 @@ const METHOD_NAME$1a = "cli.dumpDocs";
  */
 const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantUML) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$1a, {
+        swarm$1.loggerService.log(METHOD_NAME$1c, {
             dirName,
         });
     if (PlantUML) {
@@ -14543,10 +15043,10 @@ const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantU
     }
     swarm$1.agentValidationService
         .getAgentList()
-        .forEach((agentName) => swarm$1.agentValidationService.validate(agentName, METHOD_NAME$1a));
+        .forEach((agentName) => swarm$1.agentValidationService.validate(agentName, METHOD_NAME$1c));
     swarm$1.swarmValidationService
         .getSwarmList()
-        .forEach((swarmName) => swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$1a));
+        .forEach((swarmName) => swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$1c));
     swarm$1.agentValidationService.getAgentList().forEach((agentName) => {
         const { dependsOn } = swarm$1.agentSchemaService.get(agentName);
         if (!dependsOn) {
@@ -14556,7 +15056,7 @@ const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantU
     return swarm$1.docService.dumpDocs(prefix, dirName);
 });
 
-const METHOD_NAME$19 = "cli.dumpAgent";
+const METHOD_NAME$1b = "cli.dumpAgent";
 /**
  * Dumps the agent information into PlantUML format.
  *
@@ -14565,14 +15065,14 @@ const METHOD_NAME$19 = "cli.dumpAgent";
  */
 const dumpAgent = beginContext((agentName, { withSubtree = false } = {}) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$19, {
+        swarm$1.loggerService.log(METHOD_NAME$1b, {
             agentName,
         });
-    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$19);
+    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$1b);
     return swarm$1.agentMetaService.toUML(agentName, withSubtree);
 });
 
-const METHOD_NAME$18 = "cli.dumpSwarm";
+const METHOD_NAME$1a = "cli.dumpSwarm";
 /**
  * Dumps the swarm information into PlantUML format.
  *
@@ -14581,14 +15081,14 @@ const METHOD_NAME$18 = "cli.dumpSwarm";
  */
 const dumpSwarm = beginContext((swarmName) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$18, {
+        swarm$1.loggerService.log(METHOD_NAME$1a, {
             swarmName,
         });
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$18);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$1a);
     return swarm$1.swarmMetaService.toUML(swarmName);
 });
 
-const METHOD_NAME$17 = "cli.dumpPerfomance";
+const METHOD_NAME$19 = "cli.dumpPerfomance";
 const METHOD_NAME_INTERNAL$1 = "cli.dumpPerfomance.internal";
 const METHOD_NAME_INTERVAL = "cli.dumpPerfomance.interval";
 /**
@@ -14607,7 +15107,7 @@ const dumpPerfomanceInternal = beginContext(async (dirName = "./logs/meta") => {
  * @returns {Promise<void>} A promise that resolves when the performance data has been dumped.
  */
 const dumpPerfomance = async (dirName = "./logs/meta") => {
-    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$17);
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$19);
     await dumpPerfomanceInternal(dirName);
 };
 /**
@@ -14665,7 +15165,7 @@ const listenExecutionEvent = beginContext((clientId, fn) => {
     return swarm$1.busService.subscribe(clientId, "execution-bus", functoolsKit.queued(async (e) => await fn(e)));
 });
 
-const METHOD_NAME$16 = "cli.dumpClientPerformance";
+const METHOD_NAME$18 = "cli.dumpClientPerformance";
 const METHOD_NAME_INTERNAL = "cli.dumpClientPerformance.internal";
 const METHOD_NAME_EXECUTE = "cli.dumpClientPerformance.execute";
 /**
@@ -14689,7 +15189,7 @@ const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = ".
  * @returns {Promise<void>} A promise that resolves when the performance data has been dumped.
  */
 const dumpClientPerformance = async (clientId, dirName = "./logs/client") => {
-    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$16);
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$18);
     await dumpClientPerformanceInternal(clientId, dirName);
 };
 /**
@@ -14710,7 +15210,7 @@ dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./logs/cl
 });
 
 /** @private Constant defining the method name for logging and validation context */
-const METHOD_NAME$15 = "function.commit.commitFlushForce";
+const METHOD_NAME$17 = "function.commit.commitFlushForce";
 /**
  * Forcefully commits a flush of agent history for a specific client in the swarm system, without checking the active agent.
  * Validates the session and swarm, then proceeds with flushing the history regardless of the current agent state.
@@ -14728,20 +15228,20 @@ const METHOD_NAME$15 = "function.commit.commitFlushForce";
 const commitFlushForce = beginContext(async (clientId) => {
     // Log the flush attempt if enabled
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$15, {
+        swarm$1.loggerService.log(METHOD_NAME$17, {
             clientId,
-            METHOD_NAME: METHOD_NAME$15,
+            METHOD_NAME: METHOD_NAME$17,
         });
     // Validate the session exists and retrieve the associated swarm
-    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$15);
+    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$17);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
     // Validate the swarm configuration
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$15);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$17);
     // Commit the flush of agent history via SessionPublicService without agent checks
-    await swarm$1.sessionPublicService.commitFlush(METHOD_NAME$15, clientId, swarmName);
+    await swarm$1.sessionPublicService.commitFlush(METHOD_NAME$17, clientId, swarmName);
 });
 
-const METHOD_NAME$14 = "function.commit.commitToolOutputForce";
+const METHOD_NAME$16 = "function.commit.commitToolOutputForce";
 /**
  * Commits the output of a tool execution to the active agent in a swarm session without checking the active agent.
  *
@@ -14760,24 +15260,24 @@ const METHOD_NAME$14 = "function.commit.commitToolOutputForce";
 const commitToolOutputForce = beginContext(async (toolId, content, clientId) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$14, {
+        swarm$1.loggerService.log(METHOD_NAME$16, {
             toolId,
             content,
             clientId,
         });
     // Validate the session and swarm to ensure they exist and are accessible
-    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$14);
+    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$16);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$14);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$16);
     // Commit the tool output to the session via the session public service without checking the active agent
-    await swarm$1.sessionPublicService.commitToolOutput(toolId, content, METHOD_NAME$14, clientId, swarmName);
+    await swarm$1.sessionPublicService.commitToolOutput(toolId, content, METHOD_NAME$16, clientId, swarmName);
 });
 
 /**
  * @private Constant defining the method name for logging and validation purposes.
  * Used as an identifier in log messages and validation checks to track calls to `hasNavigation`.
  */
-const METHOD_NAME$13 = "function.common.hasNavigation";
+const METHOD_NAME$15 = "function.common.hasNavigation";
 /**
  * Checks if a specific agent is part of the navigation route for a given client.
  * Validates the agent and client session, retrieves the associated swarm, and queries the navigation route.
@@ -14788,16 +15288,16 @@ const METHOD_NAME$13 = "function.common.hasNavigation";
  */
 const hasNavigation = async (clientId, agentName) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$13, { clientId });
-    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$13);
-    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$13);
+        swarm$1.loggerService.log(METHOD_NAME$15, { clientId });
+    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$15);
+    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$15);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
     return swarm$1.navigationValidationService
         .getNavigationRoute(clientId, swarmName)
         .has(agentName);
 };
 
-const METHOD_NAME$12 = "function.history.getRawHistory";
+const METHOD_NAME$14 = "function.history.getRawHistory";
 /**
  * Retrieves the raw, unmodified history for a given client session.
  *
@@ -14814,10 +15314,10 @@ const METHOD_NAME$12 = "function.history.getRawHistory";
  * const rawHistory = await getRawHistory("client-123");
  * console.log(rawHistory); // Outputs the full raw history array
  */
-const getRawHistory = beginContext(async (clientId, methodName = METHOD_NAME$12) => {
+const getRawHistory = beginContext(async (clientId, methodName = METHOD_NAME$14) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$12, {
+        swarm$1.loggerService.log(METHOD_NAME$14, {
             clientId,
         });
     // Validate the session and swarm
@@ -14830,7 +15330,7 @@ const getRawHistory = beginContext(async (clientId, methodName = METHOD_NAME$12)
     return [...history];
 });
 
-const METHOD_NAME$11 = "function.history.getLastUserMessage";
+const METHOD_NAME$13 = "function.history.getLastUserMessage";
 /**
  * Retrieves the content of the most recent user message from a client's session history.
  *
@@ -14848,16 +15348,16 @@ const METHOD_NAME$11 = "function.history.getLastUserMessage";
 const getLastUserMessage = beginContext(async (clientId) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$11, {
+        swarm$1.loggerService.log(METHOD_NAME$13, {
             clientId,
         });
     // Fetch raw history and find the last user message
-    const history = await getRawHistory(clientId, METHOD_NAME$11);
+    const history = await getRawHistory(clientId, METHOD_NAME$13);
     const last = history.findLast(({ role, mode }) => role === "user" && mode === "user");
     return last ? last.content : null;
 });
 
-const METHOD_NAME$10 = "function.navigate.changeToDefaultAgent";
+const METHOD_NAME$12 = "function.navigate.changeToDefaultAgent";
 /**
  * Time-to-live for the change agent function in milliseconds.
  * Defines how long the cached change agent function remains valid before expiring.
@@ -14892,7 +15392,7 @@ const createChangeToDefaultAgent = functoolsKit.ttl((clientId) => functoolsKit.q
     }));
     {
         // Dispose of the current agent's resources and set up the new default agent
-        const agentName = await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$10, clientId, swarmName);
+        const agentName = await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$12, clientId, swarmName);
         await swarm$1.agentPublicService.dispose(methodName, clientId, agentName);
         await swarm$1.historyPublicService.dispose(methodName, clientId, agentName);
         await swarm$1.swarmPublicService.setAgentRef(methodName, clientId, swarmName, agentName, await swarm$1.agentPublicService.createAgentRef(methodName, clientId, agentName));
@@ -14931,23 +15431,23 @@ const createGc$3 = functoolsKit.singleshot(async () => {
 const changeToDefaultAgent = beginContext(async (clientId) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$10, {
+        swarm$1.loggerService.log(METHOD_NAME$12, {
             clientId,
         });
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
     const { defaultAgent: agentName } = swarm$1.swarmSchemaService.get(swarmName);
     {
         // Validate session and default agent
-        swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$10);
-        swarm$1.agentValidationService.validate(agentName, METHOD_NAME$10);
+        swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$12);
+        swarm$1.agentValidationService.validate(agentName, METHOD_NAME$12);
     }
     // Execute the agent change with TTL and queuing
     const run = await createChangeToDefaultAgent(clientId);
     createGc$3();
-    return await run(METHOD_NAME$10, agentName, swarmName);
+    return await run(METHOD_NAME$12, agentName, swarmName);
 });
 
-const METHOD_NAME$$ = "function.target.emitForce";
+const METHOD_NAME$11 = "function.target.emitForce";
 /**
  * Emits a string as model output without executing an incoming message or checking the active agent.
  *
@@ -14966,19 +15466,19 @@ const METHOD_NAME$$ = "function.target.emitForce";
 const emitForce = beginContext(async (content, clientId) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$$, {
+        swarm$1.loggerService.log(METHOD_NAME$11, {
             content,
             clientId,
         });
     // Validate the session and swarm
-    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$$);
+    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$11);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$$);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$11);
     // Emit the content directly via the session public service
-    return await swarm$1.sessionPublicService.emit(content, METHOD_NAME$$, clientId, swarmName);
+    return await swarm$1.sessionPublicService.emit(content, METHOD_NAME$11, clientId, swarmName);
 });
 
-const METHOD_NAME$_ = "function.target.executeForce";
+const METHOD_NAME$10 = "function.target.executeForce";
 /**
  * Sends a message to the active agent in a swarm session as if it originated from the client side, forcing execution regardless of agent activity.
  *
@@ -14999,22 +15499,22 @@ const executeForce = beginContext(async (content, clientId) => {
     const executionId = functoolsKit.randomString();
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$_, {
+        swarm$1.loggerService.log(METHOD_NAME$10, {
             content,
             clientId,
             executionId,
         });
     // Validate the session and swarm
-    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$_);
+    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$10);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$_);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$10);
     // Execute the command within an execution context with performance tracking
     return ExecutionContextService.runInContext(async () => {
         let isFinished = false;
         swarm$1.perfService.startExecution(executionId, clientId, content.length);
         try {
             swarm$1.busService.commitExecutionBegin(clientId, { swarmName });
-            const result = await swarm$1.sessionPublicService.execute(content, "tool", METHOD_NAME$_, clientId, swarmName);
+            const result = await swarm$1.sessionPublicService.execute(content, "tool", METHOD_NAME$10, clientId, swarmName);
             isFinished = swarm$1.perfService.endExecution(executionId, clientId, result.length);
             swarm$1.busService.commitExecutionEnd(clientId, { swarmName });
             return result;
@@ -15031,7 +15531,7 @@ const executeForce = beginContext(async (content, clientId) => {
     });
 });
 
-const METHOD_NAME$Z = "function.template.navigateToTriageAgent";
+const METHOD_NAME$$ = "function.template.navigateToTriageAgent";
 const DEFAULT_ACCEPT_FN = (_, defaultAgent) => `Successfully navigated to ${defaultAgent}`;
 const DEFAULT_REJECT_FN = (_, defaultAgent) => `Already on ${defaultAgent}`;
 /**
@@ -15080,7 +15580,7 @@ const createNavigateToTriageAgent = async ({ flushMessage, executeMessage, toolO
      */
     return beginContext(async (toolId, clientId) => {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-            swarm$1.loggerService.log(METHOD_NAME$Z, {
+            swarm$1.loggerService.log(METHOD_NAME$$, {
                 clientId,
                 toolId,
             });
@@ -15110,7 +15610,7 @@ const createNavigateToTriageAgent = async ({ flushMessage, executeMessage, toolO
     });
 };
 
-const METHOD_NAME$Y = "function.navigate.changeToAgent";
+const METHOD_NAME$_ = "function.navigate.changeToAgent";
 /**
  * Time-to-live for the change agent function in milliseconds.
  * Defines how long the cached change agent function remains valid before expiring.
@@ -15146,7 +15646,7 @@ const createChangeToAgent = functoolsKit.ttl((clientId) => functoolsKit.queued(a
     }));
     {
         // Dispose of the current agent's resources and set up the new agent
-        const agentName = await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$Y, clientId, swarmName);
+        const agentName = await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$_, clientId, swarmName);
         await swarm$1.agentPublicService.dispose(methodName, clientId, agentName);
         await swarm$1.historyPublicService.dispose(methodName, clientId, agentName);
         await swarm$1.swarmPublicService.setAgentRef(methodName, clientId, swarmName, agentName, await swarm$1.agentPublicService.createAgentRef(methodName, clientId, agentName));
@@ -15186,16 +15686,16 @@ const createGc$2 = functoolsKit.singleshot(async () => {
 const changeToAgent = beginContext(async (agentName, clientId) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$Y, {
+        swarm$1.loggerService.log(METHOD_NAME$_, {
             agentName,
             clientId,
         });
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
     {
         // Validate session, agent, and dependencies
-        swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$Y);
-        swarm$1.agentValidationService.validate(agentName, METHOD_NAME$Y);
-        const activeAgent = await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$Y, clientId, swarmName);
+        swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$_);
+        swarm$1.agentValidationService.validate(agentName, METHOD_NAME$_);
+        const activeAgent = await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$_, clientId, swarmName);
         if (!swarm$1.agentValidationService.hasDependency(activeAgent, agentName)) {
             console.error(`agent-swarm missing dependency detected for activeAgent=${activeAgent} dependencyAgent=${agentName}`);
         }
@@ -15213,10 +15713,10 @@ const changeToAgent = beginContext(async (agentName, clientId) => {
     // Execute the agent change with TTL and queuing
     const run = await createChangeToAgent(clientId);
     createGc$2();
-    return await run(METHOD_NAME$Y, agentName, swarmName);
+    return await run(METHOD_NAME$_, agentName, swarmName);
 });
 
-const METHOD_NAME$X = "function.template.navigateToAgent";
+const METHOD_NAME$Z = "function.template.navigateToAgent";
 /**
  * Default tool output message indicating successful navigation to the specified agent.
  *
@@ -15281,7 +15781,7 @@ const createNavigateToAgent = async ({ executeMessage, emitMessage, flushMessage
      */
     return beginContext(async (toolId, clientId, agentName) => {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-            swarm$1.loggerService.log(METHOD_NAME$X, {
+            swarm$1.loggerService.log(METHOD_NAME$Z, {
                 clientId,
                 toolId,
             });
@@ -15314,7 +15814,7 @@ const createNavigateToAgent = async ({ executeMessage, emitMessage, flushMessage
 };
 
 /** @constant {string} METHOD_NAME - The name of the method used for logging */
-const METHOD_NAME$W = "function.setup.addWiki";
+const METHOD_NAME$Y = "function.setup.addWiki";
 /**
  * Adds a wiki schema to the system
  * @function addWiki
@@ -15323,7 +15823,7 @@ const METHOD_NAME$W = "function.setup.addWiki";
  */
 const addWiki = beginContext((wikiSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$W, {
+        swarm$1.loggerService.log(METHOD_NAME$Y, {
             wikiSchema,
         });
     swarm$1.wikiValidationService.addWiki(wikiSchema.wikiName, wikiSchema);
@@ -15331,7 +15831,7 @@ const addWiki = beginContext((wikiSchema) => {
     return wikiSchema.wikiName;
 });
 
-const METHOD_NAME$V = "function.setup.addAgent";
+const METHOD_NAME$X = "function.setup.addAgent";
 /**
  * Adds a new agent to the agent registry for use within the swarm system.
  *
@@ -15351,7 +15851,7 @@ const METHOD_NAME$V = "function.setup.addAgent";
 const addAgent = beginContext((agentSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$V, {
+        swarm$1.loggerService.log(METHOD_NAME$X, {
             agentSchema,
         });
     // Register the agent in the validation and schema services
@@ -15361,7 +15861,7 @@ const addAgent = beginContext((agentSchema) => {
     return agentSchema.agentName;
 });
 
-const METHOD_NAME$U = "function.setup.addCompletion";
+const METHOD_NAME$W = "function.setup.addCompletion";
 /**
  * Adds a completion engine to the registry for use by agents in the swarm system.
  *
@@ -15381,7 +15881,7 @@ const METHOD_NAME$U = "function.setup.addCompletion";
 const addCompletion = beginContext((completionSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$U, {
+        swarm$1.loggerService.log(METHOD_NAME$W, {
             completionSchema,
         });
     // Register the completion in the validation and schema services
@@ -15391,7 +15891,7 @@ const addCompletion = beginContext((completionSchema) => {
     return completionSchema.completionName;
 });
 
-const METHOD_NAME$T = "function.setup.addSwarm";
+const METHOD_NAME$V = "function.setup.addSwarm";
 /**
  * Adds a new swarm to the system for managing client sessions.
  *
@@ -15411,7 +15911,7 @@ const METHOD_NAME$T = "function.setup.addSwarm";
 const addSwarm = beginContext((swarmSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$T, {
+        swarm$1.loggerService.log(METHOD_NAME$V, {
             swarmSchema,
         });
     // Register the swarm in the validation and schema services
@@ -15421,7 +15921,7 @@ const addSwarm = beginContext((swarmSchema) => {
     return swarmSchema.swarmName;
 });
 
-const METHOD_NAME$S = "function.setup.addTool";
+const METHOD_NAME$U = "function.setup.addTool";
 /**
  * Adds a new tool to the tool registry for use by agents in the swarm system.
  *
@@ -15443,7 +15943,7 @@ const METHOD_NAME$S = "function.setup.addTool";
 const addTool = beginContext((toolSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$S, {
+        swarm$1.loggerService.log(METHOD_NAME$U, {
             toolSchema,
         });
     // Register the tool in the validation and schema services
@@ -15453,7 +15953,18 @@ const addTool = beginContext((toolSchema) => {
     return toolSchema.toolName;
 });
 
-const METHOD_NAME$R = "function.setup.addState";
+const METHOD_NAME$T = "function.setup.addMCP";
+const addMCP = beginContext((mcpSchema) => {
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+        swarm$1.loggerService.log(METHOD_NAME$T, {
+            mcpSchema,
+        });
+    swarm$1.mcpValidationService.addMCP(mcpSchema.mcpName, mcpSchema);
+    swarm$1.mcpSchemaService.register(mcpSchema.mcpName, mcpSchema);
+    return mcpSchema.mcpName;
+});
+
+const METHOD_NAME$S = "function.setup.addState";
 /**
  * Adds a new state to the state registry for use within the swarm system.
  *
@@ -15475,7 +15986,7 @@ const METHOD_NAME$R = "function.setup.addState";
 const addState = beginContext((stateSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$R, {
+        swarm$1.loggerService.log(METHOD_NAME$S, {
             stateSchema,
         });
     // Register the state in the schema service
@@ -15490,7 +16001,7 @@ const addState = beginContext((stateSchema) => {
     return stateSchema.stateName;
 });
 
-const METHOD_NAME$Q = "function.setup.addEmbedding";
+const METHOD_NAME$R = "function.setup.addEmbedding";
 /**
  * Adds a new embedding engine to the embedding registry for use within the swarm system.
  *
@@ -15510,7 +16021,7 @@ const METHOD_NAME$Q = "function.setup.addEmbedding";
 const addEmbedding = beginContext((embeddingSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$Q, {
+        swarm$1.loggerService.log(METHOD_NAME$R, {
             embeddingSchema,
         });
     // Register the embedding in the validation and schema services
@@ -15520,7 +16031,7 @@ const addEmbedding = beginContext((embeddingSchema) => {
     return embeddingSchema.embeddingName;
 });
 
-const METHOD_NAME$P = "function.setup.addStorage";
+const METHOD_NAME$Q = "function.setup.addStorage";
 /**
  * Adds a new storage engine to the storage registry for use within the swarm system.
  *
@@ -15542,7 +16053,7 @@ const METHOD_NAME$P = "function.setup.addStorage";
 const addStorage = beginContext((storageSchema) => {
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$P, {
+        swarm$1.loggerService.log(METHOD_NAME$Q, {
             storageSchema,
         });
     // Register the storage in the validation and schema services
@@ -15559,7 +16070,7 @@ const addStorage = beginContext((storageSchema) => {
 });
 
 /** @private Constant defining the method name for logging and validation context */
-const METHOD_NAME$O = "function.setup.addPolicy";
+const METHOD_NAME$P = "function.setup.addPolicy";
 /**
  * Adds a new policy for agents in the swarm system by registering it with validation and schema services.
  * Registers the policy with PolicyValidationService for runtime validation and PolicySchemaService for schema management.
@@ -15575,7 +16086,7 @@ const METHOD_NAME$O = "function.setup.addPolicy";
 const addPolicy = beginContext((policySchema) => {
     // Log the policy addition attempt if enabled
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$O, {
+        swarm$1.loggerService.log(METHOD_NAME$P, {
             policySchema,
         });
     // Register the policy with PolicyValidationService for runtime validation
@@ -15586,7 +16097,7 @@ const addPolicy = beginContext((policySchema) => {
     return policySchema.policyName;
 });
 
-const METHOD_NAME$N = "function.test.overrideAgent";
+const METHOD_NAME$O = "function.test.overrideAgent";
 /**
  * Overrides an existing agent schema in the swarm system with a new or partial schema.
  * This function updates the configuration of an agent identified by its `agentName`, applying the provided schema properties.
@@ -15610,13 +16121,13 @@ const METHOD_NAME$N = "function.test.overrideAgent";
  */
 const overrideAgent = beginContext((agentSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$N, {
+        swarm$1.loggerService.log(METHOD_NAME$O, {
             agentSchema,
         });
     return swarm$1.agentSchemaService.override(agentSchema.agentName, agentSchema);
 });
 
-const METHOD_NAME$M = "function.test.overrideCompletion";
+const METHOD_NAME$N = "function.test.overrideCompletion";
 /**
  * Overrides an existing completion schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a completion mechanism identified by its `completionName`, applying the provided schema properties.
@@ -15640,13 +16151,13 @@ const METHOD_NAME$M = "function.test.overrideCompletion";
  */
 const overrideCompletion = beginContext((completionSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$M, {
+        swarm$1.loggerService.log(METHOD_NAME$N, {
             completionSchema,
         });
     return swarm$1.completionSchemaService.override(completionSchema.completionName, completionSchema);
 });
 
-const METHOD_NAME$L = "function.test.overrideEmbeding";
+const METHOD_NAME$M = "function.test.overrideEmbeding";
 /**
  * Overrides an existing embedding schema in the swarm system with a new or partial schema.
  * This function updates the configuration of an embedding mechanism identified by its `embeddingName`, applying the provided schema properties.
@@ -15672,13 +16183,13 @@ const METHOD_NAME$L = "function.test.overrideEmbeding";
  */
 const overrideEmbeding = beginContext((embeddingSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$L, {
+        swarm$1.loggerService.log(METHOD_NAME$M, {
             embeddingSchema,
         });
     return swarm$1.embeddingSchemaService.override(embeddingSchema.embeddingName, embeddingSchema);
 });
 
-const METHOD_NAME$K = "function.test.overridePolicy";
+const METHOD_NAME$L = "function.test.overridePolicy";
 /**
  * Overrides an existing policy schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a policy identified by its `policyName`, applying the provided schema properties.
@@ -15702,13 +16213,13 @@ const METHOD_NAME$K = "function.test.overridePolicy";
  */
 const overridePolicy = beginContext((policySchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$K, {
+        swarm$1.loggerService.log(METHOD_NAME$L, {
             policySchema,
         });
     return swarm$1.policySchemaService.override(policySchema.policyName, policySchema);
 });
 
-const METHOD_NAME$J = "function.test.overrideState";
+const METHOD_NAME$K = "function.test.overrideState";
 /**
  * Overrides an existing state schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a state identified by its `stateName`, applying the provided schema properties.
@@ -15733,13 +16244,13 @@ const METHOD_NAME$J = "function.test.overrideState";
  */
 const overrideState = beginContext((stateSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$J, {
+        swarm$1.loggerService.log(METHOD_NAME$K, {
             stateSchema,
         });
     return swarm$1.stateSchemaService.override(stateSchema.stateName, stateSchema);
 });
 
-const METHOD_NAME$I = "function.test.overrideStorage";
+const METHOD_NAME$J = "function.test.overrideStorage";
 /**
  * Overrides an existing storage schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a storage identified by its `storageName`, applying the provided schema properties.
@@ -15765,13 +16276,13 @@ const METHOD_NAME$I = "function.test.overrideStorage";
  */
 const overrideStorage = beginContext((storageSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$I, {
+        swarm$1.loggerService.log(METHOD_NAME$J, {
             storageSchema,
         });
     return swarm$1.storageSchemaService.override(storageSchema.storageName, storageSchema);
 });
 
-const METHOD_NAME$H = "function.test.overrideSwarm";
+const METHOD_NAME$I = "function.test.overrideSwarm";
 /**
  * Overrides an existing swarm schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a swarm identified by its `swarmName`, applying the provided schema properties.
@@ -15795,13 +16306,13 @@ const METHOD_NAME$H = "function.test.overrideSwarm";
  */
 const overrideSwarm = beginContext((swarmSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$H, {
+        swarm$1.loggerService.log(METHOD_NAME$I, {
             swarmSchema,
         });
     return swarm$1.swarmSchemaService.override(swarmSchema.swarmName, swarmSchema);
 });
 
-const METHOD_NAME$G = "function.test.overrideTool";
+const METHOD_NAME$H = "function.test.overrideTool";
 /**
  * Overrides an existing tool schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a tool identified by its `toolName`, applying the provided schema properties.
@@ -15825,12 +16336,21 @@ const METHOD_NAME$G = "function.test.overrideTool";
  */
 const overrideTool = beginContext((toolSchema) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$G, {
+        swarm$1.loggerService.log(METHOD_NAME$H, {
             toolSchema,
         });
     return swarm$1.toolSchemaService.override(toolSchema.toolName, toolSchema);
 });
 
+const METHOD_NAME$G = "function.test.overrideMCP";
+const overrideMCP = beginContext((mcpSchema) => {
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+        swarm$1.loggerService.log(METHOD_NAME$G, {
+            mcpSchema,
+        });
+    return swarm$1.mcpSchemaService.override(mcpSchema.mcpName, mcpSchema);
+});
+
 const METHOD_NAME$F = "function.test.overrideWiki";
 /**
  * Overrides an existing wiki schema in the swarm system with a new or partial schema.
@@ -15887,6 +16407,7 @@ const markOnline = async (clientId, swarmName) => {
         policyName: "",
         stateName: "",
         storageName: "",
+        mcpName: "",
         swarmName,
         clientId,
     });
@@ -15919,6 +16440,7 @@ const markOffline = async (clientId, swarmName) => {
         policyName: "",
         stateName: "",
         storageName: "",
+        mcpName: "",
         swarmName,
         clientId,
     });
@@ -20113,6 +20635,7 @@ exports.Utils = Utils;
 exports.addAgent = addAgent;
 exports.addCompletion = addCompletion;
 exports.addEmbedding = addEmbedding;
+exports.addMCP = addMCP;
 exports.addPolicy = addPolicy;
 exports.addState = addState;
 exports.addStorage = addStorage;
@@ -20192,6 +20715,7 @@ exports.notifyForce = notifyForce;
 exports.overrideAgent = overrideAgent;
 exports.overrideCompletion = overrideCompletion;
 exports.overrideEmbeding = overrideEmbeding;
+exports.overrideMCP = overrideMCP;
 exports.overridePolicy = overridePolicy;
 exports.overrideState = overrideState;
 exports.overrideStorage = overrideStorage;