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-componentto build UI for the data - Use
/marketplace-sdk-referencefor detailed type information
Reference Files
- XMC Patterns — Code patterns for each XMC API
