salesforce-metadata-mcp 2.4.0 → 2.5.1

package/CHANGELOG.md

@@ -1,5 +1,85 @@
 # Changelog
 
+## [2.5.1] - 2026-05-28
+
+### Documentation
+- Rewrote `TOOLS.md` as a comprehensive reference covering all 200+ tools (was 193 lines covering ~8 tools; now 2,100+ lines covering all 207 tools with parameters and example prompts)
+
+---
+
+## [2.5.0] - 2026-05-28
+
+### New Tools — 45 Additions Across 11 Categories
+
+#### Admin & Org Management (6 new)
+- `sf_create_user_role_hierarchy` — Create a UserRole in the Salesforce role hierarchy with optional parent role
+- `sf_reset_user_password` — Reset a user's password and send a password-reset email
+- `sf_freeze_user` — Freeze or unfreeze a user account (blocks login without deactivating)
+- `sf_create_territory` — Create an Enterprise Territory Management (ETM) Territory2
+- `sf_assign_territory_to_user` — Assign a user to a Territory2 via UserTerritory2Association
+- `sf_create_forecast_hierarchy` — Configure a Collaborative Forecasting hierarchy manager relationship
+
+#### Object Schema (5 new)
+- `sf_delete_custom_object` — Permanently delete a custom object and all its records (destructive)
+- `sf_delete_custom_field` — Permanently delete a custom field from an object (destructive)
+- `sf_create_rollup_summary_field` — Create a Roll-Up Summary field (COUNT/SUM/MIN/MAX) on a master object
+- `sf_create_external_id_field` — Create an External ID indexed field for upsert operations
+- `sf_enable_object_features` — Enable history tracking, activities, reports, search, feeds, and Bulk API on a custom object
+
+#### Automation & Flows (4 new)
+- `sf_update_flow` — Update a Flow's label, description, or API version
+- `sf_clone_flow` — Clone a Flow to a new API name and label
+- `sf_create_flow_test` — Create a Flow Interview Test definition for the Flow Test Manager
+- `sf_create_invocable_action` — Register a custom Invocable Action wrapping an @InvocableMethod Apex class
+
+#### Apex Development (5 new)
+- `sf_search_apex` — Search Apex class and trigger source code for a keyword across the org
+- `sf_get_apex_logs` — List recent Apex debug log entries with metadata (operation, duration, size)
+- `sf_get_apex_log_body` — Retrieve the full content of an Apex debug log by ID
+- `sf_create_apex_batch` — Generate and deploy a complete Database.Batchable Apex batch class
+- `sf_create_apex_scheduler` — Generate and deploy a Schedulable Apex class, with optional immediate scheduling
+
+#### Deployment & Environment Management (5 new)
+- `sf_rollback_deployment` — Cancel an in-progress metadata deployment by async job ID
+- `sf_create_scratch_org` — Create a new scratch org using SF CLI (requires Dev Hub)
+- `sf_create_sandbox` — Create a new sandbox (Developer, Developer_Pro, Partial, or Full)
+- `sf_refresh_sandbox` — Refresh an existing sandbox to match the current production state
+- `sf_export_package_xml` — Generate a package.xml manifest by listing all components of specified metadata types
+
+#### Experience Cloud (3 new)
+- `sf_create_experience_container` — Create a container region within an Experience Cloud page
+- `sf_set_experience_site_login` — Configure login, self-registration, and SSO settings for an Experience site
+- `sf_create_cms_content` — Create a CMS content item in a Salesforce CMS workspace
+
+#### Data Management (4 new)
+- `sf_export_records` — Export Salesforce records as CSV data via SOQL
+- `sf_upsert_record` — Upsert a record using an External ID field for matching
+- `sf_get_record` — Retrieve a single record by 15/18-char ID with optional field selection
+- `sf_search_records` — Cross-object text search using SOSL with configurable search group and object list
+
+#### Integrations & Events (3 new)
+- `sf_create_platform_event_subscription` — Create an Apex trigger subscribing to a Platform Event channel
+- `sf_create_change_data_capture` — Enable Change Data Capture for one or more Salesforce objects
+- `sf_create_rest_resource` — Create and deploy an Apex REST resource (@RestResource) class
+
+#### Monitoring & Observability (4 new)
+- `sf_get_org_limits` — Retrieve current API and governor limit usage via the Limits REST API
+- `sf_get_flow_errors` — Retrieve Flow interview fault records with error messages and related records
+- `sf_get_apex_test_results` — Query Apex test results from recent test runs via Tooling API
+- `sf_get_deployment_history` — Retrieve recent deployment history with status, component counts, and errors
+
+#### Agentforce (3 new)
+- `sf_create_agent_channel` — Create a BotChannel connecting an agent to a deployment channel (Embedded Service, Slack, etc.)
+- `sf_clone_agent` — Clone an Agentforce Agent with all its topics, actions, and planner bundle
+- `sf_export_agent` — Export a complete agent configuration as JSON for documentation or migration
+
+#### OmniStudio (3 new)
+- `sf_export_omnistudio_component` — Export any OmniStudio component as JSON for backup or migration
+- `sf_import_omnistudio_component` — Import an OmniStudio component from previously exported JSON
+- `sf_create_document_generation` — Create an OmniStudio Document Generation configuration (OmniDocumentGenerationConfig)
+
+---
+
 ## [2.4.0] - 2026-05-28
 
 ### New Tools — 14 Additions Across 6 Categories

