@salesforce/mcp 0.16.1 → 0.17.1-dev.0

package/README.md

@@ -183,9 +183,11 @@ The `--dynamic-tools` flag enables dynamic tool discovery and loading. When this
 
 #### Core Toolset (always enabled)
 
-Includes this tool:
+Includes these tools:
 
 - `sf-get-username` - Determines the appropriate username or alias for Salesforce operations, handling both default orgs and Dev Hubs.
+- `sf-resume` - Resumes a long-running operation that wasn't completed by another tool.
+- `sf-suggest-cli-command` - Suggests an `sf` Salesforce CLI command based on a natural language query. The tool finds relevant CLI commands from a local index and uses an LLM to construct the precise command to fulfill your request.
 
 #### Orgs Toolset
 
@@ -211,14 +213,13 @@ Includes these tools:
 
 - `sf-deploy-metadata` - Deploys metadata from your DX project to an org.
 - `sf-retrieve-metadata` - Retrieves metadata from your org to your DX project.
--
 
 #### Testing Toolset
 
 Includes these tools:
 
 - `sf-test-agents` - Executes agent tests in your org.
-- `sf-test-apex` - Executes apex tests in your org
+- `sf-test-apex` - Executes apex tests in your org.
 
 ## Configure Other Clients to Use the Salesforce DX MCP Server
 

package/lib/index.js

@@ -158,7 +158,7 @@ You can also use special values to control access to orgs:
         if (toolsetsToEnable.dynamic) {
             this.logToStderr('Registering dynamic tools');
             // Individual tool management
-            dynamic.registerToolEnableTool(server);
+            dynamic.registerToolEnableTools(server);
             dynamic.registerToolListTools(server);
         }
         // ************************

package/lib/shared/tools.d.ts

@@ -39,6 +39,10 @@ export declare function enableTool(toolName: string): Promise<{
     success: boolean;
     message: string;
 }>;
+export declare function enableTools(tools: string[]): Promise<Array<{
+    success: boolean;
+    message: string;
+}>>;
 /**
  * Disable an individual tool
  */

package/lib/shared/tools.js

