feat: add @vlocode/mcp — MCP server for Salesforce/Vlocity agent operations

[Copilot]

Adds a new @vlocode/mcp package exposing a Model Context Protocol server over stdio, enabling AI agents (GitHub Copilot, Claude, etc.) to perform Salesforce and Vlocity datapack operations directly from the IDE.

Tools exposed

Tool	Description
deploy_datapacks	Deploy Vlocity datapacks from local folders to Salesforce
retrieve_datapacks	Export Salesforce objects as datapacks (by ID or SOQL query) with optional expand
deploy_metadata	Deploy Salesforce metadata (Apex, LWC, triggers, etc.) from source paths
list_sobjects	List all SObjects with optional substring filter
describe_sobject	Describe an SObject including all fields
describe_sobject_field	Describe a single field including picklist values
list_profiles	List all Salesforce profiles
add_fls_to_profile	Set FLS (editable / readable / none) per field on a named profile

Architecture

• Uses the same DI container and SFDX auth pattern as @vlocode/cli (SfdxConnectionProvider, VlocityNamespaceService)
• Logs exclusively to stderr to avoid corrupting the MCP stdio protocol on stdout
• Namespace service initialization is deferred to the first tool call — the server process is ready immediately on startup
• Built with tsdown (same as CLI); exposes a vlocode-mcp bin entry

VS Code MCP configuration

// .vscode/mcp.json
{
  "servers": {
    "vlocode": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vlocode/mcp", "--user", "[email protected]"]
    }
  }
}

[email protected] is any SFDX-authenticated username or alias.

Original prompt

Create an MCP vscode extensions inside of Vlocode that enables agents to refresh or retrieve datapacks. describe the Salesforce Objects and Fields. List profiles, add FLS to profiles. Deploy metadata. Deploy Datapacks.

---

📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.