list-available-tools
Read-onlyIdempotent
Retrieve and organize all available tools from connected MCP servers for toolset creation. Access detailed metadata and reference tools using 'namespacedName' or 'refId' for streamlined integration.
Instructions
Discover all tools available from connected MCP servers. Returns structured data showing tools grouped by server for toolset creation. Tools can be referenced by 'namespacedName' (e.g., 'git.status') or 'refId' (unique hash). Example: Call with no parameters to see all tools organized by server with detailed metadata for each tool.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| summary | Yes | High-level statistics about available tools | |
| toolsByServer | Yes | Tools organized by their source server |
Implementation Reference
- Handler function that executes the tool logic: formats available tools from toolsetManager if discovery available, else returns error. Returns both text (JSON) and structured content.
handler: async ( // eslint-disable-next-line @typescript-eslint/no-unused-vars args: any ) => { if (deps.discoveryEngine) { const structured = deps.toolsetManager.formatAvailableTools(); return { content: [ { type: "text", text: JSON.stringify(structured), }, ], structuredContent: structured, }; } else { return { content: [ { type: "text", text: "❌ **Tool discovery not available**\n\nDiscovery engine is not initialized. Server may not be fully started.", }, ], isError: true, }; } }, - Complete tool definition including name, description, empty inputSchema, detailed outputSchema for tools summary and per-server lists with namespacedName/refId, and annotations.
export const listAvailableToolsDefinition: Tool = { name: "list-available-tools", description: "Discover all tools available from connected MCP servers. Returns structured data showing tools grouped by server for toolset creation. Tools can be referenced by 'namespacedName' (e.g., 'git.status') or 'refId' (unique hash). Example: Call with no parameters to see all tools organized by server with detailed metadata for each tool.", inputSchema: { type: "object" as const, properties: {}, additionalProperties: false, }, outputSchema: { type: "object" as const, properties: { summary: { type: "object", description: "High-level statistics about available tools", properties: { totalTools: { type: "number", description: "Total number of tools across all servers", }, totalServers: { type: "number", description: "Number of connected MCP servers", }, }, required: ["totalTools", "totalServers"], }, toolsByServer: { type: "array", description: "Tools organized by their source server", items: { type: "object", properties: { serverName: { type: "string", description: "Name of the MCP server", }, toolCount: { type: "number", description: "Number of tools from this server", }, tools: { type: "array", description: "List of tools from this server", items: { type: "object", properties: { name: { type: "string", description: "Original tool name", }, description: { type: "string", description: "Tool description (optional)", }, namespacedName: { type: "string", description: "Namespaced name for unambiguous reference (serverName.toolName)", }, serverName: { type: "string", description: "Source server name", }, refId: { type: "string", description: "Unique hash identifier for this tool", }, }, required: ["name", "namespacedName", "serverName", "refId"], }, }, }, required: ["serverName", "toolCount", "tools"], }, }, }, required: ["summary", "toolsByServer"], }, annotations: { title: "List Available Tools", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false, }, }; - src/server/tools/config-tools/registry.ts:23-52 (registration)Tool factory registered in CONFIG_TOOL_FACTORIES array (imported and added at line 24, import line 9), and name listed in CONFIG_TOOL_NAMES (line 42).
export const CONFIG_TOOL_FACTORIES: ToolModuleFactory[] = [ createListAvailableToolsModule, createBuildToolsetModule, createListSavedToolsetsModule, createEquipToolsetModule, createDeleteToolsetModule, createUnequipToolsetModule, createGetActiveToolsetModule, createAddToolAnnotationModule, createListPersonasModule, // Persona management tool createExitConfigurationModeModule, ]; /** * List of configuration tool names (derived from factories) * Note: This requires instantiation to get the actual names, * so we maintain a static list for convenience */ export const CONFIG_TOOL_NAMES = [ "list-available-tools", "build-toolset", "list-saved-toolsets", "equip-toolset", "delete-toolset", "unequip-toolset", "get-active-toolset", "add-tool-annotation", "list-personas", // Persona management tool "exit-configuration-mode", ] as const;