@@ -18,7 +18,13 @@ export const TOOLSETS = ['orgs', 'data', 'users', 'metadata', 'testing', 'experi
 /*
  * These are tools that are always enabled at startup. They cannot be disabled and they cannot be dynamically enabled.
  */
-export const CORE_TOOLS = ['sf-get-username', 'sf-resume', 'sf-enable-tool', 'sf-list-tools', 'sf-suggest-cli-command'];
+export const CORE_TOOLS = [
+    'sf-get-username',
+    'sf-resume',
+    'sf-enable-tools',
+    'sf-list-tools',
+    'sf-suggest-cli-command',
+];
 /**
  * Determines which toolsets should be enabled based on the provided toolsets array and dynamic tools flag.
  *
@@ -112,6 +118,25 @@ export async function enableTool(toolName) {
     toolInfo.tool.enable();
     return { success: true, message: `Tool ${toolName} enabled` };
 }
+export async function enableTools(tools) {
+    const results = [];
+    const cachedTools = await Cache.safeGet('tools');
+    for (const tool of tools) {
+        const toolInfo = cachedTools.find((t) => t.name === tool);
+        if (!toolInfo) {
+            results.push({ success: false, message: `Tool ${tool} not found` });
+            continue;
+        }
+        if (toolInfo.tool.enabled) {
+            results.push({ success: false, message: `Tool ${tool} is already enabled` });
+            continue;
+        }
+        // Enable the tool directly
+        toolInfo.tool.enable();
+        results.push({ success: true, message: `Tool ${tool} enabled` });
+    }
+    return results;
+}
 /**
  * Disable an individual tool
  */

package/lib/tools/core/sf-suggest-cli-command.js

@@ -23,7 +23,18 @@ const suggestCliCommandParamsSchema = z.object({
  * Suggest a Salesforce CLI (sf) command based on user input.
  */
 export const registerToolSuggestCliCommand = (server) => {
-    server.tool('sf-suggest-cli-command', "Suggests an `sf` CLI command based on a natural language query. It finds relevant commands from a local index and uses an LLM to construct the final, precise command to fulfill the user's request. Use this tool whenever a user asks for guidance on how to use the Salesforce CLI (`sf` or `sfdx`), needs help with command syntax, wants to know what command to run for a specific task, or asks questions like 'how do I...', 'what command...', or 'how to...' related to Salesforce development operations.", suggestCliCommandParamsSchema.shape, {
+    server.tool('sf-suggest-cli-command', `Suggests an \`sf\` CLI command based on a natural language query. It finds relevant commands from a local index and uses an LLM to construct the final, precise command to fulfill the user's request.
+
+AGENT INSTRUCTIONS:
+Use this tool whenever a user:
+  - asks for guidance on how to use the Salesforce CLI (sf or sfdx)
+  - needs help with Salesforce CLI (sf or sfdx) command syntax
+  - wants to know what Salesforce CLI (sf or sfdx) command to run for a specific task
+  - asks questions like 'how do I...', 'what command...', or 'how to...' related to Salesforce development operations.
+NEVER use this tool for enabling Salesforce MCP tools (use sf-enable-tools instead).
+NEVER use this tool for listing available Salesforce MCP tools (use sf-list-tools instead).
+NEVER use this tool for understanding the Salesforce MCP server's capabilities.
+NEVER use this tool for understanding the input schema of a Salesforce MCP tool.`, suggestCliCommandParamsSchema.shape, {
         readOnlyHint: true,
     }, async ({ query }) => {
         const assets = await getAssets();

package/lib/tools/dynamic/index.d.ts

@@ -1,2 +1,2 @@
-export { registerToolEnableTool } from './sf-enable-tool.js';
+export { registerToolEnableTools } from './sf-enable-tools.js';
 export { registerToolListTools } from './sf-list-tools.js';

package/lib/tools/dynamic/index.js

@@ -13,6 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export { registerToolEnableTool } from './sf-enable-tool.js';
+export { registerToolEnableTools } from './sf-enable-tools.js';
 export { registerToolListTools } from './sf-list-tools.js';
 //# sourceMappingURL=index.js.map

package/lib/tools/dynamic/sf-enable-tools.d.ts

@@ -0,0 +1,2 @@
+import { SfMcpServer } from '../../sf-mcp-server.js';
+export declare function registerToolEnableTools(server: SfMcpServer): void;

package/lib/tools/dynamic/{sf-enable-tool.js → sf-enable-tools.js}

@@ -15,25 +15,28 @@
  */
 import { z } from 'zod';
 import { textResponse } from '../../shared/utils.js';
-import { enableTool } from '../../shared/tools.js';
-const enableToolParamsSchema = z.object({
-    tool: z.string().describe('The name of the tool to enable'),
+import { enableTools } from '../../shared/tools.js';
+const enableToolsParamsSchema = z.object({
+    tools: z.array(z.string()).describe('The names of the tools to enable'),
 });
-export function registerToolEnableTool(server) {
-    server.tool('sf-enable-tool', `Enable one of the tools the Salesforce MCP server provides.
+export function registerToolEnableTools(server) {
+    server.tool('sf-enable-tools', `Enable one or more of the tools the Salesforce MCP server provides.
 
 AGENT INSTRUCTIONS:
 Use sf-list-all-tools first to learn what tools are available for enabling.
-Once you have enabled the tool, you MUST invoke that tool to accomplish the user's original request - DO NOT USE A DIFFERENT TOOL OR THE COMMAND LINE.`, enableToolParamsSchema.shape, {
-        title: 'Enable an individual tool',
+Once you have enabled the tool, you MUST invoke that tool to accomplish the user's original request - DO NOT USE A DIFFERENT TOOL OR THE COMMAND LINE.`, enableToolsParamsSchema.shape, {
+        title: 'Enable Salesforce MCP tools',
         readOnlyHint: true,
         openWorldHint: false,
-    }, async ({ tool }) => {
-        const result = await enableTool(tool);
-        if (result.success) {
-            server.sendToolListChanged();
+    }, async ({ tools }) => {
+        if (tools.length === 0) {
+            return textResponse('No tools specified to enable.', true);
         }
-        return textResponse(result.message, !result.success);
+        const results = await enableTools(tools);
+        server.sendToolListChanged();
+        const hasError = results.some((result) => !result.success);
+        const resultMessages = results.map((result) => result.message).join('\n');
+        return textResponse(resultMessages, hasError);
     });
 }
-//# sourceMappingURL=sf-enable-tool.js.map
+//# sourceMappingURL=sf-enable-tools.js.map

package/lib/tools/dynamic/sf-list-tools.js

@@ -25,8 +25,8 @@ ONLY use this tool if:
 2. You genuinely don't know what tools are available for a specific task
 3. You need to discover new tools for an unfamiliar use case
 
-If you find a tool you want to enable, call sf-enable-tool with the tool name.
-Once you have enabled the tool, you MUST invoke that tool to accomplish the user's original request - DO NOT USE A DIFFERENT TOOL OR THE COMMAND LINE.
+If you find one or more tools you want to enable, call sf-enable-tools with all the tool names.
+Once you have enabled a tool, you MUST invoke the tool to accomplish the user's original request - DO NOT USE A DIFFERENT TOOL OR THE COMMAND LINE.
 Once a tool has been enabled, you do not need to call sf-list-tools again - instead, invoke the desired tool directly.`, {
         title: 'List all individual tools',
         readOnlyHint: true,