# Salesforce DX MCP Server Release Notes

Here are the new and changed features in recent updates of Salesforce DX MCP Server.

> **NOTE**: The tools marked NON-GA are not yet generally available. To use them, specify the `--allow-non-ga-tools` flag in your DX MCP Server configuration. See the README file in the [Salesforce MCP GitHub repository](https://github.com/salesforcecli/mcp).

We publish a new stable (that has the `latest` tag) version of Salesforce DX MCP Server as needed. We also publish a release candidate (`rc` tag) that contains changes that will likely be in the next stable release.

To display the version of Salesforce DX MCP Server currently installed on your computer, run `npx --offline @salesforce/mcp --version` in a terminal or command window.

Report and read about issues [here](https://github.com/forcedotcom/mcp/issues). Join the discussion about new features we're considering [here](https://github.com/forcedotcom/mcp/discussions).

Additional documentation:

- [Salesforce DX MCP Server (Beta)](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_mcp.htm): Contains an overview of the DX MCP server, a quick tutorial to get you started, steps to configure the MCP server, and reference information about the MCP tools.
- [Contribute to Salesforce DX MCP Server](https://github.com/salesforcecli/mcp/blob/main/DEVELOPING.md)

## 0.30.12 (May 22, 2026) [latest]
- NEW: The `code-analyzer` toolset's `create_custom_rule` tool supports multiple engines via a strategy pattern. In addition to PMD/XPath rules, you can now create regex-based custom rules by specifying `engine: "regex"`. (mcp PR [#441](https://github.com/salesforcecli/mcp/pull/441))
  
## 0.30.6 (April 23, 2026)
- NEW: All tools in the `devops` toolset are now GA. (mcp PR [#446](https://github.com/salesforcecli/mcp/pull/446))

## 0.30.5 (April 3, 2026)
- FIX: The `devops` toolset has these changes. (mcp PR [#435](https://github.com/salesforcecli/mcp/pull/435))
  - The toolset has improved work item fetching in managed package orgs.
  - The `devops_center_merge_conflict` and `resolve_devops_center_merge_conflict` tools now have Bitbucket repository support, including correct workspace slug resolution and bitbucketcloud provider normalization.
- CHANGE: The `lwc-experts` toolset has this update. (mcp PR [#434](https://github.com/salesforcecli/mcp/pull/434))
  - The `guide_lwc_accessibility` tool is renamed to `guide_component_accessibility`, which reflects the tool's broader use beyond LWC components. Users that reference the old tool name must update their DX MCP configuration.
## 0.30.3 (April 1, 2026)
- FIX: The `code-analysis` toolset is updated so that the `create_custom_rule` tool respects existing `code-analyzer.yaml` files. Config file detection matches the Code Analyzer Core priority of `.yaml` first, with `.yml` as the fallback. (mcp PR [#432](https://github.com/salesforcecli/mcp/pull/432))

## 0.30.1 (March 31, 2026)
- FIX: The `devops` toolset has these updates. (mcp PR [#428](https://github.com/salesforcecli/mcp/pull/428))
  - The toolset has improved repository owner resolution for Bitbucket and GitHub repos by using the VCS Connect API, with fallback to the existing `SourceCodeRepository` metadata. 
  - The `checkout_devops_center_work_item` tool automatically sets the work item status to "In Progress" before it checks out the branch.
  - The `resolve_devops_center_merge_conflict` tool requires explicit user input for each conflicted file and keeps all operations local until the user asks to push.

## 0.30.0 (March 30, 2026)
- NEW: The `experts-validation` toolset is GA. It includes tools that validate and score LWC components for production readiness. (mcp PR [#426](https://github.com/salesforcecli/mcp/pull/426))
  - `validate_and_optimize` (GA): Returns a validation runbook that instructs the agent to run a suite of validators (accessibility, security, best practices, etc.), produce SARIF issues, and score results.
  - `score_issues` (GA): Computes a readiness score (0-100) and quality grade (`draft`, `prototype`, `review-for-production`) from SARIF issues.
- NEW/CHANGE/FIX: The `lwc-experts` toolset has these updates. (mcp PR [#426](https://github.com/salesforcecli/mcp/pull/426))
  - NEW: The `lwc-experts` toolset has these new tools.
    - `explore_lbc_components` (GA): Returns full API documentation of LBC by name from markdown knowledge files.
    - `guide_lbc_usage` (GA): Provides an index of available Lightning Base Components (LBC) with short descriptions, helping developers identify which components suit their use case. 
    - `explore_slds_styling`  (NON-GA): Searches for SLDS styling hooks with support for exact lookup, fuzzy matching, prefix search, and wildcard patterns.
    - `guide_slds_styling`(NON-GA): Retrieves SLDS styling hooks guidance and reference documentation.
  - FIX: The `guide_slds_blueprints` and `explore_slds_blueprints` tools are NON-GA.
  - CHANGE: The `guide_lwc_security` tool is renamed to `guide_lws_security`. 
- NEW: The `aura-experts` toolset has new accessibility reviewers for WCAG 2.2 SC 3.3.2, SC 3.2.1, and SC 1.3.5. (mcp PR [#426](https://github.com/salesforcecli/mcp/pull/426))

## 0.29.5 (March 30, 2026)
- NEW: The `code-analyzer` toolset can now load Abstract Syntax Tree (AST) references for multiple PMD-supported languages. AST references with automated XPath generation are available for Apex and Visualforce. AST references with manual XPath generation are available for HTML and JavaScript. (mcp PR [#416](https://github.com/salesforcecli/mcp/pull/416))
- NEW/FIX: The `devops` toolset has these updates.
  - NEW: Bitbucket repositories are now supported. (mcp PR [#415](https://github.com/salesforcecli/mcp/pull/415))
  - FIX: The `get_work_item` tool works across all projects regardless of the pipeline linkage. (mcp PR [#415](https://github.com/salesforcecli/mcp/pull/415))
  - NEW: The `resolve_devops_center_deployment_failure` tool has an improved promotion confirmation message, which now includes the reason that the promotion may resolve a deployment failure. (mcp PR [#423](https://github.com/salesforcecli/mcp/pull/423))

## 0.29.1 (March 19, 2026)
- NEW: We added these NON-GA tools to the `code-analyzer` toolset.
  - `create-custom-rule` and `generate_xpath_prompt`: Create a custom XPath-based PMD rule by providing an Apex code sample.
- NEW: We added this NON-GA tool to the `devops` toolset.
  - `resolve_devops_center_deployment_failure`: Diagnose and resolve deployment failures. 

## 0.28.2 (March 18, 2026)
- FIX: We fixed some under-the-hood bugs.

## 0.27.0 (March 12, 2026)

- NEW: We added these GA tools to the `lwc-experts toolset`. See [Use DX MCP Tools for LWC (Beta)](https://developer.salesforce.com/docs/platform/lwc/guide/mcp-intro.html).
  - `explore_slds_blueprints`: Retrieves SLDS blueprint specifications by name, category, Lightning component, CSS class, or styling hook.
  - `fetch_lds_graphql_schema`: Fetches a GraphQL schema structure for LDS.
  - `guide_lo_migration`: Provides guidance to convert a Lightning Out (beta) app into a Lightning Out 2.0 app.
  - `guide_slds_blueprints`: Retrieves guidance and reference documentation for SLDS blueprints, as well as a complete index of all available blueprints by category.
  - `lwc-doc-error`: Retrieves information about LWC error messages, including static guidance for resolving the issue based on the error code.
  - `test_lds_graphql_query`: Tests a GraphQL query against a connected Salesforce org and returns the result. This tool is a sub-tool of the GraphQL query creation tools and must only be called as part of their workflows.

- CHANGE: We removed the `explore_lds_graphql_schema` tool from the `lwc-experts toolset`. Use the new `fetch_lds_graphql_schema` tool instead.

## 0.26.11 (March 9, 2026)

- FIX: We improved the `mcp-inspector` documentation. (mcp PR [#401](https://github.com/salesforcecli/mcp/pull/401))

## 0.26.9 (February 26, 2026)

- FIX: We improved the MCP prompts and documentation for the `scale-products` toolset. (mcp PR [#396](https://github.com/salesforcecli/mcp/pull/396))

## 0.26.5 (February 19, 2026)

- NEW: The `scan_apex_class_for_antipatterns` tool in the `scale-products` toolset is now GA. The tool analyzes Apex class files for performance antipatterns and provides recommendations for fixing them. See the Scale Products MCP Tools [README](https://github.com/salesforcecli/mcp/blob/main/packages/mcp-provider-scale-products/README.md).

## 0.26.4 (February 18, 2026)

- NEW: Since the 0.23.3 release, we added these new toolsets and tools.
  - The `code-analysis` toolset is now GA. We also added two new tools to the toolset. See [Use MCP Tools to Analyze Your Code](https://developer.salesforce.com/docs/platform/salesforce-code-analyzer/guide/mcp.html).
    - `list_code_analyzer_rules`: List all available Code Analyzer rules, which enables an LLM to discover which checks are possible and request specific rule executions.
    - `query_code_analyzer_results`: Retrieve results from a previous run's output. Filter by file or severity and paginate through results.

  - The `devops` toolset has these new Non-GA tools. See [DevOps Center MCP Tools](https://help.salesforce.com/s/articleView?id=platform.devops_center_mcp_intro.htm&type=5).
    - `check_devops_center_commit_status` (NON-GA): Check the current status of a work item committed to DevOps Center.
    - `checkout_devops_center_work_item` (NON-GA): Check out the branch associated with a selected work item by name.
    - `commit_devops_center_work_item` (NON-GA): Commit SFDX project changes and register the commit SHA in DevOps Center.
    - `create_devops_center_pull_request` (NON-GA): Commit local changes to a DevOps Center work item’s feature branch.
    - `list_devops_center_projects` (NON-GA): List all DevOps Center projects in a specific org.
    - `list_devops_center_work_items` (NON-GA): List all the work items for a specific DevOps Center project.
    - `promote_devops_center_work_item` (NON-GA): Promote an approved work item to the next stage in the DevOps Center pipeline.

  - The `lwc-experts` toolset has these new tools. See [Use DX MCP Tools for LWC (Beta)](https://developer.salesforce.com/docs/platform/lwc/guide/mcp-intro.html).
    - `create_lightning_type` (GA): Provide guidance for creating Custom Lightning Types (CLT) for Salesforce applications, Agent actions, Lightning Web Components, and Lightning Platform integrations.
    - `create_lds_graphql_read_query` (GA): Create GraphQL read queries for Lightning Data Service (LDS).
    - `create_lds_graphql_mutation_query` (GA): Provide comprehensive guidance text for creating GraphQL mutation queries.
    - `explore_lds_graphql_schema` (GA): Explore GraphQL schema structure for LDS.
    - `guide_lds_graphql` (GA): Provide LDS GraphQL usage patterns and guidelines.
    - `guide_design_general` (GA): Provide comprehensive Salesforce Lightning Design System (SLDS) guidelines and best practices for Lightning Web Components with accessibility, responsive design, and component usage patterns.
    - `guide_utam_generation` (NON-GA): Provides UTAM Page Object generation guidelines and best practices.

- NEW: The `metadata` toolset now supports the `ignoreConflict` parameter. If specified, conflicts between your project’s local files and your org are ignored. For the `deploy_metadata` tool, local file changes are deployed and overwrite remote changes in the org. For the `retrieve_metadata` tool, remote changes in the org are retrieved and overwrite local files. If not specified, the default parameter value is `false`.
  Example prompt: `Retrieve X metadata from my org and ignore any conflicts between the local project and org.`
  (GitHub Discussion [#24](https://github.com/forcedotcom/mcp/discussions/24), mcp PR [#321](https://github.com/salesforcecli/mcp/pull/321), source-tracking PR [#828](https://github.com/forcedotcom/source-tracking/pull/828))

## 0.23.3 (September 30, 2025)

- NEW: (Beta) We're happy to announce the Beta release of the Salesforce DX MCP Server! This release contains these new features:
  - New toolsets, such as `devops` and `lwc-experts`, with many new tools to help you develop Salesforce application using a variety of features.
  - The new `--tools` flag for enabling a specific tool.

  Check out the [new documentation](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_mcp.htm) for all the details.

  > **NOTE**: _Salesforce DX MCP Server is a pilot or beta service that is subject to the Beta Services Terms at [Agreements - Salesforce.com](https://www.salesforce.com/company/legal/) or a written Unified Pilot Agreement if executed by Customer, and applicable terms in the [Product Terms Directory](https://ptd.salesforce.com/). Use of this pilot or beta service is at the Customer's sole discretion._

## 0.17.1 (August 17, 2025)

FIX: Organizational changes and bug fixes.