mcpField
B
b2c-scapi-admin

b2c-scapi-admin

github.com/salesforcecommercecloudDevelopment5794 installsUpdated today
Repository

About b2c-scapi-admin

b2c-scapi-admin is a skill for building backend integrations and managing Commerce data through standard Admin APIs. It helps developers select and inspect operations, use configured Account Manager authentication, and handle results deliberately.

Key features

  1. 01Search bundled Admin API contracts
  2. 02Inspect operation parameters and security scopes
  3. 03Execute supported Admin JSON operations
  4. 04List live tenant schemas
  5. 05Guidance for safe writes and compact results

Use cases

  1. 01Build backend integrations with Commerce APIs
  2. 02Manage Commerce data through Admin APIs
  3. 03Check tenant-specific schemas before an operation

MCP support

When B2C MCP is available, the skill guides use of tools such as `scapi_search`, `scapi_execute`, and `scapi_schemas_list`. It also describes reading MCP skill resources where needed.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/salesforcecommercecloud/b2c-developer-tooling --skill b2c-scapi-admin

After installing, type/b2c-scapi-adminin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
trigger-evals.json
references/
CLIENT-EXAMPLES.md
INTEGRATION-PATTERNS.md
OAUTH-SCOPES.md

Details

From the project README

SCAPI Admin APIs

Build backend integrations or manage Commerce data through standard Admin APIs. Use the b2c-scapi-shopper skill for storefront flows.

Tool choice

When B2C MCP is available:

  • Prefer a dedicated task tool. Otherwise read skill://mcp/b2c-mcp-scapi/SKILL.md once through resources or skills_read, then use skillRead: true.
  • scapi_search: bundled standard contracts, offline. Find method/path/operationId, then inspect selected parameters, fields, and security scopes. Return compact projections.
  • scapi_execute: supported Admin JSON operations with configured Account Manager auth and automatic operation/tenant scopes. Use config_inspect with masking; do not fetch or print tokens manually for these calls.
  • scapi_schemas_list: live tenant schemas, including custom attributes and APIs. scapi_custom_apis_get_status: custom registration. Custom execution and binary transfers are unsupported by code mode; use an appropriate integration client.
  • docs_search/docs_read: platform semantics, limits, and auth setup. No duplicate docs lookup is needed merely to repeat a discovered contract.

For CLI/integration development: b2c scapi schemas list and b2c scapi schemas get <family> <name> <version> retrieve live contracts. Read integration examples only when implementing an external client, token flow, or bulk import. There is no CLI code-mode equivalent.

Execute deliberately

  • Use configured short code, tenant, and site values. Admin auth requires an Account Manager client, API grants, and SALESFORCE_COMMERCE_API:<tenant_id>. SLAS credentials do not replace Admin credentials.
  • Inspect the operation before use; examples are illustrative. For tenant-specific fields use live schemas. Check official docs for version-specific semantics.
  • Distinguish creation from update; PUT may do both. Verify existence and intent, then read back meaningful fields. Check earlier writes before retrying a failure.
  • Page/filter at the API and return IDs, selected fields, totals/hasMore, and errors. Do not emit whole response trees or log credentials.
  • Safety is method-based: POST searches can require a targeted allow rule. Confirmation-required code-mode requests stop; do not bypass them.

Conditional references

  • OAuth scopes: integration grants; compare with the operation's security.
  • Integration patterns: ETL, sync, bulk import.
  • b2c-config skill: CLI credentials and precedence.
  • Official docs: commerce-api/authorization-for-admin-apis, commerce-api/auth-z-scope-catalog, commerce-api/timeouts-limits, commerce-api/throttle-rates, commerce-api/inventory-impex-best-practices.

Comments

Markdown supported