@mastra/server 1.79.0-alpha.10 → 1.79.0-alpha.11

package/dist/mcp-BTdLh6E_.js

@@ -0,0 +1,274 @@
+import { r as __exportAll } from "./rolldown-runtime-D3Hj5m0v.js";
+import { t as HTTPException } from "./http-exception-CyfxZB6W.js";
+import { n as createRoute } from "./route-builder-CjkWxv4E.js";
+import { a as listMcpServerToolsResponseSchema, c as listResourcesResponseSchema, d as mcpServerResourcePathParams, f as mcpServerToolPathParams, g as serverDetailSchema, h as readResourceResponseSchema, l as mcpServerDetailPathParams, m as readResourceBodySchema, n as executeToolResponseSchema, o as listMcpServersQuerySchema, p as mcpToolInfoSchema, r as getMcpServerDetailQuerySchema, s as listMcpServersResponseSchema, t as executeToolBodySchema, u as mcpServerIdPathParams } from "./mcp-DzpwLXEY.js";
+import { MastraError } from "@mastra/core/error";
+//#region src/server/handlers/mcp.ts
+var mcp_exports = /* @__PURE__ */ __exportAll({
+	EXECUTE_MCP_SERVER_TOOL_ROUTE: () => EXECUTE_MCP_SERVER_TOOL_ROUTE,
+	GET_MCP_SERVER_DETAIL_ROUTE: () => GET_MCP_SERVER_DETAIL_ROUTE,
+	GET_MCP_SERVER_TOOL_DETAIL_ROUTE: () => GET_MCP_SERVER_TOOL_DETAIL_ROUTE,
+	LIST_MCP_SERVERS_ROUTE: () => LIST_MCP_SERVERS_ROUTE,
+	LIST_MCP_SERVER_RESOURCES_ROUTE: () => LIST_MCP_SERVER_RESOURCES_ROUTE,
+	LIST_MCP_SERVER_TOOLS_ROUTE: () => LIST_MCP_SERVER_TOOLS_ROUTE,
+	MCP_HTTP_TRANSPORT_ROUTE: () => MCP_HTTP_TRANSPORT_ROUTE,
+	MCP_SSE_MESSAGES_ROUTE: () => MCP_SSE_MESSAGES_ROUTE,
+	MCP_SSE_TRANSPORT_ROUTE: () => MCP_SSE_TRANSPORT_ROUTE,
+	READ_MCP_SERVER_RESOURCE_ROUTE: () => READ_MCP_SERVER_RESOURCE_ROUTE
+});
+/**
+* Only `@mastra/mcp` 1.x servers implement the standalone HTTP+SSE transport; on a
+* 2026-07-28 server the inherited `startSSE`/`startHonoSSE` throw.
+*/
+function hasSSETransport(server) {
+	return server.mcpVersion !== 2;
+}
+function transportsOf(server) {
+	return hasSSETransport(server) ? ["streamable-http", "sse"] : ["streamable-http"];
+}
+const LIST_MCP_SERVERS_ROUTE = createRoute({
+	method: "GET",
+	path: "/mcp/v0/servers",
+	responseType: "json",
+	queryParamSchema: listMcpServersQuerySchema,
+	responseSchema: listMcpServersResponseSchema,
+	summary: "List MCP servers",
+	description: "Returns a list of registered MCP servers with pagination support",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, routePrefix, page, perPage, limit, offset }) => {
+		if (!mastra || typeof mastra.listMCPServers !== "function") throw new HTTPException(500, { message: "Mastra instance or listMCPServers method not available" });
+		const servers = mastra.listMCPServers();
+		if (!servers) return {
+			servers: [],
+			total_count: 0,
+			next: null
+		};
+		const serverList = Object.values(servers);
+		const totalCount = serverList.length;
+		const useLegacyFormat = (limit !== void 0 || offset !== void 0) && page === void 0 && perPage === void 0;
+		const finalPerPage = perPage ?? limit;
+		let finalPage = page;
+		if (finalPage === void 0 && offset !== void 0 && finalPerPage !== void 0 && finalPerPage > 0) finalPage = Math.floor(offset / finalPerPage);
+		const actualOffset = finalPage !== void 0 && finalPerPage !== void 0 ? finalPage * finalPerPage : 0;
+		let paginatedServers = serverList;
+		let nextUrl = null;
+		if (finalPerPage !== void 0) {
+			paginatedServers = serverList.slice(actualOffset, actualOffset + finalPerPage);
+			if (actualOffset + finalPerPage < totalCount) {
+				const nextPage = (finalPage ?? 0) + 1;
+				const prefix = routePrefix ?? "";
+				if (useLegacyFormat) nextUrl = `${prefix}/mcp/v0/servers?limit=${finalPerPage}&offset=${actualOffset + finalPerPage}`;
+				else nextUrl = `${prefix}/mcp/v0/servers?perPage=${finalPerPage}&page=${nextPage}`;
+			}
+		}
+		return {
+			servers: paginatedServers.map((server) => ({
+				...server.getServerInfo(),
+				transports: transportsOf(server)
+			})),
+			total_count: totalCount,
+			next: nextUrl
+		};
+	}
+});
+const GET_MCP_SERVER_DETAIL_ROUTE = createRoute({
+	method: "GET",
+	path: "/mcp/v0/servers/:id",
+	responseType: "json",
+	pathParamSchema: mcpServerDetailPathParams,
+	queryParamSchema: getMcpServerDetailQuerySchema,
+	responseSchema: serverDetailSchema,
+	summary: "Get MCP server details",
+	description: "Returns detailed information about a specific MCP server",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, id, version }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(id);
+		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${id}' not found` });
+		const serverDetail = {
+			...server.getServerDetail(),
+			transports: transportsOf(server)
+		};
+		if (version && serverDetail.version_detail.version !== version) throw new HTTPException(404, { message: `MCP server with ID '${id}' found, but not version '${version}'. Available version: ${serverDetail.version_detail.version}` });
+		return serverDetail;
+	}
+});
+const LIST_MCP_SERVER_TOOLS_ROUTE = createRoute({
+	method: "GET",
+	path: "/mcp/:serverId/tools",
+	responseType: "json",
+	pathParamSchema: mcpServerIdPathParams,
+	responseSchema: listMcpServerToolsResponseSchema,
+	summary: "List MCP server tools",
+	description: "Returns a list of tools available on the specified MCP server",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId, requestContext }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
+		if (typeof server.getToolListInfo !== "function") throw new HTTPException(501, { message: `Server '${serverId}' cannot list tools in this way.` });
+		return await server.getToolListInfo(requestContext);
+	}
+});
+const GET_MCP_SERVER_TOOL_DETAIL_ROUTE = createRoute({
+	method: "GET",
+	path: "/mcp/:serverId/tools/:toolId",
+	responseType: "json",
+	pathParamSchema: mcpServerToolPathParams,
+	responseSchema: mcpToolInfoSchema,
+	summary: "Get MCP server tool details",
+	description: "Returns detailed information about a specific tool on the MCP server",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId, toolId }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
+		if (typeof server.getToolInfo !== "function") throw new HTTPException(501, { message: `Server '${serverId}' cannot provide tool details in this way.` });
+		const toolInfo = await server.getToolInfo(toolId);
+		if (!toolInfo) throw new HTTPException(404, { message: `Tool with ID '${toolId}' not found on MCP server '${serverId}'` });
+		return toolInfo;
+	}
+});
+const EXECUTE_MCP_SERVER_TOOL_ROUTE = createRoute({
+	method: "POST",
+	path: "/mcp/:serverId/tools/:toolId/execute",
+	responseType: "json",
+	pathParamSchema: mcpServerToolPathParams,
+	bodySchema: executeToolBodySchema,
+	responseSchema: executeToolResponseSchema,
+	summary: "Execute MCP server tool",
+	description: "Executes a tool on the specified MCP server with the provided arguments",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId, toolId, data, resumeData, suspendPayload, requestContext }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
+		if (typeof server.executeTool !== "function") throw new HTTPException(501, { message: `Server '${serverId}' cannot execute tools in this way.` });
+		if (server.mcpVersion === 2) {
+			let execution;
+			try {
+				execution = await server.executeTool(toolId, data, {
+					requestContext,
+					resumeData,
+					suspendPayload
+				});
+			} catch (error) {
+				if (error instanceof MastraError && error.id === "MCP_SERVER_TOOL_INVALID_INPUT") throw new HTTPException(400, {
+					message: error.message,
+					cause: error
+				});
+				throw error;
+			}
+			if (execution.status === "suspended") return {
+				status: "suspended",
+				suspendPayload: execution.suspendPayload,
+				resumeSchema: execution.resumeSchema
+			};
+			return { result: execution.output };
+		}
+		return { result: await server.executeTool(toolId, data, { requestContext }) };
+	}
+});
+const LIST_MCP_SERVER_RESOURCES_ROUTE = createRoute({
+	method: "GET",
+	path: "/mcp/:serverId/resources",
+	responseType: "json",
+	pathParamSchema: mcpServerResourcePathParams,
+	responseSchema: listResourcesResponseSchema,
+	summary: "List MCP server resources",
+	description: "Returns a list of resources available on the MCP server, including ui:// app resources",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
+		if (typeof server.listResources !== "function") return { resources: [] };
+		return server.listResources();
+	}
+});
+const READ_MCP_SERVER_RESOURCE_ROUTE = createRoute({
+	method: "POST",
+	path: "/mcp/:serverId/resources/read",
+	responseType: "json",
+	pathParamSchema: mcpServerResourcePathParams,
+	bodySchema: readResourceBodySchema,
+	responseSchema: readResourceResponseSchema,
+	summary: "Read MCP server resource content",
+	description: "Reads the content of a resource by URI, used for rendering MCP App ui:// resources",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId, uri }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });
+		if (typeof server.readResource !== "function") throw new HTTPException(501, { message: `Server '${serverId}' does not support reading resources` });
+		try {
+			return await server.readResource(uri);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			if (message.includes("not found") || message.includes("not configured")) throw new HTTPException(404, { message: `Resource '${uri}' not found on server '${serverId}'` });
+			throw error;
+		}
+	}
+});
+const MCP_HTTP_TRANSPORT_ROUTE = createRoute({
+	method: "ALL",
+	path: "/mcp/:serverId/mcp",
+	responseType: "mcp-http",
+	pathParamSchema: mcpServerIdPathParams,
+	summary: "MCP HTTP Transport",
+	description: "Streamable HTTP transport endpoint for MCP protocol communication",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });
+		return {
+			server,
+			httpPath: `/mcp/${serverId}/mcp`
+		};
+	}
+});
+const MCP_SSE_TRANSPORT_ROUTE = createRoute({
+	method: "ALL",
+	path: "/mcp/:serverId/sse",
+	responseType: "mcp-sse",
+	pathParamSchema: mcpServerIdPathParams,
+	summary: "MCP SSE Transport",
+	description: "SSE transport endpoint for MCP protocol communication",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: async ({ mastra, serverId }) => {
+		if (!mastra || typeof mastra.getMCPServerById !== "function") throw new HTTPException(500, { message: "Mastra instance or getMCPServerById method not available" });
+		const server = mastra.getMCPServerById(serverId);
+		if (!server) throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });
+		if (!hasSSETransport(server)) throw new HTTPException(404, { message: "Legacy SSE transport is unavailable for MCP v2 servers" });
+		return {
+			server,
+			ssePath: `/mcp/${serverId}/sse`,
+			messagePath: `/mcp/${serverId}/messages`
+		};
+	}
+});
+const MCP_SSE_MESSAGES_ROUTE = createRoute({
+	method: "POST",
+	path: "/mcp/:serverId/messages",
+	responseType: "mcp-sse",
+	pathParamSchema: mcpServerIdPathParams,
+	summary: "MCP SSE Messages",
+	description: "Message endpoint for SSE transport (posts messages to active SSE streams)",
+	tags: ["MCP"],
+	requiresAuth: true,
+	handler: MCP_SSE_TRANSPORT_ROUTE.handler
+});
+//#endregion
+export { LIST_MCP_SERVER_RESOURCES_ROUTE as a, MCP_SSE_MESSAGES_ROUTE as c, mcp_exports as d, LIST_MCP_SERVERS_ROUTE as i, MCP_SSE_TRANSPORT_ROUTE as l, GET_MCP_SERVER_DETAIL_ROUTE as n, LIST_MCP_SERVER_TOOLS_ROUTE as o, GET_MCP_SERVER_TOOL_DETAIL_ROUTE as r, MCP_HTTP_TRANSPORT_ROUTE as s, EXECUTE_MCP_SERVER_TOOL_ROUTE as t, READ_MCP_SERVER_RESOURCE_ROUTE as u };
+
+//# sourceMappingURL=mcp-BTdLh6E_.js.map

