Add XM Cloud API Integration

You are helping the user add XM Cloud API integration to their Sitecore Marketplace app.

Prerequisites

The XMC package must be installed. If not:

npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/xmc.json

Step 1: Determine Which API

Ask the user (or infer from $ARGUMENTS) which XMC API they need:

API Namespace Use For

Sites xmc.sites.*

List/get sites, current site context

Pages xmc.pages.*

List/get pages, current page context

Authoring xmc.authoring.*

GraphQL queries/mutations against authoring API

Content Transfer xmc.contentTransfer.*

Import/export content

Search xmc.search.*

Search content items

Agent xmc.agent.*

Invoke XM Cloud agents

Step 2: Choose Client-Side or Server-Side

• Client-side: Use client.query() / client.mutate() — simpler, works in any architecture

• Server-side: Use experimental_createXMCClient() — requires Auth0 (full-stack architecture)

Step 3: Implement

See xmc-patterns.md for complete code patterns for each API.

Step 4: Suggest Related Skills

• Use /marketplace-build-component to build UI for the data

• Use /marketplace-sdk-reference for detailed type information

Reference Files

• XMC Patterns — Code patterns for each XMC API