package/README.md

@@ -1,10 +1,10 @@
 # salesforce-metadata-mcp
 
-[![Version](https://img.shields.io/badge/version-2.4.0-blue.svg)](https://npmjs.com/package/salesforce-metadata-mcp)
+[![Version](https://img.shields.io/badge/version-2.5.1-blue.svg)](https://npmjs.com/package/salesforce-metadata-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)
 
-**The most comprehensive Salesforce MCP server.** 155+ tools for building, configuring, and automating Salesforce orgs directly from Claude or any MCP client — covering metadata, Apex, LWC, Agentforce agents, OmniStudio, OmniChannel, Experience Cloud, Field Service, Messaging, Einstein AI, audit trail, bulk data, users, reports, security, and more.
+**The most comprehensive Salesforce MCP server.** 200+ tools for building, configuring, and automating Salesforce orgs directly from Claude or any MCP client — covering metadata, Apex, LWC, Agentforce agents, OmniStudio, OmniChannel, Experience Cloud, Field Service, Messaging, Einstein AI, audit trail, bulk data, users, reports, security, territories, sandboxes, CDC, REST resources, document generation, and more.
 
 ---
 
@@ -46,6 +46,26 @@ See [SETUP.md](SETUP.md) for all authentication methods and detailed setup instr
 
 ---
 
+## What's New in v2.5.0
+
+45 new tools across 11 categories:
+
+- **Admin & Org Management** — Role hierarchy, reset password, freeze user, ETM territories, forecast hierarchy
+- **Object Schema** — Delete custom objects/fields, roll-up summary fields, external ID fields, enable object features
+- **Automation & Flows** — Update/clone flows, flow tests, custom invocable actions
+- **Apex Development** — Search Apex source code, get/read debug logs, create batch and scheduler classes
+- **Deployment & Environments** — Cancel deployments, create scratch orgs, create/refresh sandboxes, export package.xml
+- **Experience Cloud** — Experience containers, site login config, CMS content creation
+- **Data Management** — Export records to CSV, upsert by external ID, get record by ID, SOSL search
+- **Integrations & Events** — Platform Event trigger subscriptions, CDC enablement, Apex REST resources
+- **Monitoring** — Org limits usage, flow runtime errors, Apex test results, deployment history
+- **Agentforce** — Agent channels, clone agents, export agent configurations
+- **OmniStudio** — Export/import components, document generation templates
+
+See [CHANGELOG.md](CHANGELOG.md) for full release notes.
+
+---
+
 ## What's New in v2.4.0
 
 14 new tools across 6 categories: