@salesforce/mcp 0.26.1 → 0.26.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -48,17 +48,19 @@ Here's an example for VS Code with Copilot in which you create and update a `.vs
48
48
  }
49
49
  ```
50
50
 
51
- The `args` format shown in the preceding example is the same for all MCP clients; it's how you customize the DX MCP Server for your particular environment. Notes:
51
+ The `args` format shown in the preceding example is the same for all MCP clients; it's how you customize the DX MCP Server for your particular environment.
52
52
 
53
+ **Notes**:
53
54
  - The `"-y", "@salesforce/mcp"` part tells `npx` to automatically install the `@salesforce/mcp` package instead of asking permission. Don't change this.
54
- - See the *Reference* sections below for the possible flags you can pass the `args` option, and possible values you can pass to the `--orgs`, `--toolsets`, and `--tools` flags.
55
+ - For possible flags that you can pass to the `args` option, and the possible values that you can pass to the `--orgs`, `--toolsets`, and `--tools` flags, see these sections:
56
+ - [Available Flags for the `args` Option](./README.md#available-flags-for-the-args-option)
57
+ - [Configure Orgs](./README.md#configure-orgs)
58
+ - [Configure Toolsets](./README.md#configure-toolsets)
59
+ - [Configure Tools](./README.md#configure-tools)
55
60
  - When writing the `args` option, surround both the flag names and their values in double quotes, and separate all flags and values with commas. Some flags are Boolean and don't take a value.
56
61
  - The preceding example shows three flags that take a string value (`--orgs`, `--toolsets`, and `--tools`) and one Boolean flag (`--allow-non-ga-tools`). This configuration starts a DX MCP Server that enables all the MCP tools in the `orgs`, `metadata`, `data`, and `users` toolsets and a specific tool called `run_apex_tests`. It also enables tools in these configured toolsets that aren't yet generally available.
57
62
 
58
- <details>
59
- <summary>Reference: MCP Client Configurations</summary>
60
-
61
- ## MCP Client Configurations
63
+ ## MCP Client Configurations
62
64
 
63
65
  Here are examples of configuring the Salesforce DX MCP Server in various MCP clients.
64
66
 
@@ -124,10 +126,6 @@ For these other clients, refer to their documentation for adding MCP servers and
124
126
  - [Zed](https://github.com/zed-industries/zed)
125
127
  - [Trae](https://docs.trae.ai/ide/model-context-protocol?_lang=en)
126
128
 
127
- </details>
128
- <details>
129
- <summary>Reference: Available Flags for the `args` Option</summary>
130
-
131
129
  ## Available Flags for the "args" Option
132
130
 
133
131
  These are the flags that you can pass to the `args` option.
@@ -142,11 +140,6 @@ These are the flags that you can pass to the `args` option.
142
140
  | `--allow-non-ga-tools` | Boolean flag to allow the DX MCP Server to use both the generally available (GA) and NON-GA tools that are in the toolsets or tools you specify. | No | By default, the DX MCP server uses only the tools marked GA. |
143
141
  | `--dynamic-tools` | (experimental) Boolean flag that enables dynamic tool discovery and loading. When specified, the DX MCP server starts with a minimal set of core tools and loads new tools as needed. | No| This flag is useful for reducing the initial context size and improving LLM performance. Dynamic tool discovery is disabled by default.<br/> <br/>**NOTE:** This feature works in VSCode and Cline but may not work in other environments.|
144
142
 
145
- </details>
146
- <details>
147
-
148
- <summary>Reference: Configure Orgs</summary>
149
-
150
143
  ## Configure Orgs
151
144
 
152
145
  The Salesforce MCP tools require an org, and so you must include the required `--orgs` flag to specify at least one authorized org when you configure the MCP server. Separate multiple values with commas.
@@ -162,11 +155,6 @@ These are the available values for the `--orgs` flag:
162
155
  | `ALLOW_ALL_ORGS` | Allow access to all authorized orgs. Use this value with caution.|
163
156
  | `<username or alias>` | Allow access to a specific org by specifying its username or alias.|
164
157
 
165
- </details>
166
-
167
- <details>
168
- <summary>Reference: Configure Toolsets and Tools</summary>
169
-
170
158
  ## Configure Toolsets
171
159
 
172
160
  The Salesforce DX MCP Server supports **toolsets** - a way to selectively enable different groups of MCP tools based on your needs. This allows you to run the MCP server with only the tools you require, which in turn reduces the context.
@@ -181,6 +169,7 @@ These are the available toolsets.
181
169
  | `aura-experts` | [Tools which provides Aura component analysis, blueprinting, and migration expertise.](README.md#aura-experts-toolset)|
182
170
  | `code-analysis` | [Tools for static analysis of your code using Salesforce Code Analyzer](README.md#code-analysis-toolset)|
183
171
  | `data` | [Tools to manage the data in your org, such as listing all accounts.](README.md#data-toolset)|
172
+ | `enrichment` | [Tools to enrich metadata for components in your org.](README.md#enrichment-toolset)|
184
173
  | `lwc-experts` | [Tools to assist with LWC development, testing, optimization, and best practices.](README.md#lwc-experts-toolset)|
185
174
  | `metadata` | [Tools to deploy and retrieve metadata to and from your org and your DX project.](README.md#metadata-toolset)|
186
175
  | `mobile` | [Tools for mobile development and capabilities.](README.md#mobile-toolset)|
@@ -289,6 +278,7 @@ Orchestrates the complete Aura to LWC migration workflow. Provides end-to-end gu
289
278
  - `guide_utam_generation` - (NON-GA) Provides UTAM Page Object generation guidelines and best practices.
290
279
  - `create_lightning_type` - (GA) Provides guidance for creating Custom Lightning Types (CLT) for Salesforce applications,
291
280
  * Einstein Agent actions, Lightning Web Components, and Lightning Platform integrations.
281
+
292
282
  #### Workflow Tools
293
283
 
294
284
  - `orchestrate_lwc_component_creation` - (GA) Step-by-step component creation workflow guidance
@@ -323,4 +313,8 @@ Orchestrates the complete Aura to LWC migration workflow. Provides end-to-end gu
323
313
 
324
314
  - `scan_apex_class_for_antipatterns` - (NON-GA) Analyzes Apex class files for performance antipatterns and provides recommendations for fixing them. Currently detects: (1) Schema.getGlobalDescribe() usage with optimized alternatives, (2) SOQL queries without WHERE or LIMIT clauses, (3) SOQL queries with unused fields (with fix generation). Distinguishes between different severity levels (e.g., usage in loops vs. ordinary usage). Requires an absolute path to the Apex class file.
325
315
 
316
+ ### Enrichment Toolset
317
+
318
+ - `enrich_metadata` - (NON-GA) Enrich metadata from your org in your DX project.
319
+
326
320
  </details>
package/lib/registry.js CHANGED
@@ -20,6 +20,7 @@ import { AuraExpertsMcpProvider } from '@salesforce/mcp-provider-aura-experts';
20
20
  import { MobileWebMcpProvider } from '@salesforce/mcp-provider-mobile-web';
21
21
  import { DevOpsMcpProvider } from '@salesforce/mcp-provider-devops';
22
22
  import { ScaleProductsMcpProvider } from '@salesforce/mcp-provider-scale-products';
23
+ import { EnrichMetadataMcpProvider } from '@salesforce/mcp-provider-metadata-enrichment';
23
24
  /** -------- ADD McpProvider INSTANCES HERE ------------------------------------------------------------------------- */
24
25
  export const MCP_PROVIDER_REGISTRY = [
25
26
  new DxCoreMcpProvider(),
@@ -29,6 +30,7 @@ export const MCP_PROVIDER_REGISTRY = [
29
30
  new MobileWebMcpProvider(),
30
31
  new DevOpsMcpProvider(),
31
32
  new ScaleProductsMcpProvider(),
33
+ new EnrichMetadataMcpProvider(),
32
34
  // Add new instances here
33
35
  ];
34
36
  //# sourceMappingURL=registry.js.map