package/dist/mcp-BTdLh6E_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-BTdLh6E_.js","names":[],"sources":["../src/server/handlers/mcp.ts"],"sourcesContent":["import { MastraError } from '@mastra/core/error';\nimport type {\n  MCPServerBase as MastraMCPServerImplementation,\n  MCPToolExecutionResultV2,\n  ServerInfo,\n} from '@mastra/core/mcp';\nimport { HTTPException } from '../http-exception';\nimport {\n  mcpServerDetailPathParams,\n  mcpServerToolPathParams,\n  executeToolBodySchema,\n  listMcpServersQuerySchema,\n  getMcpServerDetailQuerySchema,\n  listMcpServersResponseSchema,\n  serverDetailSchema,\n  mcpServerIdPathParams,\n  listMcpServerToolsResponseSchema,\n  mcpToolInfoSchema,\n  executeToolResponseSchema,\n  mcpServerResourcePathParams,\n  readResourceBodySchema,\n  readResourceResponseSchema,\n  listResourcesResponseSchema,\n} from '../schemas/mcp';\nimport type { MCPServerTransport } from '../schemas/mcp';\nimport type { ServerContext } from '../server-adapter';\nimport type { SetMcpRequestAuth } from '../server-adapter/mcp-auth';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\n// ============================================================================\n// Route Definitions (createRoute pattern for server adapters)\n// ============================================================================\n\n/**\n * Only `@mastra/mcp` 1.x servers implement the standalone HTTP+SSE transport; on a\n * 2026-07-28 server the inherited `startSSE`/`startHonoSSE` throw.\n */\nfunction hasSSETransport(server: MastraMCPServerImplementation): boolean {\n  return server.mcpVersion !== 2;\n}\n\nexport interface MCPServerInfoResponse extends ServerInfo {\n  /** Endpoints served under `/mcp/:serverId`; 2026-07-28 servers speak Streamable HTTP only. */\n  transports: MCPServerTransport[];\n}\n\nfunction transportsOf(server: MastraMCPServerImplementation): MCPServerTransport[] {\n  return hasSSETransport(server) ? ['streamable-http', 'sse'] : ['streamable-http'];\n}\n\nexport const LIST_MCP_SERVERS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/mcp/v0/servers',\n  responseType: 'json',\n  queryParamSchema: listMcpServersQuerySchema,\n  responseSchema: listMcpServersResponseSchema,\n  summary: 'List MCP servers',\n  description: 'Returns a list of registered MCP servers with pagination support',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    routePrefix,\n    page,\n    perPage,\n    limit,\n    offset,\n  }: ServerContext & { page?: number; perPage?: number; limit?: number; offset?: number }) => {\n    if (!mastra || typeof mastra.listMCPServers !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or listMCPServers method not available' });\n    }\n\n    const servers = mastra.listMCPServers();\n\n    if (!servers) {\n      return { servers: [], total_count: 0, next: null };\n    }\n\n    const serverList = Object.values(servers);\n    const totalCount = serverList.length;\n\n    // Support both page/perPage and limit/offset for backwards compatibility\n    // Detect which format user is using - prefer page/perPage if both provided\n    const useLegacyFormat =\n      (limit !== undefined || offset !== undefined) && page === undefined && perPage === undefined;\n\n    // If perPage provided, use it; otherwise fall back to limit\n    const finalPerPage = perPage ?? limit;\n    // If page provided, use it; otherwise convert from offset\n    let finalPage = page;\n    if (finalPage === undefined && offset !== undefined && finalPerPage !== undefined && finalPerPage > 0) {\n      finalPage = Math.floor(offset / finalPerPage);\n    }\n\n    // Calculate offset from page/perPage\n    const actualOffset = finalPage !== undefined && finalPerPage !== undefined ? finalPage * finalPerPage : 0;\n\n    // Apply pagination\n    let paginatedServers = serverList;\n    let nextUrl: string | null = null;\n\n    if (finalPerPage !== undefined) {\n      paginatedServers = serverList.slice(actualOffset, actualOffset + finalPerPage);\n\n      // Calculate next URL if there are more results\n      if (actualOffset + finalPerPage < totalCount) {\n        const nextPage = (finalPage ?? 0) + 1;\n        // Return next URL in same format as request (legacy limit/offset or page/perPage)\n        const prefix = routePrefix ?? '';\n        if (useLegacyFormat) {\n          const nextOffset = actualOffset + finalPerPage;\n          nextUrl = `${prefix}/mcp/v0/servers?limit=${finalPerPage}&offset=${nextOffset}`;\n        } else {\n          nextUrl = `${prefix}/mcp/v0/servers?perPage=${finalPerPage}&page=${nextPage}`;\n        }\n      }\n    }\n\n    // Get server info for each server\n    const serverInfoList: MCPServerInfoResponse[] = paginatedServers.map(server => ({\n      ...server.getServerInfo(),\n      transports: transportsOf(server),\n    }));\n\n    return {\n      servers: serverInfoList,\n      total_count: totalCount,\n      next: nextUrl,\n    };\n  },\n});\n\nexport const GET_MCP_SERVER_DETAIL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/mcp/v0/servers/:id',\n  responseType: 'json',\n  pathParamSchema: mcpServerDetailPathParams,\n  queryParamSchema: getMcpServerDetailQuerySchema,\n  responseSchema: serverDetailSchema,\n  summary: 'Get MCP server details',\n  description: 'Returns detailed information about a specific MCP server',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, id, version }: ServerContext & { id: string; version?: string }) => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(id);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server with ID '${id}' not found` });\n    }\n\n    const serverDetail = { ...server.getServerDetail(), transports: transportsOf(server) };\n\n    // If a specific version was requested, check if it matches\n    if (version && serverDetail.version_detail.version !== version) {\n      throw new HTTPException(404, {\n        message: `MCP server with ID '${id}' found, but not version '${version}'. Available version: ${serverDetail.version_detail.version}`,\n      });\n    }\n\n    return serverDetail;\n  },\n});\n\nexport const LIST_MCP_SERVER_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/mcp/:serverId/tools',\n  responseType: 'json',\n  pathParamSchema: mcpServerIdPathParams,\n  responseSchema: listMcpServerToolsResponseSchema,\n  summary: 'List MCP server tools',\n  description: 'Returns a list of tools available on the specified MCP server',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, serverId, requestContext }: ServerContext & { serverId: string }) => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n    }\n\n    if (typeof server.getToolListInfo !== 'function') {\n      throw new HTTPException(501, { message: `Server '${serverId}' cannot list tools in this way.` });\n    }\n\n    return await server.getToolListInfo(requestContext);\n  },\n});\n\nexport const GET_MCP_SERVER_TOOL_DETAIL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/mcp/:serverId/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: mcpServerToolPathParams,\n  responseSchema: mcpToolInfoSchema,\n  summary: 'Get MCP server tool details',\n  description: 'Returns detailed information about a specific tool on the MCP server',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, serverId, toolId }: ServerContext & { serverId: string; toolId: string }) => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n    }\n\n    if (typeof server.getToolInfo !== 'function') {\n      throw new HTTPException(501, { message: `Server '${serverId}' cannot provide tool details in this way.` });\n    }\n\n    const toolInfo = await server.getToolInfo(toolId);\n    if (!toolInfo) {\n      throw new HTTPException(404, { message: `Tool with ID '${toolId}' not found on MCP server '${serverId}'` });\n    }\n\n    return toolInfo;\n  },\n});\n\nexport const EXECUTE_MCP_SERVER_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/mcp/:serverId/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: mcpServerToolPathParams,\n  bodySchema: executeToolBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute MCP server tool',\n  description: 'Executes a tool on the specified MCP server with the provided arguments',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    serverId,\n    toolId,\n    data,\n    resumeData,\n    suspendPayload,\n    requestContext,\n  }: ServerContext & {\n    serverId: string;\n    toolId: string;\n    data?: unknown;\n    resumeData?: unknown;\n    suspendPayload?: unknown;\n  }) => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n    }\n\n    if (typeof server.executeTool !== 'function') {\n      throw new HTTPException(501, { message: `Server '${serverId}' cannot execute tools in this way.` });\n    }\n\n    if (server.mcpVersion === 2) {\n      // A 2026-07-28 server runs the tool with no protocol client attached: a tool\n      // that suspends for input is reported as such instead of pretending it finished, and\n      // the caller answers by sending the same args with `resumeData` and `suspendPayload`.\n      let execution: MCPToolExecutionResultV2;\n      try {\n        execution = await server.executeTool(toolId, data, { requestContext, resumeData, suspendPayload });\n      } catch (error) {\n        if (error instanceof MastraError && error.id === 'MCP_SERVER_TOOL_INVALID_INPUT') {\n          throw new HTTPException(400, { message: error.message, cause: error });\n        }\n        throw error;\n      }\n      if (execution.status === 'suspended') {\n        return {\n          status: 'suspended' as const,\n          suspendPayload: execution.suspendPayload,\n          resumeSchema: execution.resumeSchema,\n        };\n      }\n      return { result: execution.output };\n    }\n\n    const result = await server.executeTool(toolId, data, { requestContext });\n    return { result };\n  },\n});\n\n// ============================================================================\n// MCP Resource Routes\n// ============================================================================\n\nexport const LIST_MCP_SERVER_RESOURCES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/mcp/:serverId/resources',\n  responseType: 'json',\n  pathParamSchema: mcpServerResourcePathParams,\n  responseSchema: listResourcesResponseSchema,\n  summary: 'List MCP server resources',\n  description: 'Returns a list of resources available on the MCP server, including ui:// app resources',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, serverId }: ServerContext & { serverId: string }) => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n    }\n\n    if (typeof server.listResources !== 'function') {\n      return { resources: [] };\n    }\n\n    return server.listResources();\n  },\n});\n\nexport const READ_MCP_SERVER_RESOURCE_ROUTE = createRoute({\n  method: 'POST',\n  path: '/mcp/:serverId/resources/read',\n  responseType: 'json',\n  pathParamSchema: mcpServerResourcePathParams,\n  bodySchema: readResourceBodySchema,\n  responseSchema: readResourceResponseSchema,\n  summary: 'Read MCP server resource content',\n  description: 'Reads the content of a resource by URI, used for rendering MCP App ui:// resources',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, serverId, uri }: ServerContext & { serverId: string; uri: string }) => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n    }\n\n    if (typeof server.readResource !== 'function') {\n      throw new HTTPException(501, { message: `Server '${serverId}' does not support reading resources` });\n    }\n\n    try {\n      return await server.readResource(uri);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      if (message.includes('not found') || message.includes('not configured')) {\n        throw new HTTPException(404, { message: `Resource '${uri}' not found on server '${serverId}'` });\n      }\n      throw error;\n    }\n  },\n});\n\n// ============================================================================\n// MCP Transport Routes (Streamable HTTP and SSE)\n// ============================================================================\n\n/**\n * MCP transport options that can be passed to startHTTP() or startSSE().\n * Includes serverless mode for running in stateless environments like Cloudflare Workers or Vercel Edge.\n */\nexport interface MCPTransportOptions {\n  /**\n   * When true, runs in stateless mode without session management.\n   * Ideal for serverless environments where you can't maintain persistent connections.\n   */\n  serverless?: boolean;\n  /**\n   * Custom session ID generator function.\n   */\n  sessionIdGenerator?: () => string;\n  /**\n   * Sets `req.auth` before the MCP transport reads it. Overrides the default\n   * bridge that forwards the principal resolved by `server.auth`.\n   */\n  setRequestAuth?: SetMcpRequestAuth;\n}\n\n/**\n * MCP HTTP Transport response type.\n * Adapters use this to set up the HTTP transport via MCPServer.startHTTP()\n */\nexport interface MCPHttpTransportResult {\n  server: MastraMCPServerImplementation;\n  httpPath: string;\n  /**\n   * Optional MCP transport options for this specific route.\n   * These override any class-level mcpOptions configured on the adapter.\n   */\n  mcpOptions?: MCPTransportOptions;\n}\n\n/**\n * MCP SSE Transport response type.\n * Adapters use this to set up the SSE transport via MCPServer.startSSE() or startHonoSSE()\n *\n * Note: SSE transport is inherently stateful and doesn't support serverless mode.\n */\nexport interface MCPSseTransportResult {\n  /** A 1.x server: the SSE route only resolves servers that still implement the transport. */\n  server: MastraMCPServerImplementation;\n  ssePath: string;\n  messagePath: string;\n}\n\nexport const MCP_HTTP_TRANSPORT_ROUTE = createRoute({\n  method: 'ALL',\n  path: '/mcp/:serverId/mcp',\n  responseType: 'mcp-http',\n  pathParamSchema: mcpServerIdPathParams,\n  summary: 'MCP HTTP Transport',\n  description: 'Streamable HTTP transport endpoint for MCP protocol communication',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, serverId }: ServerContext & { serverId: string }): Promise<MCPHttpTransportResult> => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });\n    }\n\n    return {\n      server,\n      httpPath: `/mcp/${serverId}/mcp`,\n    };\n  },\n});\n\nexport const MCP_SSE_TRANSPORT_ROUTE = createRoute({\n  method: 'ALL',\n  path: '/mcp/:serverId/sse',\n  responseType: 'mcp-sse',\n  pathParamSchema: mcpServerIdPathParams,\n  summary: 'MCP SSE Transport',\n  description: 'SSE transport endpoint for MCP protocol communication',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: async ({ mastra, serverId }: ServerContext & { serverId: string }): Promise<MCPSseTransportResult> => {\n    if (!mastra || typeof mastra.getMCPServerById !== 'function') {\n      throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n    }\n\n    const server = mastra.getMCPServerById(serverId);\n\n    if (!server) {\n      throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });\n    }\n\n    if (!hasSSETransport(server)) {\n      throw new HTTPException(404, { message: 'Legacy SSE transport is unavailable for MCP v2 servers' });\n    }\n\n    return {\n      server,\n      ssePath: `/mcp/${serverId}/sse`,\n      messagePath: `/mcp/${serverId}/messages`,\n    };\n  },\n});\n\nexport const MCP_SSE_MESSAGES_ROUTE = createRoute({\n  method: 'POST',\n  path: '/mcp/:serverId/messages',\n  responseType: 'mcp-sse',\n  pathParamSchema: mcpServerIdPathParams,\n  summary: 'MCP SSE Messages',\n  description: 'Message endpoint for SSE transport (posts messages to active SSE streams)',\n  tags: ['MCP'],\n  requiresAuth: true,\n  handler: MCP_SSE_TRANSPORT_ROUTE.handler,\n});\n"],"mappings":"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"}