salesforce-metadata-mcp 2.5.2 → 2.5.4

package/TOOLS.md

@@ -1,2124 +1,193 @@
 # Tools Reference
 
-Complete documentation for all 200+ tools in `salesforce-metadata-mcp` v2.5.2.
+Complete documentation for all 60+ tools in `salesforce-metadata-mcp`.
 
 ---
 
-## Table of Contents
-
-| Category | Tools |
-|----------|-------|
-| [Objects & Schema](#objects--schema) | 26 tools |
-| [Automation & Flows](#automation--flows) | 15 tools |
-| [Apex & Code](#apex--code) | 15 tools |
-| [LWC & Components](#lwc--components) | 2 tools |
-| [UI & App Builder](#ui--app-builder) | 18 tools |
-| [Security & Permissions](#security--permissions) | 12 tools |
-| [Data Management](#data-management) | 14 tools |
-| [Deployment & Environments](#deployment--environments) | 13 tools |
-| [Integrations & Connectivity](#integrations--connectivity) | 12 tools |
-| [Experience Cloud](#experience-cloud) | 10 tools |
-| [Agentforce](#agentforce) | 16 tools |
-| [OmniStudio](#omnistudio) | 19 tools |
-| [OmniChannel & Service](#omnichannel--service) | 14 tools |
-| [Audit Trail & Monitoring](#audit-trail--monitoring) | 8 tools |
-| [Admin & Org Management](#admin--org-management) | 6 tools |
-| [Einstein & AI](#einstein--ai) | 3 tools |
-| [Reports & Dashboards](#reports--dashboards) | 4 tools |
-| [MCP Server Generation](#mcp-server-generation) | 1 tool |
-
----
-
-## Objects & Schema
+## Objects & Fields
 
 ### sf_create_custom_object
-Creates a Salesforce Custom Object via the Metadata API.
+Creates a new Salesforce Custom Object using the Metadata API.
 
+**Parameters:**
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `fullName` | string | required | API name ending in `__c` (e.g. `Invoice__c`) |
+| `fullName` | string | required | API name ending in `__c`, e.g. `Invoice__c` |
 | `label` | string | required | Singular display label |
 | `pluralLabel` | string | required | Plural display label |
-| `nameFieldType` | `Text\|AutoNumber` | `Text` | Name field type |
-| `autoNumberFormat` | string | — | e.g. `INV-{0000}` |
-| `sharingModel` | string | `ReadWrite` | OWD: `ReadWrite`, `Read`, `Private`, `ControlledByParent` |
-| `deploymentStatus` | string | `Deployed` | `Deployed` or `InDevelopment` |
+| `description` | string | — | Optional description |
+| `nameFieldLabel` | string | `"Name"` | Label for the standard Name field |
+| `nameFieldType` | `Text\|AutoNumber` | `"Text"` | Name field type |
+| `autoNumberFormat` | string | — | Format for AutoNumber, e.g. `INV-{0000}` |
+| `deploymentStatus` | `Deployed\|InDevelopment` | `"Deployed"` | Deployment status |
+| `sharingModel` | `ReadWrite\|Read\|Private\|...` | `"ReadWrite"` | OWD sharing model |
 | `enableActivities` | boolean | `true` | Allow Tasks/Events |
-| `enableHistory` | boolean | `false` | Field history tracking |
+| `enableHistory` | boolean | `false` | Enable field history tracking |
 | `enableReports` | boolean | `true` | Available in Reports |
-| `enableSearch` | boolean | `true` | Global search |
+| `enableSearch` | boolean | `true` | Searchable |
 
-**Examples:** "Create a custom object called Project__c", "Create a Job Application object with AutoNumber name JOB-{0000}"
+**Example prompts:**
+- "Create a custom object called Project__c with plural label Projects"
+- "Create a Job Application object with AutoNumber name format JOB-{0000}"
+- "Create a custom object called Feedback__c with Private sharing and no activities"
 
 ---
 
 ### sf_create_custom_field
-Creates a custom field on an existing object.
+Creates a new field on an existing object.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `objectName` | string | Parent object (e.g. `Account`, `Invoice__c`) |
-| `fieldName` | string | API name ending in `__c` |
+| `objectName` | string | Parent object API name |
+| `fieldName` | string | Field API name ending in `__c` |
 | `label` | string | Display label |
-| `type` | string | `Text`, `Number`, `Currency`, `Picklist`, `Date`, `DateTime`, `Checkbox`, `Lookup`, `MasterDetail`, `LongTextArea`, `Email`, `Phone`, `URL`, `Percent` |
-| `required` | boolean | Required field |
-| `length` | number | Text length (1-255) |
-| `precision` / `scale` | number | For Number/Currency |
-| `picklistValues` | object | `{values:[{fullName,default,label}], restricted, sorted}` |
+| `type` | FieldType | Text, Number, Picklist, Lookup, etc. |
+| `required` | boolean | Is field required |
+| `unique` | boolean | Must values be unique |
+| `length` | number | For Text fields (1-255) |
+| `precision` / `scale` | number | For Number/Currency fields |
+| `picklistValues` | object | Required for Picklist/MultiselectPicklist |
 | `referenceTo` | string | For Lookup/MasterDetail |
+| `deleteConstraint` | string | For Lookup: Cascade/Restrict/SetNull |
 
-**Examples:** "Add a Status picklist to Invoice__c with values Draft, Pending, Approved", "Add an Amount currency field with 2 decimal places"
-
----
-
-### sf_add_picklist_values
-Adds new values to an existing Picklist or MultiselectPicklist field without removing existing values.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectFieldFullName` | string | `ObjectName.FieldName__c` |
-| `values` | array | `[{fullName, label, default}]` |
+**Example prompts:**
+- "Add a Status__c picklist field to Invoice__c with values: Draft, Pending, Approved, Rejected"
+- "Add an Amount__c currency field to Opportunity with 2 decimal places"
+- "Add a lookup from Project__c to Account"
 
 ---
 
 ### sf_create_custom_metadata_type
-Creates a Custom Metadata Type (`__mdt`) for storing deployable configuration data.
+Creates a Custom Metadata Type (__mdt) for storing configuration.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `fullName` | string | API name ending in `__mdt` |
-| `label` / `pluralLabel` | string | Display labels |
+| `label` | string | Singular label |
+| `pluralLabel` | string | Plural label |
+| `description` | string | Optional description |
 | `fields` | array | Custom fields to add |
 
----
-
-### sf_create_custom_metadata_record
-Creates a record in an existing Custom Metadata Type.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `typeName` | string | e.g. `Config__mdt` |
-| `recordName` | string | Record API name |
-| `label` | string | Record label |
-| `values` | array | `[{field, value}]` |
-
----
-
-### sf_create_custom_label
-Creates or updates a Custom Label (translatable text string accessible in Apex, LWC, Flows).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Label API name |
-| `value` | string | Label text |
-| `language` | string | ISO code, e.g. `en_US` |
-| `categories` | string | Optional category tag |
-
----
-
-### sf_create_custom_setting
-Creates a Custom Setting object (`__c`) of Hierarchy or List type.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | API name ending in `__c` |
-| `settingType` | `Hierarchy\|List` | Setting type |
-| `visibility` | `Public\|Protected` | Package visibility |
-| `fields` | array | Fields to add |
-
----
-
-### sf_create_global_value_set
-Creates a Global Value Set (shared picklist) reusable across multiple fields.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | API name |
-| `masterLabel` | string | Display label |
-| `sorted` | boolean | Sort values alphabetically |
-| `values` | array | `[{fullName, label, default}]` |
-
----
-
-### sf_create_record_type
-Creates a Record Type on an object for different page layouts and picklist values.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `fullName` | string | Record type API name |
-| `label` | string | Display label |
-| `businessProcess` | string | Business process name (Opportunity, Lead, Case) |
-| `picklistValues` | array | `[{picklist, values:[]}]` |
-
----
-
-### sf_create_business_process
-Creates a Business Process defining which picklist values are available for a Record Type.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | `Opportunity`, `Lead`, or `Case` |
-| `processName` | string | Process API name |
-| `values` | array | `[{fullName, default}]` |
-
----
-
-### sf_create_page_layout
-Creates a Page Layout defining fields, sections, and related lists on record pages.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `layoutName` | string | Layout API name |
-| `sections` | array | `[{label, columns, fields:[]}]` |
-| `relatedLists` | array | Related list names to include |
-
----
-
-### sf_create_sharing_rule
-Creates a Sharing Rule to extend record access beyond OWD.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `ruleType` | `criteria\|owner` | Criteria-based or ownership-based |
-| `accessLevel` | string | `Read` or `Edit` |
-| `sharedTo` | string | Role, group, or territory to share to |
-| `criteriaItems` | array | For criteria-based rules |
-
----
-
-### sf_create_field_dependency
-Creates a controlling/dependent picklist field dependency.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `controllingField` | string | Controlling field API name |
-| `dependentField` | string | Dependent field API name |
-| `valueSettings` | array | `[{controllingFieldValue, dependentValues:[]}]` |
-
----
-
-### sf_update_custom_object
-Updates properties of an existing custom object (label, plural label, description, feature toggles).
-
----
-
-### sf_update_custom_field
-Updates an existing custom field's label, description, help text, required, or default value.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Parent object |
-| `fieldApiName` | string | Field API name |
-| `label` / `description` / `helpText` | string | Updated values |
-
----
-
-### sf_create_relationship_field
-Creates a Lookup or Master-Detail relationship field.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Child object |
-| `fieldName` | string | Field API name |
-| `relationType` | `Lookup\|MasterDetail` | Relationship type |
-| `referenceTo` | string | Parent object |
-| `deleteConstraint` | string | `Cascade`, `Restrict`, or `SetNull` (Lookup only) |
-
----
-
-### sf_create_formula_field
-Creates a formula field with a calculated value.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `fieldName` | string | Field API name |
-| `returnType` | string | `Text`, `Number`, `Currency`, `Date`, `DateTime`, `Checkbox`, `Percent` |
-| `formula` | string | Formula expression |
-
----
-
-### sf_delete_custom_object ⚠️ Destructive
-Permanently deletes a custom object and all its records via Metadata API `deleteMetadata`.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Full API name ending in `__c` |
-
-> **Warning:** Irreversible. All records, fields, and configurations for the object are deleted.
-
----
-
-### sf_delete_custom_field ⚠️ Destructive
-Permanently deletes a custom field from an object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Parent object |
-| `fieldApiName` | string | Field API name ending in `__c` |
-
----
-
-### sf_create_rollup_summary_field
-Creates a Roll-Up Summary field on a master object (requires master-detail relationship).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Master object |
-| `fieldName` | string | New field name (no `__c`) |
-| `label` | string | Display label |
-| `summaryOperation` | `COUNT\|SUM\|MIN\|MAX` | Aggregation type |
-| `childObjectApiName` | string | Child (detail) object |
-| `fieldToAggregate` | string | Child field to aggregate (not needed for COUNT) |
-| `filterCriteria` | string | Optional SOQL-like filter |
-
-**Example:** "Create a roll-up summary field on Account that sums Opportunity Amount where Stage = 'Closed Won'"
-
----
-
-### sf_create_external_id_field
-Creates an External ID indexed field for upsert operations.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Parent object |
-| `fieldApiName` | string | Field name (no `__c`) |
-| `label` | string | Display label |
-| `fieldType` | `Text\|Number\|Email\|Date` | Field data type |
-| `unique` | boolean | Enforce uniqueness |
-| `caseInsensitive` | boolean | Case-insensitive matching (Text only) |
-
----
-
-### sf_enable_object_features
-Enables optional features on a custom object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | API name ending in `__c` |
-| `enableHistory` | boolean | Field history tracking |
-| `enableActivities` | boolean | Tasks and Events |
-| `enableReports` | boolean | Reports availability |
-| `enableSearch` | boolean | Global search / SOSL |
-| `enableFeeds` | boolean | Chatter feeds |
-| `enableBulkApi` | boolean | Bulk API access |
-
----
-
-### sf_create_validation_rule
-Creates a Validation Rule on any object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `ruleName` | string | Rule API name |
-| `errorConditionFormula` | string | Formula returning `true` when INVALID |
-| `errorMessage` | string | Message shown to user |
-| `errorDisplayField` | string | Field to display error on |
-| `active` | boolean | Active immediately |
-
----
-
-### sf_create_flow
-Creates a Salesforce Flow via the Metadata API. Supports AutoLaunchedFlow, Screen Flow, RecordTriggeredFlow, ScheduledFlow.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `label` | string | Display label |
-| `apiName` | string | API name |
-| `flowType` | string | `AutoLaunchedFlow`, `Screen`, `RecordTriggeredFlow`, `ScheduledFlow` |
-| `triggerObject` | string | For RecordTriggeredFlow |
-| `triggerType` | string | `RecordBeforeSave`, `RecordAfterSave`, `Scheduled` |
-| `elements` | array | Flow elements (Decision, GetRecords, CreateRecords, etc.) |
-| `variables` | array | Flow variables |
-| `status` | string | `Active` or `Draft` |
-
----
-
-### sf_create_approval_process
-Creates a multi-step Approval Process with entry criteria, approvers, and final actions.
-
----
-
-### sf_create_workflow_field_update
-Creates a Workflow Field Update action that sets a field to a value or formula result.
-
----
-
-## Automation & Flows
-
-### sf_activate_flow
-Activates the latest version of a Flow via the Tooling API.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `flowApiName` | string | Flow API name |
-
----
-
-### sf_update_flow
-Updates a Flow's label, description, or API version.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `flowApiName` | string | Flow API name |
-| `label` | string | New label (optional) |
-| `description` | string | New description (optional) |
-| `apiVersion` | string | New API version (optional) |
-
----
-
-### sf_clone_flow
-Creates a copy of an existing Flow with a new API name.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sourceFlowApiName` | string | Source flow to copy |
-| `newFlowApiName` | string | New flow API name |
-| `newLabel` | string | New display label |
-| `activateClone` | boolean | Activate immediately (default: `false`) |
-
----
-
-### sf_create_flow_test
-Creates a Flow Interview Test definition for the Flow Test Manager.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `flowApiName` | string | Flow to test |
-| `testName` | string | Test API name |
-| `label` | string | Display label |
-| `testInputs` | array | `[{variableName, value}]` |
-| `testAssertions` | array | `[{variableName, operator, expectedValue}]` |
-
----
-
-### sf_create_invocable_action
-Registers a custom Invocable Action wrapping an `@InvocableMethod` Apex class.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `actionName` | string | Unique API name |
-| `label` | string | Display name in Flow Builder |
-| `apexClassName` | string | Apex class with `@InvocableMethod` |
-
----
-
-### sf_create_email_alert
-Creates a Workflow Email Alert for use in Flows, Approval Processes, or Workflow Rules.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Parent object |
-| `alertName` | string | Alert API name |
-| `template` | string | Email template API name |
-| `recipients` | array | `[{type, recipient}]` — type: `user`, `role`, `email` |
-
----
-
-### sf_create_platform_event
-Creates a Platform Event object (`__e`) for event-driven architecture.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | API name ending in `__e` |
-| `publishBehavior` | string | `PublishAfterCommit` or `PublishImmediately` |
-| `fields` | array | Event payload fields |
-
----
-
-### sf_create_assignment_rule
-Creates an Assignment Rule for Leads or Cases to auto-route to owners/queues.
-
----
-
-### sf_create_escalation_rule
-Creates a Case Escalation Rule that reassigns unresolved cases after a timeout.
-
----
-
-### sf_create_auto_response_rule
-Creates an Auto-Response Rule for Web-to-Lead or Web-to-Case confirmation emails.
-
----
-
-### sf_create_matching_rule
-Creates a Matching Rule to detect potential duplicate records.
-
----
-
-### sf_create_duplicate_rule
-Creates a Duplicate Rule using Matching Rules to block or warn on duplicates.
-
----
-
-### sf_create_apex_email_service
-Creates an Apex Email Service that processes inbound emails via an `InboundEmailHandler` class.
-
----
-
-### sf_create_scheduled_job
-Schedules an existing Schedulable Apex class on a cron expression.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Schedulable Apex class name |
-| `jobName` | string | Scheduled job display name |
-| `cronExpression` | string | Cron expression, e.g. `0 0 2 * * ?` |
-
----
-
-### sf_create_quick_action
-Creates a Quick Action (global or object-specific) for record creation, updates, logging calls, or launching flows.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `actionName` | string | API name |
-| `actionType` | string | `Create`, `Update`, `LogACall`, `SendEmail`, `Flow` |
-| `objectApiName` | string | Object (omit for global) |
-| `targetObject` | string | Object to create for Create type |
+**Example prompts:**
+- "Create a Feature_Flag__mdt Custom Metadata Type with a Boolean field IsEnabled__c"
+- "Create an Integration_Config__mdt type with fields for endpoint URL and API key"
 
 ---
 
-## Apex & Code
-
 ### sf_create_apex_class
-Deploys an Apex class via Metadata API zip deploy.
+Deploys an Apex class to the org via Metadata API zip deploy.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `className` | string | Class name |
+| `className` | string | Class name (no __c) |
 | `classBody` | string | Full Apex source code |
-| `apiVersion` | string | Default `62.0` |
-
-**Examples:** "Create an AccountService Apex class", "Create a batch class that deletes records older than 2 years"
-
----
-
-### sf_create_apex_trigger
-Deploys an Apex Trigger on any object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `triggerName` | string | Trigger name |
-| `objectName` | string | SObject to trigger on |
-| `events` | array | `[before insert, after update, ...]` |
-| `triggerBody` | string | Code inside the trigger body |
-
----
-
-### sf_create_apex_test_class
-Deploys an Apex Test class and optionally runs it immediately.
+| `apiVersion` | string | API version, default `62.0` |
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Test class name |
-| `classBody` | string | Full test class source |
-| `runAfterDeploy` | boolean | Run tests immediately after deploy |
-
----
+**Example prompts:**
+- "Create an Apex class called AccountService with a method to get all active accounts"
+- "Create a Batch Apex class called DataCleanupBatch that deletes records older than 2 years"
+- "Create a Schedulable class called NightlyReport that generates a report email"
 
-### sf_run_apex_tests
-Runs one or more Apex test classes and returns pass/fail results.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `testClasses` | array | Class names to run |
-| `waitMinutes` | number | Timeout (default 5) |
+**Expected output:** Deploy job ID and success/failure message with any compile errors.
 
 ---
 
 ### sf_execute_anonymous_apex
-Executes Apex code immediately via Tooling API `executeAnonymous`.
+Executes Apex code immediately via Tooling API.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `apexCode` | string | Apex code to execute |
 
-**Examples:** "Run Apex to set all Contact emails to lowercase", "Execute System.debug(UserInfo.getUserName())"
-
----
+**Example prompts:**
+- "Run this Apex to update all Contact email addresses to lowercase"
+- "Execute: System.debug(UserInfo.getUserName());"
+- "Run anonymous Apex to backfill the missing CreatedDate__c field on all Account records"
 
-### sf_update_apex_class
-Redeploys an existing Apex class with new source code (full replacement).
+**Expected output:** Success/failure, compile errors if any, and debug log if present.
 
 ---
 
-### sf_get_apex_class
-Retrieves the source code and metadata of an Apex class via Tooling API.
+### sf_create_lwc
+Deploys a Lightning Web Component via Metadata API.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `className` | string | Class name |
-
----
-
-### sf_get_code_coverage
-Retrieves Apex code coverage percentages from the last test run.
+| `componentName` | string | camelCase name, e.g. `accountCard` |
+| `html` | string | Full HTML template content |
+| `javascript` | string | Full JS controller content |
+| `css` | string | Optional CSS |
+| `targets` | array | Where to place the component |
+| `isExposed` | boolean | Available in App Builder |
+| `apiVersion` | string | Default `62.0` |
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Filter by class name (optional) |
+**Example prompts:**
+- "Create an LWC called opportunityList that shows a table of open opportunities"
+- "Create a contact card LWC with name, email, phone and make it available on Record Pages"
+- "Create an LWC Flow Screen component for collecting address information"
 
 ---
 
-### sf_create_visualforce_page
-Deploys a Visualforce page via Metadata API.
+### sf_create_agent (Agentforce)
+Creates an Agentforce Einstein Copilot agent.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `pageName` | string | Page name (no spaces) |
-| `markup` | string | Full Visualforce markup |
-
----
-
-### sf_create_aura_component
-Deploys an Aura (Lightning Classic) component bundle.
+| `agentName` | string | Agent API name |
+| `label` | string | Display name |
+| `description` | string | Agent description |
+| `type` | string | `EinsteinCopilot` |
+| `company` | string | Company context |
+| `persona` | string | Agent persona description |
+| `tone` | `Formal\|Neutral\|Casual` | Communication tone |
+| `instructions` | string | System-level instructions |
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `componentName` | string | Component name |
-| `markup` | string | `.cmp` markup |
-| `controller` | string | Optional JS controller |
-| `helper` | string | Optional helper |
-| `style` | string | Optional CSS |
+**Example prompts:**
+- "Create an Agentforce agent called SalesBot for helping sales reps close deals"
+- "Create a customer service agent with a formal tone for handling support cases"
 
 ---
 
-### sf_search_apex
-Searches Apex class and trigger source code for a keyword across the org.
+### sf_deploy_metadata
+Deploys metadata components via SOAP deploy.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `searchTerm` | string | Text to search for (case-insensitive) |
-| `searchIn` | `classes\|triggers\|both` | Where to search (default: `classes`) |
-| `limit` | number | Max results (default 50) |
+| `components` | array | `[{type, name}]` to deploy |
+| `checkOnly` | boolean | Validate without deploying |
+| `runTests` | array | Test classes to run |
+| `rollbackOnError` | boolean | Rollback on any failure |
+| `waitMinutes` | number | Timeout (default 10 min) |
 
-**Example:** "Find all Apex classes that reference the field Annual_Revenue__c"
+**Example prompts:**
+- "Deploy the AccountService Apex class and AccountTrigger to the org"
+- "Validate the deployment of these components without making changes"
+- "Deploy MyFlow and MyClass, running MyClassTest during deployment"
 
 ---
 
-### sf_get_apex_logs
-Lists recent Apex debug log entries.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | Filter by user (optional) |
-| `limit` | number | Max entries (default 20) |
-| `operation` | string | Filter by operation type (optional) |
-
----
-
-### sf_get_apex_log_body
-Retrieves the full content of an Apex debug log.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `logId` | string | 18-char ApexLog record ID |
-| `maxLines` | number | Lines to return (default 500) |
-
----
-
-### sf_create_apex_batch
-Generates and deploys a complete `Database.Batchable` Apex batch class.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Batch class name |
-| `query` | string | SOQL query for `start()` method |
-| `executeBody` | string | Code for `execute()` method body |
-| `finishBody` | string | Optional `finish()` code |
-| `batchSize` | number | Default batch size (1-2000, default 200) |
-
-**Example:** "Create a batch class that sets IsArchived__c = true on Leads last modified over 180 days ago"
-
----
-
-### sf_create_apex_scheduler
-Generates and deploys a `Schedulable` Apex class, with optional immediate scheduling.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Scheduler class name |
-| `executeBody` | string | Code for `execute()` method body |
-| `scheduleOnCreate` | boolean | Also schedule immediately |
-| `cronExpression` | string | Cron schedule (required if `scheduleOnCreate: true`) |
-| `jobName` | string | Scheduled job name |
-
----
-
-## LWC & Components
-
-### sf_create_lwc
-Creates and deploys a Lightning Web Component.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `componentName` | string | camelCase name, e.g. `accountCard` |
-| `html` | string | HTML template |
-| `javascript` | string | JS controller |
-| `css` | string | Optional CSS |
-| `targets` | array | `lightning__AppPage`, `lightning__RecordPage`, `lightning__HomePage`, `lightningCommunity__Page`, `lightning__UtilityBar`, `lightning__FlowScreen` |
-| `isExposed` | boolean | Available in App Builder |
-| `apiVersion` | string | Default `62.0` |
-
-**Examples:** "Create an LWC that shows a table of open opportunities", "Create a contact card component available on Record Pages"
-
----
-
-### sf_update_lwc
-Updates an existing LWC with new HTML, JS, or CSS (full redeploy).
-
----
-
-## UI & App Builder
-
-### sf_create_lightning_app
-Creates a Lightning App with navigation bar, utility bar, and logo.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | App API name |
-| `label` | string | Display name |
-| `navType` | `Standard\|Console` | Navigation type |
-| `navItems` | array | Navigation items (objects, home, reports, etc.) |
-| `utilityItems` | array | Utility bar components |
-
----
-
-### sf_create_tab
-Creates a Custom Tab for a custom object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Tab API name |
-| `sobjectName` | string | Object API name |
-| `motif` | string | Icon, e.g. `Custom64: Coin` |
-
----
-
-### sf_create_compact_layout
-Creates a Compact Layout defining fields shown in the record highlights panel.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Object API name |
-| `fullName` | string | Layout API name |
-| `fields` | array | Up to 10 field API names |
-
----
-
-### sf_assign_compact_layout
-Sets the default Compact Layout for an object.
-
----
-
-### sf_create_list_view
-Creates a List View (saved filter with columns) for any object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Object API name |
-| `fullName` | string | View API name |
-| `label` | string | Display label |
-| `columns` | array | Field API names to show |
-| `filters` | array | `[{field, operation, value}]` |
-| `filterScope` | string | `Everything`, `Mine`, `Queue`, etc. |
-| `sharedTo` | string | `AllUsers`, `Roles`, `Groups` |
-
----
-
-### sf_create_email_template
-Creates an HTML or text email template with merge field support.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | `FolderName/TemplateName` |
-| `subject` | string | Email subject |
-| `htmlValue` | string | HTML body |
-| `body` | string | Plain text body |
-| `type` | string | `html`, `text`, `custom` |
-| `relatedEntityType` | string | Object for merge fields |
-
----
-
-### sf_create_static_resource
-Creates a Static Resource from text content (JS, CSS, JSON, etc.).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Resource name |
-| `content` | string | File content |
-| `contentType` | string | MIME type, e.g. `application/javascript` |
-
----
-
-### sf_create_custom_notification_type
-Creates a Custom Notification Type for in-app and mobile push notifications.
-
----
-
-### sf_create_report_type
-Creates a Custom Report Type defining available objects and fields in Report Builder.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Report type API name |
-| `baseObject` | string | Primary object |
-| `relationships` | array | Related objects to include |
-| `category` | string | `Accounts`, `Opportunities`, etc. |
-
----
-
-### sf_create_dashboard
-Creates a Dashboard with chart, metric, table, and gauge components.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | `FolderName/DashboardName` |
-| `title` | string | Dashboard title |
-| `components` | array | `[{type, reportApiName, header, columnSpan, rowSpan}]` |
-| `runningUser` | string | Running user for shared visibility |
-
----
-
-### sf_update_page_layout
-Updates a Page Layout's label or properties.
-
----
-
-### sf_assign_page_layout
-Assigns a Page Layout to one or more Profiles for an object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectName` | string | Object API name |
-| `layoutName` | string | Layout API name |
-| `profiles` | array | Profile API names |
-
----
-
-### sf_create_lightning_record_page
-Creates a Lightning Record Page (FlexiPage) for an object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `apiName` | string | FlexiPage API name |
-| `label` | string | Display label |
-| `sobjectType` | string | Object API name |
-| `template` | string | `RecordPage_Default`, `RecordPage_OneColumn`, `RecordPage_ThreeColumn` |
-| `regions` | array | `[{name, mode, components:[{name, properties:{}}]}]` |
-
----
-
-### sf_create_lightning_home_page
-Creates a Lightning Home Page (FlexiPage) for a Lightning App.
-
----
-
-### sf_create_lightning_app_page
-Creates a Lightning App Page (FlexiPage) for use as a tab in a Lightning App.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `apiName` | string | FlexiPage API name |
-| `label` | string | Display label |
-| `template` | string | `AppDefaultTemplate`, `OneRegion`, `TwoColumn_LeftSidebar`, `TwoColumn_RightSidebar`, `ThreeColumn` |
-
----
-
-### sf_update_lightning_page
-Updates an existing Lightning Page (FlexiPage) label.
-
----
-
-### sf_assign_lightning_page
-Assigns a Lightning Page to an Experience Cloud site.
-
----
-
-### sf_create_letterhead
-Creates an email Letterhead for Classic email template branding (header/footer colors, fonts, logo).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Letterhead API name |
-| `name` | string | Display name |
-| `headerColor` | string | Hex color, e.g. `#0070D2` |
-| `footerColor` | string | Hex color |
-| `bodyColor` | string | Hex color |
-| `fontName` | string | Font face |
-| `footerText` | string | Optional footer text |
-
----
-
-## Security & Permissions
-
-### sf_create_permission_set
-Creates a Permission Set with object, field, Apex class, and user permissions.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Permission set API name |
-| `label` | string | Display label |
-| `objectPermissions` | array | `[{object, allowRead, allowCreate, allowEdit, allowDelete, viewAllRecords, modifyAllRecords}]` |
-| `fieldPermissions` | array | `[{field, readable, editable}]` |
-| `apexClassAccesses` | array | `[{apexClass, enabled}]` |
-| `userPermissions` | array | `[{name, enabled}]` |
-
----
-
-### sf_update_permission_set
-Adds or modifies object and field permissions on an existing Permission Set.
-
----
-
-### sf_create_permission_set_group
-Creates a Permission Set Group combining multiple Permission Sets.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Group API name |
-| `label` | string | Display label |
-| `permissionSets` | array | Permission set API names to include |
-
----
-
-### sf_create_muting_permission_set
-Creates a Muting Permission Set that removes permissions within a Permission Set Group.
-
----
-
-### sf_assign_permission_set
-Assigns a Permission Set to a user by username or user ID.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `permissionSetName` | string | Permission set API name |
-| `username` | string | User email/username |
-| `userId` | string | User record ID (alternative) |
-
----
-
-### sf_create_role
-Creates a Role in the Salesforce role hierarchy.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Role API name |
-| `name` | string | Display name |
-| `parentRole` | string | Parent role API name (optional) |
-| `opportunityAccessLevel` | string | `Edit`, `Read`, `None` |
-
----
-
-### sf_create_queue
-Creates a Queue for routing records (Cases, Leads, etc.) to teams.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Queue API name |
-| `name` | string | Display name |
-| `email` | string | Queue notification email |
-| `supportedObjects` | array | Object API names the queue supports |
-| `queueMembers` | array | User or group members |
-
----
-
-### sf_create_named_credential
-Creates a Named Credential for authenticated outbound callouts.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Credential API name |
-| `label` | string | Display label |
-| `endpoint` | string | Base URL |
-| `protocol` | string | `NoAuthentication`, `Password`, `OAuth` |
-| `username` / `password` | string | For Password protocol |
-
----
-
-### sf_set_field_level_security
-Sets read/edit FLS for a field across Profiles and/or Permission Sets.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fieldApiName` | string | `ObjectName.FieldName__c` |
-| `profiles` | array | Profile names |
-| `permissionSets` | array | Permission set names |
-| `readable` | boolean | Allow reading |
-| `editable` | boolean | Allow editing |
-
----
-
-### sf_set_org_wide_defaults
-Sets the org-wide default sharing model for an object.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `internalAccess` | string | `Private`, `Read`, `ReadWrite`, `ControlledByParent` |
-| `externalAccess` | string | External sharing setting (optional) |
-
----
-
-### sf_clone_profile
-Creates a new Profile by cloning an existing one.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sourceProfileName` | string | Profile to clone from |
-| `newProfileName` | string | New profile name |
-
----
-
-### sf_update_profile
-Updates object permissions, FLS, tab visibility, and app visibility on an existing Profile.
-
----
-
-## Data Management
-
-### sf_create_user
-Creates a new Salesforce user.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | Must be unique, email-like |
-| `lastName` | string | Last name |
-| `email` | string | Email address |
-| `profileName` | string | Profile display name |
-| `roleApiName` | string | Role DeveloperName (optional) |
-| `firstName` | string | First name (optional) |
-
----
-
-### sf_update_user
-Updates an existing user's properties.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | User to update |
-| `isActive` | boolean | Activate/deactivate |
-| `title` / `department` / `phone` | string | Profile fields |
-
----
-
-### sf_query_records
-Executes a SOQL query and returns results.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `soql` | string | Full SOQL string, OR use individual params: |
-| `objectApiName` | string | Object to query |
-| `fields` | array | Field API names |
-| `whereClause` | string | WHERE condition |
-| `orderBy` | string | ORDER BY clause |
-| `limit` | number | Max records |
-
----
-
-### sf_create_record
-Creates a single SObject record via REST API.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `fields` | object | `{FieldApiName: value}` |
-
----
-
-### sf_update_record
-Updates an existing record by ID.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `recordId` | string | 15 or 18 char record ID |
-| `fields` | object | Fields to update |
-
----
-
-### sf_upsert_record
-Creates or updates a record using an External ID field for matching.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `externalIdField` | string | External ID field API name |
-| `externalIdValue` | string | Value to match on |
-| `fields` | object | Field values to set |
-
----
-
-### sf_get_record
-Retrieves a single record by 15 or 18 char record ID.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `recordId` | string | Record ID |
-| `fields` | array | Fields to return (optional — all if omitted) |
-
----
-
-### sf_delete_record ⚠️
-Deletes a single SObject record by ID.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `recordId` | string | 15 or 18 char record ID |
-
----
-
-### sf_bulk_import_records
-Bulk imports records using Bulk API 2.0 (insert, upsert, update, delete).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object API name |
-| `operation` | string | `insert`, `upsert`, `update`, `delete` |
-| `csvData` | string | CSV with header row |
-| `externalIdField` | string | Upsert key field (for upsert) |
-
----
-
-### sf_export_records
-Exports Salesforce records as CSV data via SOQL.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `soql` | string | SOQL query |
-| `includeHeader` | boolean | Include CSV header (default `true`) |
-| `maxRecords` | number | Max records (default 50000) |
-
----
-
-### sf_search_records
-Cross-object text search using SOSL.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `searchTerm` | string | Text to search |
-| `objects` | array | `[{objectName, fields:[]}]` |
-| `searchGroup` | string | `ALL FIELDS`, `NAME FIELDS`, `EMAIL FIELDS`, `PHONE FIELDS` |
-| `limit` | number | Max per object (default 20) |
-
-**Example:** "Search for 'Acme' across Accounts, Contacts, and Opportunities"
-
----
-
-### sf_send_email
-Sends an email via Salesforce's emailSimple invocable action.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `toAddresses` | array | Recipient email addresses |
-| `subject` | string | Email subject |
-| `body` / `htmlBody` | string | Email body |
-| `whatId` | string | Related record ID (links as activity) |
-| `whoId` | string | Contact/Lead record ID |
-
----
-
-### sf_assign_queue_member
-Adds a user to an existing Queue.
-
----
-
-### sf_create_public_group
-Creates a Public Group for sharing rules or email distribution.
-
----
-
-## Deployment & Environments
-
-### sf_deploy_metadata
-Deploys metadata components via SOAP Metadata API.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `components` | array | `[{type, name}]` to deploy |
-| `checkOnly` | boolean | Validate without deploying |
-| `runTests` | array | Test classes to run |
-| `rollbackOnError` | boolean | Rollback on failure |
-| `testLevel` | string | `RunSpecifiedTests`, `RunLocalTests`, `RunAllTestsInOrg` |
-| `waitMinutes` | number | Timeout (default 10) |
-
----
-
-### sf_validate_deployment
-Validate-only deployment — checks components without making changes.
-
----
-
-### sf_check_deploy_status
-Checks the status of an in-progress deployment by async job ID.
-
----
-
-### sf_retrieve_metadata
-Initiates a metadata retrieve operation and returns the async job ID.
-
----
-
-### sf_list_metadata
-Lists all components of a metadata type in the org (API names, file names, last modified dates).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `metadataType` | string | e.g. `ApexClass`, `Flow`, `CustomObject` |
-
----
-
-### sf_compare_orgs
-Compares metadata between two orgs using SF CLI aliases.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sourceAlias` | string | Source org SF CLI alias |
-| `targetAlias` | string | Target org SF CLI alias |
-| `metadataTypes` | array | Types to compare (default: ApexClass, Flow, CustomObject, PermissionSet, LightningComponentBundle) |
-
-> Requires SF CLI installed and both orgs authenticated via `sf org login`.
-
----
-
-### sf_rollback_deployment
-Cancels an in-progress deployment by async job ID.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `deployId` | string | Async job ID from sf_deploy_metadata |
-
-> Note: Only cancels `Pending` or `InProgress` deployments. Completed deployments cannot be rolled back via API.
-
----
-
-### sf_create_scratch_org
-Creates a scratch org using SF CLI (requires Dev Hub).
-
-| Parameter | Type | Description |
-|-----------|------|---------|
-| `orgAlias` | string | Alias for the new scratch org |
-| `devHubAlias` | string | Dev Hub org alias (default: `DevHub`) |
-| `edition` | string | `Developer`, `Enterprise`, etc. |
-| `duration` | number | Days until expiry (1-30, default 7) |
-| `features` | array | Scratch org features |
-
----
-
-### sf_create_sandbox
-Creates a new sandbox (Developer, Developer_Pro, Partial, or Full).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sandboxName` | string | Sandbox name (max 10 chars) |
-| `sandboxType` | string | `Developer`, `Developer_Pro`, `Partial`, `Full` |
-
----
-
-### sf_refresh_sandbox ⚠️
-Refreshes an existing sandbox to match current production state. **All sandbox data/metadata is lost.**
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sandboxName` | string | Sandbox to refresh |
-
----
-
-### sf_export_package_xml
-Generates a `package.xml` manifest by listing org components.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `metadataTypes` | array | Types to include (default: common types) |
-| `apiVersion` | string | API version for package.xml |
-| `includeAll` | boolean | Use wildcards (`*`) instead of listing components |
-
----
-
-### sf_create_outbound_change_set
-Creates an Outbound Change Set container for sandbox → production deployment.
-
----
-
-### sf_add_to_change_set
-Adds metadata components to an existing Change Set.
-
----
-
-## Integrations & Connectivity
-
-### sf_create_connected_app
-Creates a Connected App for OAuth 2.0 authentication.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | App API name |
-| `label` | string | Display name |
-| `contactEmail` | string | Contact email |
-| `callbackUrls` | array | OAuth callback URLs |
-| `scopes` | array | OAuth scopes: `api`, `web`, `full`, `offline_access`, etc. |
-
----
-
-### sf_create_named_credential
-(See [Security & Permissions](#security--permissions))
-
----
-
-### sf_create_remote_site_setting
-Whitelists an external URL for Apex HTTP callouts.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Setting API name |
-| `url` | string | External URL to whitelist |
-| `isActive` | boolean | Active (default `true`) |
-
----
-
-### sf_create_csp_setting
-Creates a Content Security Policy trusted site for LWC external resources.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `endpointUrl` | string | External URL to trust |
-| `cspDirectives` | array | `connect-src`, `script-src`, `style-src`, `img-src`, `frame-src`, `font-src` |
-
----
-
-### sf_create_external_data_source
-Creates an External Data Source for Salesforce Connect (OData 2.0/4.0, Apex, SimpleURL).
-
----
-
-### sf_create_external_object
-Creates an External Object (`__x`) linked to an External Data Source.
-
----
-
-### sf_create_outbound_message
-Creates a Workflow Outbound Message that POSTs XML to an external SOAP endpoint.
-
----
-
-### sf_create_auth_provider
-Creates an Auth Provider for third-party OAuth 2.0 SSO (Google, Salesforce, custom).
-
----
-
-### sf_create_certificate
-Creates a self-signed Certificate for callout signing, SAML assertions, or Named Credential encryption.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | Certificate API name |
-| `keySize` | `2048\|4096` | Key size |
-| `expirationDate` | string | ISO date, e.g. `2030-01-01` |
-| `privateKeyExportable` | boolean | Allow private key export |
-
----
-
-### sf_create_event_relay
-Creates an EventRelayConfig to relay Platform Events or CDC events to Amazon EventBridge or another event bus.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `eventChannel` | string | Platform Event or CDC channel (e.g. `MyEvent__e`) |
-| `destinationType` | `AmazonEventBridge\|EventBus` | Destination type |
-| `destinationResourceName` | string | ARN or bus name |
-| `state` | `RUN\|STOP\|PAUSE` | Initial relay state |
-
----
-
-### sf_create_platform_event_subscription
-Creates an Apex trigger that subscribes to a Platform Event channel.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `eventApiName` | string | Platform Event API name ending in `__e` |
-| `triggerName` | string | Apex trigger name |
-| `triggerBody` | string | Trigger body code (operates on `List<EventApiName>`) |
-
----
-
-### sf_create_change_data_capture
-Enables Change Data Capture for one or more Salesforce objects.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiNames` | array | Objects to enable CDC for, e.g. `['Account', 'Contact']` |
-
-> After enabling, subscribe to `<ObjectName>ChangeEvent` channels via Streaming API.
-
----
-
-### sf_create_rest_resource
-Creates and deploys an Apex REST resource (`@RestResource`) class.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Apex class name |
-| `urlMapping` | string | URL path, e.g. `/v1/orders/*` |
-| `methods` | array | `GET`, `POST`, `PUT`, `PATCH`, `DELETE` |
-| `getBody` / `postBody` / `putBody` / `deleteBody` | string | Method implementation code |
-
----
-
-## Experience Cloud
-
-### sf_create_experience_site
-Creates an Experience Cloud site using a specified template.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `siteName` | string | Site API name |
-| `label` | string | Display name |
-| `template` | string | `CustomerService`, `Partner`, `LWR`, `Aloha`, `Microsites` |
-| `urlPathPrefix` | string | URL path (e.g. `customers`) |
-| `status` | string | `Live`, `DownForMaintenance`, `UnderConstruction` |
-
----
-
-### sf_create_experience_page
-Creates a page within an existing Experience Cloud site.
-
----
-
-### sf_publish_experience_site
-Publishes a site to make all pending changes live.
-
----
-
-### sf_update_experience_site
-Updates site settings (description, guest access, guest profile).
-
----
-
-### sf_create_navigation_menu
-Creates a Navigation Menu for an Experience Cloud site.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `siteName` | string | Site API name |
-| `menuName` | string | Menu API name |
-| `items` | array | `[{label, type, url, page}]` |
-
----
-
-### sf_add_experience_site_members
-Adds user profiles or permission sets as site member groups.
-
----
-
-### sf_set_experience_site_branding
-Applies branding tokens (colors, fonts, logo) to a site.
-
----
-
-### sf_create_experience_container
-Creates a container region within an Experience Cloud page.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `siteName` | string | Site API name |
-| `pageName` | string | Page name |
-| `containerName` | string | Container API name |
-| `region` | string | Page region: `main`, `sidebar`, `header` |
-
----
-
-### sf_set_experience_site_login
-Configures login, self-registration, and SSO settings for an Experience site.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `siteName` | string | Site API name |
-| `loginPageUrl` | string | Custom login page URL |
-| `selfRegistrationEnabled` | boolean | Allow self-registration |
-| `allowInternalUserLogin` | boolean | Allow internal users |
-| `loginOptions` | array | SSO auth provider names |
-
----
-
-### sf_create_cms_content
-Creates a CMS content item in a Salesforce CMS workspace.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `workspaceName` | string | CMS workspace name |
-| `contentType` | string | `cms_document`, `cms_image`, `news`, or custom type |
-| `title` | string | Content title |
-| `body` | string | Content body |
-| `publishStatus` | `Draft\|Published` | Publication status |
-
----
-
-## Agentforce
-
-> **Creation Order:** flows → actions → topics → planner → agent → activate
-
-### sf_create_agent
-Creates an Agentforce Agent (Bot metadata).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `agentName` | string | Bot API name |
-| `label` | string | Display name |
-| `type` | `EinsteinCopilot\|ExternalCopilot` | Agent type (immutable after creation) |
-| `plannerName` | string | GenAiPlannerBundle API name |
-| `description` | string | Agent description |
-| `persona` | string | Agent persona |
-| `company` | string | Company context |
-| `tone` | `Formal\|Neutral\|Casual` | Communication tone |
-
----
-
-### sf_create_agent_topic
-Creates a Topic (GenAiPlugin) defining an agent's area of expertise.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `topicName` | string | GenAiPlugin API name |
-| `label` | string | Display label |
-| `description` | string | Routing description (how LLM decides to route here) |
-| `scope` | string | Scope of this topic |
-| `instructions` | array | Step-by-step instructions |
-| `actions` | array | Agent action API names to include |
-| `escalationEnabled` | boolean | Allow escalation to human |
-
----
-
-### sf_create_agent_action
-Creates an Agentforce Action (GenAiFunction) linked to a Flow or Apex class.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `actionName` | string | GenAiFunction API name |
-| `label` | string | Display label |
-| `description` | string | LLM-facing description |
-| `invocationTargetType` | `Flow\|ApexClass` | Action backend |
-| `flowApiName` | string | Flow API name (for Flow actions) |
-| `apexClassName` | string | Apex class (for ApexClass actions) |
-| `inputs` | array | `[{name, type, description, required}]` |
-| `outputs` | array | `[{name, type, description}]` |
-
-> Schema files are auto-generated. Without them the LLM cannot invoke the action.
-
----
-
-### sf_create_agent_planner
-Creates a GenAiPlannerBundle connecting topics to the agent's planning engine.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `plannerName` | string | Planner API name |
-| `label` | string | Display label |
-| `topics` | array | GenAiPlugin API names |
-| `dataLibraryName` | string | Knowledge base name (optional) |
-
----
-
-### sf_activate_agent
-Activates an Agentforce Agent.
-
----
-
-### sf_deactivate_agent
-Deactivates an agent (required before modifying topics/actions).
-
----
-
-### sf_get_agent
-Retrieves an agent's full configuration including topics, actions, and planners.
-
----
-
-### sf_list_agents
-Lists all Agentforce Agents in the org.
-
----
-
-### sf_update_agent_topic
-Updates an existing topic's description, instructions, or actions.
-
----
-
-### sf_update_agent_action
-Updates an action and regenerates its LLM-facing input/output schema files.
-
----
-
-### sf_delete_agent
-Deletes an agent and optionally its topics and actions.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `agentApiName` | string | Bot API name |
-| `deleteTopics` | boolean | Also delete GenAiPlugin topics |
-| `deleteActions` | boolean | Also delete GenAiFunction actions |
-
----
-
-### sf_test_agent
-Sends a test message to an agent and returns its response.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `agentApiName` | string | Bot API name |
-| `message` | string | Test message to send |
-
----
-
-### sf_get_agent_logs
-Queries ConversationDefinitionEventLog for agent routing and action execution events.
-
----
-
-### sf_create_agent_channel
-Creates a BotChannel connecting an agent to a deployment channel.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `agentApiName` | string | Bot API name |
-| `channelType` | string | `EmbeddedService`, `Slack`, `MicrosoftTeams`, `WhatsApp`, `SMS`, `CustomChannel` |
-| `channelName` | string | Channel API name |
-| `isActive` | boolean | Activate immediately (default `true`) |
-
----
-
-### sf_clone_agent
-Clones an Agentforce Agent including all topics, actions, and planner bundle.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `sourceAgentApiName` | string | Agent to clone |
-| `newAgentApiName` | string | New agent API name |
-| `newAgentLabel` | string | New display label |
-| `activateClone` | boolean | Activate after creation (default `false`) |
-
----
-
-### sf_export_agent
-Exports a complete agent configuration as JSON (Bot + planner + topics + actions).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `agentApiName` | string | Agent to export |
-
----
-
-## OmniStudio
-
-### FlexCards
-
-#### sf_create_flexcard
-Creates an OmniStudio FlexCard (OmniUiCard metadata).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `cardName` | string | FlexCard API name |
-| `label` | string | Display label |
-| `dataSourceType` | string | `SOQL`, `DataRaptor`, `IntegrationProcedure`, `Apex`, `None` |
-| `dataSourceName` | string | Query, DataRaptor name, or IP key |
-| `fields` | array | Fields to display |
-| `actions` | array | Actions (navigate, launch OmniScript, open URL) |
-
-#### sf_update_flexcard
-Updates an existing FlexCard definition.
-
-#### sf_activate_flexcard
-Activates a FlexCard (sets `isActive=true`).
-
-#### sf_get_flexcard
-Retrieves a FlexCard's full configuration.
-
----
-
-### OmniScripts
-
-#### sf_create_omniscript
-Creates an OmniScript guided interaction flow.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `type` | string | Script type (e.g. `AccountOpening`) |
-| `subType` | string | Script subtype (e.g. `Personal`) |
-| `language` | string | Language code (e.g. `English`) |
-| `isLwcEnabled` | boolean | Deploy as LWC (recommended) |
-| `elements` | array | Script elements (steps, actions, blocks) |
-
-#### sf_update_omniscript
-Updates OmniScript metadata properties.
-
-#### sf_activate_omniscript
-Activates an OmniScript (identified by Type + SubType + Language).
-
-#### sf_get_omniscript
-Retrieves an OmniScript's configuration.
-
----
-
-### DataRaptors
-
-#### sf_create_dataraptor
-Creates a DataRaptor interface for Extract, Transform, or Load operations.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `interfaceName` | string | DataRaptor API name |
-| `interfaceType` | `Extract\|Transform\|Load` | Operation type |
-| `fieldMappings` | array | `[{sourceField, targetField, dataType, formula}]` |
-| `filterCriteria` | string | WHERE clause (Extract only) |
-
-#### sf_get_dataraptor
-Retrieves a DataRaptor's configuration.
-
----
-
-### Integration Procedures
-
-#### sf_create_integration_procedure
-Creates an OmniStudio Integration Procedure (server-side orchestration).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `procedureName` | string | Procedure name |
-| `subType` | string | Sub-type (fullName = Name_SubType) |
-| `elements` | array | `[{name, type, properties}]` — DataRaptor, HTTPAction, Response, Loop, etc. |
-| `isActive` | boolean | Activate immediately |
-
-#### sf_update_integration_procedure / sf_get_integration_procedure / sf_activate_integration_procedure
-Update, retrieve, or activate an Integration Procedure.
-
----
-
-### Calculation Matrix & Procedure
-
-#### sf_create_calculation_matrix
-Creates a Calculation Matrix (decision table) for rule-based lookups.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `matrixName` | string | Matrix API name |
-| `inputVariables` | array | Input variable names |
-| `outputVariables` | array | Output variable names |
-| `rows` | array | `[{inputs:{var:val}, outputs:{var:val}}]` |
-
-#### sf_create_calculation_procedure
-Creates a Calculation Procedure orchestrating multiple calculation steps.
-
----
-
-### Export / Import
-
-#### sf_export_omnistudio_component
-Exports any OmniStudio component's metadata as a JSON string.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `componentType` | string | `FlexCard`, `OmniScript`, `DataRaptor`, `IntegrationProcedure`, `CalculationMatrix`, `CalculationProcedure` |
-| `componentName` | string | Component API name / fullName |
-
-#### sf_import_omnistudio_component
-Imports an OmniStudio component from previously exported JSON.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `componentType` | string | Component type |
-| `exportedJson` | string | JSON from `sf_export_omnistudio_component` |
-| `newComponentName` | string | Optional new name (for renaming on import) |
-
----
-
-#### sf_create_document_generation
-Creates an OmniStudio Document Generation template configuration.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `templateName` | string | Config API name |
-| `label` | string | Display label |
-| `objectApiName` | string | Salesforce object to generate for |
-| `templateType` | `Word\|PDF\|Excel` | Document format |
-| `dataSourceType` | `DataRaptor\|IntegrationProcedure` | Data source type |
-| `dataSourceName` | string | DataRaptor or IP API name |
-
----
-
-## OmniChannel & Service
-
-### sf_create_service_channel
-Creates an OmniChannel Service Channel connecting an object to the routing engine.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `channelName` | string | API name |
-| `channelType` | string | `Case`, `Chat`, `Messaging`, `Voice`, `Email`, `Custom` |
-| `relatedObjectApiName` | string | SObject to route (required for Custom) |
-| `capacity` | number | Max simultaneous items per agent |
-
----
-
-### sf_create_routing_configuration
-Creates a Routing Configuration defining how work is assigned to agents.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `configName` | string | API name |
-| `routingModel` | string | `LeastActive`, `MostAvailable`, `ExternalRouting` |
-| `capacity` | number | Capacity consumed per work item |
-| `priority` | number | Routing priority (1=highest) |
-| `pushTimeout` | number | Seconds before re-queuing unanswered items |
-
----
-
-### sf_create_queue_routing_config
-Links a Routing Configuration to a Queue.
-
----
-
-### sf_create_presence_configuration
-Creates a Presence Configuration controlling which channels agents can handle.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `configName` | string | Config API name |
-| `capacity` | number | Total capacity units |
-| `serviceChannels` | array | Channel API names |
-
----
-
-### sf_create_presence_status
-Creates a Presence Status (Online, Busy, Offline) for agents.
-
----
-
-### sf_assign_presence_status
-Grants access to a Presence Status for Profiles and/or Permission Sets.
-
----
-
-### sf_create_skill
-Creates a Skill for OmniChannel skill-based routing or Field Service.
-
----
-
-### sf_assign_skill_to_agent
-Assigns a Skill to a service agent with a proficiency level.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `skillName` | string | Skill DeveloperName |
-| `username` | string | Agent username |
-| `skillLevel` | number | Proficiency 0-10 |
-
----
-
-### sf_create_service_territory
-Creates a Field Service Service Territory (geographic/organizational area).
-
----
-
-### sf_create_work_type
-Creates a Field Service Work Type with default duration and skill requirements.
-
----
-
-### sf_create_messaging_channel
-Creates a digital messaging channel (SMS, WhatsApp, Facebook, etc.).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `channelName` | string | API name |
-| `channelType` | string | `SMS`, `WhatsApp`, `Facebook`, `AppleBusinessChat`, `WebChat`, etc. |
-| `routingType` | `Queue\|Bot` | Routing destination |
-| `queueName` | string | Queue to route to |
-| `botName` | string | Bot to handle initially |
-
----
-
-### sf_create_chat_button
-Creates a Live Chat button for website embedding.
-
----
-
-### sf_create_embedded_service
-Creates an Embedded Service deployment bundling chat/messaging into a web snippet.
-
----
-
-### sf_create_bot_routing
-Configures an Einstein Bot to transfer conversations to a human agent queue.
-
----
-
-## Audit Trail & Monitoring
-
-### sf_get_setup_audit_trail
-Queries `SetupAuditTrail` for org configuration change history (last 6 months).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `limit` | number | Max records (default 50) |
-| `userId` | string | Filter by user ID |
-| `section` | string | Filter by Setup section |
-| `lookbackDays` | number | Days to look back (default 7) |
-
----
-
-### sf_get_login_history
-Queries `LoginHistory` for user login activity.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | Filter by username |
-| `lookbackHours` | number | Hours to look back (default 24) |
-| `status` | string | `Success`, `Failed`, etc. |
-| `limit` | number | Max records (default 100) |
-
----
-
-### sf_get_event_logs
-Fetches and parses `EventLogFile` entries (Login, API, Report, Flow, Apex, LightningPageView, etc.).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `eventType` | string | Log type (e.g. `Login`, `ApexExecution`, `FlowExecution`) |
-| `lookbackHours` | number | Hours to look back (default 24) |
-| `limit` | number | Max files (default 10) |
-
----
-
-### sf_get_field_history
-Queries field-level change history on a specific record.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `objectApiName` | string | Object with history tracking enabled |
-| `recordId` | string | Record ID to get history for |
-| `limit` | number | Max history entries (default 50) |
-
----
-
-### sf_get_org_limits
-Retrieves current API and governor limit usage via the Limits REST API.
-
-Returns all limits sorted by percent used (most consumed first).
-
----
-
-### sf_get_flow_errors
-Retrieves Flow interview fault records with error messages and related record IDs.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `flowApiName` | string | Filter to specific flow (optional) |
-| `lookbackHours` | number | Hours to look back (default 24) |
-| `limit` | number | Max records (default 50) |
-
----
-
-### sf_get_apex_test_results
-Queries Apex test results from recent test runs via Tooling API.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `className` | string | Filter by test class name (optional) |
-| `outcome` | string | `Pass`, `Fail`, `Skip` (optional) |
-| `limit` | number | Max results (default 100) |
-
----
-
-### sf_get_deployment_history
-Retrieves recent deployment history with status, component counts, and errors.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `limit` | number | Deployments to return (default 20) |
-| `status` | string | Filter: `Succeeded`, `Failed`, `Canceled`, `InProgress` |
-
----
-
-## Admin & Org Management
-
-### sf_create_user_role_hierarchy
-Creates a UserRole in the Salesforce role hierarchy.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `roleName` | string | Role DeveloperName |
-| `label` | string | Display name |
-| `parentRoleName` | string | Parent role API name (omit for top-level) |
-
-> Note: `sf_create_role` in Security also creates roles. `sf_create_user_role_hierarchy` is an alias with the same outcome.
-
----
-
-### sf_reset_user_password
-Resets a user's password and sends a password-reset email.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | User email/username |
-| `userId` | string | User record ID (alternative) |
-| `sendEmail` | boolean | Send reset email (default `true`) |
-
----
-
-### sf_freeze_user
-Freezes or unfreezes a user account (blocks login without deactivating).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | User to freeze |
-| `freeze` | boolean | `true` to freeze, `false` to unfreeze |
-
----
-
-### sf_create_territory
-Creates an Enterprise Territory Management (ETM) Territory2.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `territoryName` | string | Territory DeveloperName |
-| `label` | string | Display name |
-| `territoryType` | string | Territory2Type DeveloperName |
-| `parentTerritoryName` | string | Parent territory (optional) |
-
-> Requires ETM enabled in the org.
-
----
-
-### sf_assign_territory_to_user
-Assigns a user to an ETM territory via `UserTerritory2Association`.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `username` | string | User to assign |
-| `territoryName` | string | Territory DeveloperName |
-| `roleInTerritory` | string | `Salesperson`, `Manager`, `BusinessUser` |
-
----
-
-### sf_create_forecast_hierarchy
-Configures a Collaborative Forecasting hierarchy manager relationship.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `managerUsername` | string | Forecast manager's username |
-| `reporteeUsername` | string | Managed user's username |
-| `forecastingType` | string | Forecasting type DeveloperName (e.g. `OpportunityRevenue`) |
-
----
-
-## Einstein & AI
-
-### sf_create_einstein_prediction
-Creates an Einstein Prediction Builder definition (MLPredictionDefinition metadata).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `predictionName` | string | API name |
-| `label` | string | Display label |
-| `objectApiName` | string | Object to predict on |
-| `predictionType` | `BinaryClassification\|Regression` | Model type |
-| `targetField` | string | Field to predict |
-| `segmentField` | string | Optional segment filter field |
-
----
-
-### sf_create_next_best_action
-Creates a Next Best Action recommendation strategy (RecommendationStrategy metadata).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `strategyName` | string | Strategy API name |
-| `label` | string | Display label |
-| `contextObjectName` | string | Object the strategy applies to |
-| `recommendations` | array | `[{name, label, actionReference, acceptLabel, rejectLabel}]` |
-
----
-
-### sf_create_einstein_bot
-Creates a classic Einstein Bot with ML domain and conversation dialogs.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `botName` | string | Bot API name |
-| `label` | string | Display label |
-| `description` | string | Bot description |
-| `mlDomain` | string | Einstein ML domain name |
-| `defaultLocale` | string | Language code (default `en_US`) |
-| `welcomeMessage` | string | Greeting message |
-| `dialogs` | array | Conversation dialogs |
-
----
-
-## Reports & Dashboards
-
-### sf_create_report
-Creates a Salesforce Report (Tabular, Summary, Matrix, or Joined).
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `fullName` | string | `FolderName/ReportName` |
-| `name` | string | Display name |
-| `reportType` | string | Report type API name (e.g. `Accounts`, `Opportunities`) |
-| `format` | string | `Tabular`, `Summary`, `Matrix`, `MultiBlock` |
-| `columns` | array | Field API names to show |
-| `filters` | array | `[{field, operator, value}]` |
-| `groupingsRow` | array | Summary/Matrix row groupings |
-
----
-
-### sf_update_dashboard
-Updates an existing Dashboard's title or description.
-
----
-
-### sf_create_report_folder
-Creates a folder for organizing Reports or Dashboards.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `name` | string | Folder API name |
-| `label` | string | Display name |
-| `accessType` | string | `Hidden`, `Shared`, `Public` |
-| `folderType` | `Report\|Dashboard` | Folder type |
-
----
-
-### sf_share_report_folder
-Shares a Report or Dashboard folder with users, roles, or groups.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `folderName` | string | Folder API name |
-| `shares` | array | `[{sharedTo, sharedToType, accessLevel}]` — types: `User`, `Role`, `Group`; levels: `View`, `Edit`, `Manage` |
-
----
-
-## MCP Server Generation
-
 ### sf_create_mcp_server
 Generates a complete MCP server project on disk.
 
+**Parameters:**
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `serverName` | string | NPM package name |
-| `outputDirectory` | string | Absolute path for the project |
+| `serverName` | string | Server package name |
+| `outputDirectory` | string | Absolute path to output directory |
 | `description` | string | Server description |
 | `salesforceInstanceUrl` | string | Pre-configure org URL |
 
-**Example:** "Create a new MCP server called my-sf-integration in /home/user/projects/my-server"
+**Example prompts:**
+- "Create a new MCP server called my-sf-integration in C:/projects/my-server"
+- "Generate a Salesforce MCP server project targeting https://myorg.salesforce.com"
 
 ---
 
-*See [README.md](README.md) for setup instructions, [CHANGELOG.md](CHANGELOG.md) for release notes, and [AGENTFORCE.md](AGENTFORCE.md) for Agentforce-specific guidance.*
+*For the complete list of all 60+ tools, see [README.md](README.md).*