| name | marketplace-add-xmc |
| description | Adds XM Cloud API integration to a Sitecore Marketplace app. Use when the user wants to access Sites, Pages, Authoring, Content Transfer, Search, or Agent APIs from XM Cloud. |
| argument-hint | [api-name] |
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
