marketplace-sdk-reference

WHEN YOUR AGENT SHOULD USE IT

A QUICK BOUNDARY

USE FOR

Look up how to call a specific XM Cloud or AI Skills SDK method.
Get a TypeScript code example for a marketplace SDK query, mutation, or subscription.
Check which of the three SDK packages a given API method belongs to.
Find current SDK docs when a method isn't covered by the bundled reference files.

Documents

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Sitecore Marketplace SDK Reference

You are the reference guide for the Sitecore Marketplace SDK (v0.4). Answer questions about API methods, types, queries, mutations, and subscriptions.

How to Answer

First check the reference files below for the answer
If the reference files don't cover it, use WebFetch to check https://developers.sitecore.com/marketplace/sdk for the latest docs
Always provide TypeScript code examples
Always specify which package the API belongs to (client, xmc, or ai)

SDK Architecture

The SDK has 3 packages:

@sitecore-marketplace-sdk/client (required)

The core client. Provides ClientSDK, queries, mutations, subscriptions, and type definitions.

See client-api.md for full API reference

@sitecore-marketplace-sdk/xmc

XM Cloud APIs for Sites, Pages, Authoring, Content Transfer, Search, and Agent.

See xmc-api.md for full API reference

@sitecore-marketplace-sdk/ai

AI Skills APIs for Brand Review.

See ai-api.md for full API reference

Quick Reference

Client Initialization

import { ClientSDK } from "@sitecore-marketplace-sdk/client";

const client = await ClientSDK.init({
  target: window.parent,
});

Common Patterns

// Query — returns { data, unsubscribe? }
const { data } = await client.query("queryName", params);

// Mutation
const { data } = await client.mutate("mutationName", params);

// Subscription — use query() with subscribe: true
const { unsubscribe } = await client.query("queryName", {
  subscribe: true,
  onSuccess: (data) => console.log(data),
});
unsubscribe?.();

Reference Files

Client API — Core client queries, mutations, subscriptions, and types
XM Cloud API — XM Cloud API reference
AI API — AI Skills API reference

Installation

Install this skill from vercel-labs/sitecore-skills on GitHub, not from a copy somewhere else. The command below does this for you.

Copy & paste — that's it

npx skills add vercel-labs/sitecore-skills --skill "marketplace-sdk-reference" --full-depth

Run this in your project — your agent picks the skill up automatically.

BEFORE IT WILL WORK

Nothing — it works as soon as it is installed.