b2c-dx-mcp

B2C CLI, MCP and Tooling SDK

[!NOTE] This project is Generally Available (GA). Please provide feedback via GitHub issues.

Salesforce B2C Commerce Command Line Tools.

[!TIP] Just looking for the B2C CLI or MCP install instructions? Visit the documentation site at https://salesforcecommercecloud.github.io/b2c-developer-tooling/ for the latest install guide and CLI reference.

Agent Skills & Plugins

Install B2C Commerce agent skills and plugins in your AI-powered editor. Three plugins are available: b2c-cli (CLI operations), b2c (development patterns), and b2c-dx-mcp (MCP server — Claude Code only).

• Claude Code: run these commands in chat:

  /plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
  /plugin install b2c-cli@b2c-developer-tooling
  /plugin install b2c@b2c-developer-tooling
  /plugin install b2c-dx-mcp@b2c-developer-tooling
  

• VS Code (GitHub Copilot): Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → Chat: Install Plugin From Source → enter the repo SalesforceCommerceCloud/b2c-developer-tooling.

• GitHub Copilot CLI:

  copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
  copilot plugin install b2c-cli@b2c-developer-tooling
  copilot plugin install b2c@b2c-developer-tooling
  

• Cursor: add the marketplace from this repo URL in Cursor Settings → Plugins, then install b2c-cli / b2c.

• Codex CLI: run /plugins and add from this repo (GitHub URL).

• Gemini CLI: gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling

• Any supported IDE (file-copy install via CLI):

  npx @salesforce/b2c-cli setup skills
  

For Windsurf, OpenCode, Agentforce Vibes, manual installs, and the full install matrix, see docs/guide/agent-skills.

Packages

This is a pnpm monorepo with the following packages:

Package	Description
b2c-cli	Command line interface built with oclif
b2c-tooling-sdk	SDK/library for B2C Commerce operations; supports the CLI and can be used standalone
b2c-dx-mcp	MCP server for B2C Commerce developer experience tools

Development

Prerequisites

• Node.js >= 22.16.0
• pnpm 10.17.1+

Setup

pnpm install

Running the CLI in Development Mode

pnpm start
# or directly:
pnpm --filter @salesforce/b2c-cli run dev
# or using convenience script:
./cli

The dev mode uses Node.js --conditions=development to resolve TypeScript source files directly from @salesforce/b2c-tooling-sdk without needing to build first.

Building

# Build all packages
pnpm -r run build

# Build individual packages
pnpm --filter @salesforce/b2c-cli run build
pnpm --filter @salesforce/b2c-tooling-sdk run build

Testing

Tests use Mocha + Chai with c8 for coverage. HTTP mocking uses MSW.

# Run all tests with coverage (also runs linter after tests)
pnpm test

# Run tests for a specific package
pnpm --filter @salesforce/b2c-tooling-sdk run test

# Run tests without coverage (faster)
pnpm --filter @salesforce/b2c-tooling-sdk run test:unit

# Watch mode for TDD
pnpm --filter @salesforce/b2c-tooling-sdk run test:watch

# Run a specific test file
cd packages/b2c-tooling-sdk
pnpm mocha "test/clients/webdav.test.ts"

# Run tests matching a pattern
pnpm mocha --grep "uploads a file" "test/**/*.test.ts"

Coverage

Coverage reports are generated in each package's coverage/ directory:

• coverage/index.html - HTML report
• coverage/lcov.info - LCOV format for CI integration

The SDK package has a 5% coverage threshold that will fail the build if not met.

Linting

# Run linter only
pnpm --filter @salesforce/b2c-cli run lint
pnpm --filter @salesforce/b2c-tooling-sdk run lint

Code Formatting

This project uses Prettier for code formatting.

# Format all packages
pnpm -r run format

# Check formatting without modifying files
pnpm -r run format:check

Documentation