@mastra/react 1.7.3-alpha.3 → 1.8.0-alpha.4

package/dist/hooks/mcps/index.cjs

@@ -0,0 +1,215 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/hooks/mcps/use-mcp-app-tools.ts
+/**
+* Builds a map of tool names → MCP App info for tools across all registered
+* MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive
+* MCP App UIs).
+*
+* For each app tool, entries are created under both the original tool name
+* and the namespaced name (`${serverId}_${toolName}`) so that agent tools
+* sourced via `MCPClient.listTools()` (which namespaces) can be resolved.
+*/
+function useMcpAppTools({ queryOptions } = {}) {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["mcp-app-tools"],
+		queryFn: async () => {
+			const map = {};
+			const { servers } = await client.getMcpServers();
+			if (!servers?.length) return map;
+			const results = await Promise.allSettled(servers.map(async (server) => {
+				const { tools } = await client.getMcpServerTools(server.id);
+				return {
+					serverId: server.id,
+					tools
+				};
+			}));
+			for (const result of results) {
+				if (result.status !== "fulfilled") continue;
+				const { serverId, tools } = result.value;
+				for (const tool of tools) {
+					const resourceUri = tool._meta?.ui?.resourceUri;
+					if (resourceUri) {
+						const toolId = tool.name;
+						const info = {
+							serverId,
+							toolId,
+							toolName: tool.name,
+							resourceUri
+						};
+						map[toolId] = info;
+						if (tool.name !== toolId) map[tool.name] = info;
+						map[`${serverId}_${tool.name}`] = info;
+					}
+				}
+			}
+			return map;
+		},
+		staleTime: 6e4,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+}
+//#endregion
+//#region src/hooks/mcps/use-mcp-server-tool.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useMCPServerTool = ({ serverId, toolId, requestContext, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"mcp-server-tool",
+			serverId,
+			toolId
+		],
+		queryFn: () => {
+			return client.getMcpServerTool(serverId, toolId).details(requestContext);
+		},
+		...queryOptions
+	});
+};
+const useExecuteMCPTool = ({ serverId, toolId, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: ({ data, requestContext }) => {
+			return client.getMcpServerTool(serverId, toolId).execute({
+				data,
+				requestContext
+			});
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-mcp-server-tools.ts
+const useMCPServerTools = ({ selectedServer, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["mcpserver-tools", selectedServer?.id],
+		queryFn: async () => {
+			const fetchedToolsArray = (await client.getMcpServerTools(selectedServer?.id)).tools;
+			const transformedTools = {};
+			fetchedToolsArray.forEach((sdkToolInfo) => {
+				transformedTools[sdkToolInfo.name] = sdkToolInfo;
+			});
+			return transformedTools;
+		},
+		retry: false,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-mcp-server-tools-by-id.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useMCPServerToolsById = ({ serverId, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["mcpserver-tools", serverId],
+		queryFn: async () => {
+			const response = await client.getMcpServerTools(serverId);
+			return Object.fromEntries(response.tools.map((tool) => [tool.name, tool]));
+		},
+		retry: false,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-mcp-servers.ts
+const useMCPServers = ({ requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["mcp-servers"],
+		queryFn: async () => {
+			return (await client.getMcpServers(requestContext)).servers;
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-try-connect-mcp.ts
+async function parseResponse(response) {
+	if ((response.headers.get("content-type") ?? "").includes("text/event-stream")) {
+		const lines = (await response.text()).split("\n");
+		for (const line of lines) if (line.startsWith("data:")) {
+			const data = line.slice(5).trim();
+			if (data) return JSON.parse(data);
+		}
+		throw new Error("No data found in SSE response");
+	}
+	return response.json();
+}
+async function connectAndListTools(url, clientHeaders) {
+	const baseHeaders = {
+		...clientHeaders,
+		"Content-Type": "application/json",
+		Accept: "application/json, text/event-stream"
+	};
+	const initResponse = await fetch(url, {
+		method: "POST",
+		headers: baseHeaders,
+		credentials: "include",
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			id: 1,
+			method: "initialize",
+			params: {
+				protocolVersion: "2025-03-26",
+				capabilities: {},
+				clientInfo: {
+					name: "mastra-playground",
+					version: "1.0.0"
+				}
+			}
+		})
+	});
+	if (!initResponse.ok) throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);
+	const sessionId = initResponse.headers.get("Mcp-Session-Id");
+	await parseResponse(initResponse);
+	const sessionHeaders = { ...baseHeaders };
+	if (sessionId) sessionHeaders["Mcp-Session-Id"] = sessionId;
+	await fetch(url, {
+		method: "POST",
+		headers: sessionHeaders,
+		credentials: "include",
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			method: "notifications/initialized"
+		})
+	});
+	const toolsResponse = await fetch(url, {
+		method: "POST",
+		headers: sessionHeaders,
+		credentials: "include",
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			id: 2,
+			method: "tools/list"
+		})
+	});
+	if (!toolsResponse.ok) throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);
+	return { tools: (await parseResponse(toolsResponse)).result?.tools ?? [] };
+}
+const useTryConnectMcp = ({ queryOptions } = {}) => {
+	const clientHeaders = require_mastra_client_context.useMastraClient().options?.headers ?? {};
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: (url) => connectAndListTools(url, clientHeaders),
+		...queryOptions
+	});
+};
+//#endregion
+exports.useExecuteMCPTool = useExecuteMCPTool;
+exports.useMCPServerTool = useMCPServerTool;
+exports.useMCPServerTools = useMCPServerTools;
+exports.useMCPServerToolsById = useMCPServerToolsById;
+exports.useMCPServers = useMCPServers;
+exports.useMcpAppTools = useMcpAppTools;
+exports.useTryConnectMcp = useTryConnectMcp;
+
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/mcps/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient"],"sources":["../../../src/hooks/mcps/use-mcp-app-tools.ts","../../../src/hooks/mcps/use-mcp-server-tool.ts","../../../src/hooks/mcps/use-mcp-server-tools.ts","../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts","../../../src/hooks/mcps/use-mcp-servers.ts","../../../src/hooks/mcps/use-try-connect-mcp.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface McpAppToolInfo {\n  serverId: string;\n  toolId: string;\n  toolName: string;\n  resourceUri: string;\n}\n\n/**\n * Builds a map of tool names → MCP App info for tools across all registered\n * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive\n * MCP App UIs).\n *\n * For each app tool, entries are created under both the original tool name\n * and the namespaced name (`${serverId}_${toolName}`) so that agent tools\n * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.\n */\nexport function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-tools'],\n    queryFn: async () => {\n      const map: Record<string, McpAppToolInfo> = {};\n\n      const { servers } = await client.getMcpServers();\n      if (!servers?.length) return map;\n\n      const results = await Promise.allSettled(\n        servers.map(async server => {\n          const { tools } = await client.getMcpServerTools(server.id);\n          return { serverId: server.id, tools };\n        }),\n      );\n\n      for (const result of results) {\n        if (result.status !== 'fulfilled') continue;\n        const { serverId, tools } = result.value;\n        for (const tool of tools) {\n          const meta = tool._meta as { ui?: { resourceUri?: string } } | undefined;\n          const resourceUri = meta?.ui?.resourceUri;\n          if (resourceUri) {\n            const toolId = tool.name;\n            const info: McpAppToolInfo = { serverId, toolId, toolName: tool.name, resourceUri };\n            map[toolId] = info;\n            if (tool.name !== toolId) {\n              map[tool.name] = info;\n            }\n            // Also map the namespaced name used by MCPClient.listTools()\n            map[`${serverId}_${tool.name}`] = info;\n          }\n        }\n      }\n\n      return map;\n    },\n    staleTime: 60_000,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n}\n","import type { MastraClient } from '@mastra/client-js';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerTool = <TData = MCPServerToolDetails>({\n  serverId,\n  toolId,\n  requestContext,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-server-tool', serverId, toolId],\n    queryFn: () => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.details(requestContext);\n    },\n    ...queryOptions,\n  });\n};\n\nexport type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;\ntype ExecuteMCPToolVariables = { data: any; requestContext?: Record<string, any> };\n\nexport const useExecuteMCPTool = ({\n  serverId,\n  toolId,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;\n}): UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables> => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: ({ data, requestContext }: ExecuteMCPToolVariables) => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.execute({ data, requestContext: requestContext as RequestContext });\n    },\n    ...queryOptions,\n  });\n};\n","import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';\nimport type { ServerInfo } from '@mastra/core/mcp';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServerTools = <TData = Record<string, SdkMcpToolInfo>>({\n  selectedServer,\n  queryOptions,\n}: {\n  selectedServer: ServerInfo;\n  queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', selectedServer?.id],\n    queryFn: async () => {\n      const response = await client.getMcpServerTools(selectedServer?.id);\n      const fetchedToolsArray: SdkMcpToolInfo[] = response.tools;\n      const transformedTools: Record<string, SdkMcpToolInfo> = {};\n      fetchedToolsArray.forEach((sdkToolInfo: SdkMcpToolInfo) => {\n        transformedTools[sdkToolInfo.name] = sdkToolInfo;\n      });\n\n      return transformedTools;\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerToolsById = <TData = MCPServerToolsById>({\n  serverId,\n  queryOptions,\n}: {\n  serverId: string | null;\n  queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', serverId],\n    queryFn: async (): Promise<MCPServerToolsById> => {\n      const response = await client.getMcpServerTools(serverId!);\n      return Object.fromEntries(response.tools.map(tool => [tool.name, tool]));\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { McpServerListResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServers = <TData = McpServerListResponse['servers']>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-servers'],\n    queryFn: async () => {\n      const mcpServers: McpServerListResponse['servers'] = (await client.getMcpServers(requestContext)).servers;\n      return mcpServers;\n    },\n    ...queryOptions,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface McpTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n}\n\nexport interface TryConnectResult {\n  tools: McpTool[];\n}\n\nasync function parseResponse(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (contentType.includes('text/event-stream')) {\n    const text = await response.text();\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (line.startsWith('data:')) {\n        const data = line.slice('data:'.length).trim();\n        if (data) {\n          return JSON.parse(data);\n        }\n      }\n    }\n\n    throw new Error('No data found in SSE response');\n  }\n\n  return response.json();\n}\n\nasync function connectAndListTools(url: string, clientHeaders?: Record<string, string>): Promise<TryConnectResult> {\n  const baseHeaders: Record<string, string> = {\n    ...clientHeaders,\n    'Content-Type': 'application/json',\n    Accept: 'application/json, text/event-stream',\n  };\n\n  // Step 1: Initialize\n  const initResponse = await fetch(url, {\n    method: 'POST',\n    headers: baseHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 'mastra-playground', version: '1.0.0' },\n      },\n    }),\n  });\n\n  if (!initResponse.ok) {\n    throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);\n  }\n\n  const sessionId = initResponse.headers.get('Mcp-Session-Id');\n  await parseResponse(initResponse);\n\n  const sessionHeaders: Record<string, string> = {\n    ...baseHeaders,\n  };\n  if (sessionId) {\n    sessionHeaders['Mcp-Session-Id'] = sessionId;\n  }\n\n  // Step 2: Send initialized notification\n  await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      method: 'notifications/initialized',\n    }),\n  });\n\n  // Step 3: List tools\n  const toolsResponse = await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 2,\n      method: 'tools/list',\n    }),\n  });\n\n  if (!toolsResponse.ok) {\n    throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);\n  }\n\n  const toolsResult = (await parseResponse(toolsResponse)) as { result?: { tools?: McpTool[] } };\n\n  return {\n    tools: toolsResult.result?.tools ?? [],\n  };\n}\n\nexport const useTryConnectMcp = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TryConnectResult, string> } = {}) => {\n  const client = useMastraClient();\n  const clientHeaders = (client.options?.headers as Record<string, string>) ?? {};\n\n  return useMutation({\n    mutationFn: (url: string) => connectAndListTools(url, clientHeaders),\n    ...queryOptions,\n  });\n};\n\nexport type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;\n"],"mappings":"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"}

package/dist/hooks/mcps/index.d.ts

@@ -0,0 +1,7 @@
+export * from './use-mcp-app-tools.js';
+export * from './use-mcp-server-tool.js';
+export * from './use-mcp-server-tools.js';
+export * from './use-mcp-server-tools-by-id.js';
+export * from './use-mcp-servers.js';
+export * from './use-try-connect-mcp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/mcps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/hooks/mcps/index.js

@@ -0,0 +1,208 @@
+import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
+import { useMutation, useQuery } from "@tanstack/react-query";
+//#region src/hooks/mcps/use-mcp-app-tools.ts
+/**
+* Builds a map of tool names → MCP App info for tools across all registered
+* MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive
+* MCP App UIs).
+*
+* For each app tool, entries are created under both the original tool name
+* and the namespaced name (`${serverId}_${toolName}`) so that agent tools
+* sourced via `MCPClient.listTools()` (which namespaces) can be resolved.
+*/
+function useMcpAppTools({ queryOptions } = {}) {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["mcp-app-tools"],
+		queryFn: async () => {
+			const map = {};
+			const { servers } = await client.getMcpServers();
+			if (!servers?.length) return map;
+			const results = await Promise.allSettled(servers.map(async (server) => {
+				const { tools } = await client.getMcpServerTools(server.id);
+				return {
+					serverId: server.id,
+					tools
+				};
+			}));
+			for (const result of results) {
+				if (result.status !== "fulfilled") continue;
+				const { serverId, tools } = result.value;
+				for (const tool of tools) {
+					const resourceUri = tool._meta?.ui?.resourceUri;
+					if (resourceUri) {
+						const toolId = tool.name;
+						const info = {
+							serverId,
+							toolId,
+							toolName: tool.name,
+							resourceUri
+						};
+						map[toolId] = info;
+						if (tool.name !== toolId) map[tool.name] = info;
+						map[`${serverId}_${tool.name}`] = info;
+					}
+				}
+			}
+			return map;
+		},
+		staleTime: 6e4,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+}
+//#endregion
+//#region src/hooks/mcps/use-mcp-server-tool.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useMCPServerTool = ({ serverId, toolId, requestContext, queryOptions }) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: [
+			"mcp-server-tool",
+			serverId,
+			toolId
+		],
+		queryFn: () => {
+			return client.getMcpServerTool(serverId, toolId).details(requestContext);
+		},
+		...queryOptions
+	});
+};
+const useExecuteMCPTool = ({ serverId, toolId, queryOptions }) => {
+	const client = useMastraClient();
+	return useMutation({
+		mutationFn: ({ data, requestContext }) => {
+			return client.getMcpServerTool(serverId, toolId).execute({
+				data,
+				requestContext
+			});
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-mcp-server-tools.ts
+const useMCPServerTools = ({ selectedServer, queryOptions }) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["mcpserver-tools", selectedServer?.id],
+		queryFn: async () => {
+			const fetchedToolsArray = (await client.getMcpServerTools(selectedServer?.id)).tools;
+			const transformedTools = {};
+			fetchedToolsArray.forEach((sdkToolInfo) => {
+				transformedTools[sdkToolInfo.name] = sdkToolInfo;
+			});
+			return transformedTools;
+		},
+		retry: false,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-mcp-server-tools-by-id.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useMCPServerToolsById = ({ serverId, queryOptions }) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["mcpserver-tools", serverId],
+		queryFn: async () => {
+			const response = await client.getMcpServerTools(serverId);
+			return Object.fromEntries(response.tools.map((tool) => [tool.name, tool]));
+		},
+		retry: false,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-mcp-servers.ts
+const useMCPServers = ({ requestContext, queryOptions } = {}) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["mcp-servers"],
+		queryFn: async () => {
+			return (await client.getMcpServers(requestContext)).servers;
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/mcps/use-try-connect-mcp.ts
+async function parseResponse(response) {
+	if ((response.headers.get("content-type") ?? "").includes("text/event-stream")) {
+		const lines = (await response.text()).split("\n");
+		for (const line of lines) if (line.startsWith("data:")) {
+			const data = line.slice(5).trim();
+			if (data) return JSON.parse(data);
+		}
+		throw new Error("No data found in SSE response");
+	}
+	return response.json();
+}
+async function connectAndListTools(url, clientHeaders) {
+	const baseHeaders = {
+		...clientHeaders,
+		"Content-Type": "application/json",
+		Accept: "application/json, text/event-stream"
+	};
+	const initResponse = await fetch(url, {
+		method: "POST",
+		headers: baseHeaders,
+		credentials: "include",
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			id: 1,
+			method: "initialize",
+			params: {
+				protocolVersion: "2025-03-26",
+				capabilities: {},
+				clientInfo: {
+					name: "mastra-playground",
+					version: "1.0.0"
+				}
+			}
+		})
+	});
+	if (!initResponse.ok) throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);
+	const sessionId = initResponse.headers.get("Mcp-Session-Id");
+	await parseResponse(initResponse);
+	const sessionHeaders = { ...baseHeaders };
+	if (sessionId) sessionHeaders["Mcp-Session-Id"] = sessionId;
+	await fetch(url, {
+		method: "POST",
+		headers: sessionHeaders,
+		credentials: "include",
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			method: "notifications/initialized"
+		})
+	});
+	const toolsResponse = await fetch(url, {
+		method: "POST",
+		headers: sessionHeaders,
+		credentials: "include",
+		body: JSON.stringify({
+			jsonrpc: "2.0",
+			id: 2,
+			method: "tools/list"
+		})
+	});
+	if (!toolsResponse.ok) throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);
+	return { tools: (await parseResponse(toolsResponse)).result?.tools ?? [] };
+}
+const useTryConnectMcp = ({ queryOptions } = {}) => {
+	const clientHeaders = useMastraClient().options?.headers ?? {};
+	return useMutation({
+		mutationFn: (url) => connectAndListTools(url, clientHeaders),
+		...queryOptions
+	});
+};
+//#endregion
+export { useExecuteMCPTool, useMCPServerTool, useMCPServerTools, useMCPServerToolsById, useMCPServers, useMcpAppTools, useTryConnectMcp };
+
+//# sourceMappingURL=index.js.map

