Toolsets & Tools

Toolsets are collections of related tools for a development workflow. The server auto-enables toolsets based on your detected project type, or you can select them manually with --toolsets. SCAPI and DIAGNOSTICS are always enabled.

Each tool below links to its full reference (parameters, authentication, usage). Some tools appear in more than one toolset; when multiple toolsets are active, tools are deduplicated so each is exposed once.

CARTRIDGES

Cartridge deployment and code version management. Auto-enabled for cartridge projects (detected by a .project file).

• cartridge_deploy — deploy cartridges to an instance via WebDAV, with optional code-version reload

DIAGNOSTICS

Script debugger, runtime log inspection, and multi-corpus documentation search. Always enabled. The debugger and log tools also appear in CARTRIDGES and SCAPI; the documentation tools appear in every toolset.

• Script Debugger — debug_* tools: manage SDAPI sessions, set breakpoints, step execution, inspect stack/variables, and capture at a breakpoint
• Instance logs — logs_* tools: list files, fetch recent entries, and run buffered watches
• MRT logs — mrt_logs_* tools: buffered tail of Managed Runtime application logs over a WebSocket
• Documentation — docs_* and docs_schema_* tools: search and read Script API, Developer Center guides, tooling docs, job steps, and XSD schemas

MRT

Managed Runtime operations for PWA Kit and Storefront Next deployments. Auto-enabled for PWA Kit v3 and Storefront Next projects.

• mrt_bundle_push — build and push a bundle, optionally deploying to an environment

Note: the MRT log-tail tools (mrt_logs_watch_*) live in the DIAGNOSTICS, PWAV3, and STOREFRONTNEXT toolsets — not MRT. See MRT logs.

PWAV3

PWA Kit v3 development tools for headless storefronts. Auto-enabled for PWA Kit v3 projects.

• pwakit_get_guidelines — PWA Kit v3 architecture rules and best practices
• scapi_schemas_list — list or fetch SCAPI schemas (standard and custom)
• Custom APIs — scaffold custom endpoints and check their registration status
• mrt_bundle_push — build and push a bundle
• MRT logs — mrt_logs_* tools

SCAPI

Salesforce Commerce API discovery and exploration. Always enabled.

• scapi_schemas_list — list or fetch SCAPI schemas (standard and custom)
• Custom APIs — scaffold custom endpoints and check their registration status

STOREFRONTNEXT

Storefront Next development support. Auto-enabled for Storefront Next projects; enables the MRT and CARTRIDGES toolsets alongside the base SCAPI and DIAGNOSTICS. The legacy sfnext_* tools are deprecated — use the storefront-next / storefront-next-figma agent-skills plugins instead.

• mrt_bundle_push — build and push a bundle
• MRT logs — mrt_logs_* tools
• scapi_schemas_list — list or fetch SCAPI schemas (standard and custom)
• Custom APIs — scaffold custom endpoints and check their registration status

STOREFRONTNEXT_DEPRECATED

DEPRECATED — use the agent-skills plugins instead

The sfnext_* MCP tools are deprecated and not compatible with the Storefront Next 1.0 GA release. They have been superseded by the storefront-next and storefront-next-figma agent-skills plugins, which stay current with the GA release. These tools will be removed in a future release.

This toolset is never auto-enabled and is excluded from --toolsets ALL; to use it you must request it explicitly and pass --allow-non-ga-tools:

{"args": ["--toolsets", "STOREFRONTNEXT_DEPRECATED", "--allow-non-ga-tools"]}

• sfnext_get_guidelines
• sfnext_start_figma_workflow
• sfnext_analyze_component
• sfnext_match_tokens_to_theme
• sfnext_add_page_designer_decorator
• sfnext_configure_theme

Next Steps

• Configuration — credentials, environment variables, MCP flags, toolset selection, and logging
• Installation — set up the MCP server
• MCP Server Overview — project-type detection and how toolsets are enabled