package/dist/hooks/mcps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/mcps/use-mcp-app-tools.ts","../../../src/hooks/mcps/use-mcp-server-tool.ts","../../../src/hooks/mcps/use-mcp-server-tools.ts","../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts","../../../src/hooks/mcps/use-mcp-servers.ts","../../../src/hooks/mcps/use-try-connect-mcp.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface McpAppToolInfo {\n  serverId: string;\n  toolId: string;\n  toolName: string;\n  resourceUri: string;\n}\n\n/**\n * Builds a map of tool names → MCP App info for tools across all registered\n * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive\n * MCP App UIs).\n *\n * For each app tool, entries are created under both the original tool name\n * and the namespaced name (`${serverId}_${toolName}`) so that agent tools\n * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.\n */\nexport function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-tools'],\n    queryFn: async () => {\n      const map: Record<string, McpAppToolInfo> = {};\n\n      const { servers } = await client.getMcpServers();\n      if (!servers?.length) return map;\n\n      const results = await Promise.allSettled(\n        servers.map(async server => {\n          const { tools } = await client.getMcpServerTools(server.id);\n          return { serverId: server.id, tools };\n        }),\n      );\n\n      for (const result of results) {\n        if (result.status !== 'fulfilled') continue;\n        const { serverId, tools } = result.value;\n        for (const tool of tools) {\n          const meta = tool._meta as { ui?: { resourceUri?: string } } | undefined;\n          const resourceUri = meta?.ui?.resourceUri;\n          if (resourceUri) {\n            const toolId = tool.name;\n            const info: McpAppToolInfo = { serverId, toolId, toolName: tool.name, resourceUri };\n            map[toolId] = info;\n            if (tool.name !== toolId) {\n              map[tool.name] = info;\n            }\n            // Also map the namespaced name used by MCPClient.listTools()\n            map[`${serverId}_${tool.name}`] = info;\n          }\n        }\n      }\n\n      return map;\n    },\n    staleTime: 60_000,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n}\n","import type { MastraClient } from '@mastra/client-js';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerTool = <TData = MCPServerToolDetails>({\n  serverId,\n  toolId,\n  requestContext,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-server-tool', serverId, toolId],\n    queryFn: () => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.details(requestContext);\n    },\n    ...queryOptions,\n  });\n};\n\nexport type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;\ntype ExecuteMCPToolVariables = { data: any; requestContext?: Record<string, any> };\n\nexport const useExecuteMCPTool = ({\n  serverId,\n  toolId,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;\n}): UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables> => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: ({ data, requestContext }: ExecuteMCPToolVariables) => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.execute({ data, requestContext: requestContext as RequestContext });\n    },\n    ...queryOptions,\n  });\n};\n","import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';\nimport type { ServerInfo } from '@mastra/core/mcp';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServerTools = <TData = Record<string, SdkMcpToolInfo>>({\n  selectedServer,\n  queryOptions,\n}: {\n  selectedServer: ServerInfo;\n  queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', selectedServer?.id],\n    queryFn: async () => {\n      const response = await client.getMcpServerTools(selectedServer?.id);\n      const fetchedToolsArray: SdkMcpToolInfo[] = response.tools;\n      const transformedTools: Record<string, SdkMcpToolInfo> = {};\n      fetchedToolsArray.forEach((sdkToolInfo: SdkMcpToolInfo) => {\n        transformedTools[sdkToolInfo.name] = sdkToolInfo;\n      });\n\n      return transformedTools;\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerToolsById = <TData = MCPServerToolsById>({\n  serverId,\n  queryOptions,\n}: {\n  serverId: string | null;\n  queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', serverId],\n    queryFn: async (): Promise<MCPServerToolsById> => {\n      const response = await client.getMcpServerTools(serverId!);\n      return Object.fromEntries(response.tools.map(tool => [tool.name, tool]));\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { McpServerListResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServers = <TData = McpServerListResponse['servers']>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-servers'],\n    queryFn: async () => {\n      const mcpServers: McpServerListResponse['servers'] = (await client.getMcpServers(requestContext)).servers;\n      return mcpServers;\n    },\n    ...queryOptions,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface McpTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n}\n\nexport interface TryConnectResult {\n  tools: McpTool[];\n}\n\nasync function parseResponse(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (contentType.includes('text/event-stream')) {\n    const text = await response.text();\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (line.startsWith('data:')) {\n        const data = line.slice('data:'.length).trim();\n        if (data) {\n          return JSON.parse(data);\n        }\n      }\n    }\n\n    throw new Error('No data found in SSE response');\n  }\n\n  return response.json();\n}\n\nasync function connectAndListTools(url: string, clientHeaders?: Record<string, string>): Promise<TryConnectResult> {\n  const baseHeaders: Record<string, string> = {\n    ...clientHeaders,\n    'Content-Type': 'application/json',\n    Accept: 'application/json, text/event-stream',\n  };\n\n  // Step 1: Initialize\n  const initResponse = await fetch(url, {\n    method: 'POST',\n    headers: baseHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 'mastra-playground', version: '1.0.0' },\n      },\n    }),\n  });\n\n  if (!initResponse.ok) {\n    throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);\n  }\n\n  const sessionId = initResponse.headers.get('Mcp-Session-Id');\n  await parseResponse(initResponse);\n\n  const sessionHeaders: Record<string, string> = {\n    ...baseHeaders,\n  };\n  if (sessionId) {\n    sessionHeaders['Mcp-Session-Id'] = sessionId;\n  }\n\n  // Step 2: Send initialized notification\n  await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      method: 'notifications/initialized',\n    }),\n  });\n\n  // Step 3: List tools\n  const toolsResponse = await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 2,\n      method: 'tools/list',\n    }),\n  });\n\n  if (!toolsResponse.ok) {\n    throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);\n  }\n\n  const toolsResult = (await parseResponse(toolsResponse)) as { result?: { tools?: McpTool[] } };\n\n  return {\n    tools: toolsResult.result?.tools ?? [],\n  };\n}\n\nexport const useTryConnectMcp = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TryConnectResult, string> } = {}) => {\n  const client = useMastraClient();\n  const clientHeaders = (client.options?.headers as Record<string, string>) ?? {};\n\n  return useMutation({\n    mutationFn: (url: string) => connectAndListTools(url, clientHeaders),\n    ...queryOptions,\n  });\n};\n\nexport type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;\n"],"mappings":"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"}

package/dist/hooks/mcps/use-mcp-app-tools.d.ts

@@ -0,0 +1,21 @@
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export interface McpAppToolInfo {
+    serverId: string;
+    toolId: string;
+    toolName: string;
+    resourceUri: string;
+}
+/**
+ * Builds a map of tool names → MCP App info for tools across all registered
+ * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive
+ * MCP App UIs).
+ *
+ * For each app tool, entries are created under both the original tool name
+ * and the namespaced name (`${serverId}_${toolName}`) so that agent tools
+ * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.
+ */
+export declare function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({ queryOptions, }?: {
+    queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData>;
+}): UseQueryResult<TData, Error>;
+//# sourceMappingURL=use-mcp-app-tools.d.ts.map

package/dist/hooks/mcps/use-mcp-app-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-app-tools.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-mcp-app-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,EACrE,YAAY,GACb,GAAE;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,KAAK,CAAC,CAAA;CAAO,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CA2ClH"}

package/dist/hooks/mcps/use-mcp-server-tool.d.ts

@@ -0,0 +1,25 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';
+import type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options.js';
+type MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useMCPServerTool: <TData = MCPServerToolDetails>({ serverId, toolId, requestContext, queryOptions, }: {
+    serverId: string;
+    toolId: string;
+    requestContext?: Record<string, any>;
+    queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;
+}) => UseQueryResult<TData, Error>;
+export type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;
+type ExecuteMCPToolVariables = {
+    data: any;
+    requestContext?: Record<string, any>;
+};
+export declare const useExecuteMCPTool: ({ serverId, toolId, queryOptions, }: {
+    serverId: string;
+    toolId: string;
+    queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;
+}) => UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables>;
+export {};
+//# sourceMappingURL=use-mcp-server-tool.d.ts.map

package/dist/hooks/mcps/use-mcp-server-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-server-tool.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-mcp-server-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,KAAK,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEzG;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,GAAG,oBAAoB,uDAK1D;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,kBAAkB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;CAChE,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAW9B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAClH,KAAK,uBAAuB,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAAC;AAEnF,eAAO,MAAM,iBAAiB,wCAI3B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,qBAAqB,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,CAAC;CACvF,KAAG,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,uBAAuB,CAU3E,CAAC"}

package/dist/hooks/mcps/use-mcp-server-tools-by-id.d.ts

@@ -0,0 +1,13 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+type MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useMCPServerToolsById: <TData = MCPServerToolsById>({ serverId, queryOptions, }: {
+    serverId: string | null;
+    queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-mcp-server-tools-by-id.d.ts.map

package/dist/hooks/mcps/use-mcp-server-tools-by-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-server-tools-by-id.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAElH;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,GAAG,kBAAkB,+BAG7D;IACD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;CAC9D,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAa9B,CAAC"}

package/dist/hooks/mcps/use-mcp-server-tools.d.ts

@@ -0,0 +1,9 @@
+import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';
+import type { ServerInfo } from '@mastra/core/mcp';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export declare const useMCPServerTools: <TData = Record<string, SdkMcpToolInfo>>({ selectedServer, queryOptions, }: {
+    selectedServer: ServerInfo;
+    queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;
+}) => UseQueryResult<TData, Error>;
+//# sourceMappingURL=use-mcp-server-tools.d.ts.map

package/dist/hooks/mcps/use-mcp-server-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-server-tools.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-mcp-server-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,eAAO,MAAM,iBAAiB,GAAI,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,qCAGrE;IACD,cAAc,EAAE,UAAU,CAAC;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC;CAC1E,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAmB9B,CAAC"}

package/dist/hooks/mcps/use-mcp-servers.d.ts

@@ -0,0 +1,8 @@
+import type { McpServerListResponse } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export declare const useMCPServers: <TData = McpServerListResponse['servers']>({ requestContext, queryOptions, }?: {
+    requestContext?: Record<string, any>;
+    queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;
+}) => UseQueryResult<TData, Error>;
+//# sourceMappingURL=use-mcp-servers.d.ts.map

package/dist/hooks/mcps/use-mcp-servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-servers.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-mcp-servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,eAAO,MAAM,aAAa,GAAI,KAAK,GAAG,qBAAqB,CAAC,SAAS,CAAC,sCAGnE;IACD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;CAC5E,KAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAWnC,CAAC"}

package/dist/hooks/mcps/use-try-connect-mcp.d.ts

@@ -0,0 +1,15 @@
+import type { MastraMutationOptions } from '../shared/query-options.js';
+interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface TryConnectResult {
+    tools: McpTool[];
+}
+export declare const useTryConnectMcp: ({ queryOptions, }?: {
+    queryOptions?: MastraMutationOptions<TryConnectResult, string>;
+}) => import("@tanstack/react-query").UseMutationResult<TryConnectResult, Error, string, unknown>;
+export type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;
+export {};
+//# sourceMappingURL=use-try-connect-mcp.d.ts.map

package/dist/hooks/mcps/use-try-connect-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-try-connect-mcp.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-try-connect-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAgGD,eAAO,MAAM,gBAAgB,uBAE1B;IAAE,YAAY,CAAC,EAAE,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;CAAE,gGAQpE,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}