SparkleTree plugin

This plugin lets Claude and other AI assistants work in your SparkleTree workspace. It connects the assistant to the SparkleTree MCP server and teaches it how the workspace fits together: it adds and imports products, sets up your brand book and brand page, writes a campaign plan for your approval, generates and reviews variants, designs Squid creatives or picks a ready-made template, publishes to your brand page, website and screens, and reads back what performed. It asks before anything that spends credits, goes live or deletes, and everything runs under your own account and role.

SparkleTree is a one-stop shop for building, managing and promoting your business online. It helps you establish your brand, create your web presence, improve how you appear in search and AI tools, and launch targeted marketing campaigns, all from one connected system. It then distributes those campaigns across every channel: websites and socials, digital signage and DOOH screens, kiosks, print and QR codes, and live streams, including NDI, with delivery across screen networks. More at https://sparkletree.io.

You need a SparkleTree workspace. Create one at https://app.sparkletree.io/sign-up; the connection cannot create it for you.

What you can ask

• "Show me what's in my SparkleTree workspace: which campaigns are live and what's my top performer this week?"
• "Import the product at https://example.com/products/aurora-lamp and draft a campaign plan for it. Show me the plan before generating anything."
• "How did my campaigns perform in the last 7 days? Which variant is winning, and what one change would you make?"
• "Give the ad in my spring campaign its own design that matches my website, and show me a preview before it goes live."
• "Change the opening hours on my brand page to 8 to 18 on weekdays and show me the draft before it goes live."
• "Each morning at 6, scan the internet for the day's dominant meme and rewrite the hero body of my Aurora Lamp campaign to make a joke about it. Show me the first one before it goes live." (/sparkletree:adapt does this; the schedule runs in your host, the change is a free write, and every run reports old versus new.)

Install

Claude Code

/plugin marketplace add https://gitlab.com/sparkletree/sparkletree-plugin.git
/plugin install sparkletree@sparkletree

The full GitLab URL is required; the owner/repo shorthand only resolves GitHub. Then /mcp, choose sparkletree, and sign in with your SparkleTree account in the browser. Run /sparkletree:setup for a guided first half hour.

To try it without installing: claude --plugin-dir ./sparkletree-plugin from a clone.

Claude.ai and Claude desktop (plugin)

Customize, Plugins, Add, Add marketplace, Add from a repository. Paste https://gitlab.com/sparkletree/sparkletree-plugin.git, choose the "Use" row that appears, and press Sync. The sparkletree plugin then shows under Browse for that marketplace; install it there. The MCP server inside the plugin asks you to sign in with your SparkleTree account on first use.

Skills only, any agent that reads Agent Skills

npx skills add SparkleTree/sparkletree-plugin

This installs the skills without the MCP server declaration or agents. Add the connector in your client separately (below).

Claude.ai and Claude desktop (connector only)

If you want only the MCP tools without the skills: Settings, Connectors, Add custom connector, paste https://app.sparkletree.io/api/mcp, approve, sign in. SparkleTree is not yet in Anthropic's connector directory, so the custom connector is the route today.

ChatGPT

Add a custom connector (MCP server) with the same URL, https://app.sparkletree.io/api/mcp, and sign in when prompted.

Cursor and any MCP client

Point the client at https://app.sparkletree.io/api/mcp over streamable HTTP. An unauthenticated call returns 401 with OAuth resource metadata; a spec-compliant client discovers the authorization server, registers, opens the browser consent flow, and you sign in. Headless clients can send a workspace API key (Settings, API keys in the dashboard) as the x-api-key header instead.

Gemini CLI

gemini extensions install https://gitlab.com/sparkletree/sparkletree-plugin. The manifest is gemini-extension.json.

What is in the plugin

Part	What it does
MCP server sparkletree	https://app.sparkletree.io/api/mcp, 15 tools: read tools for campaigns, products, stored files, surfaces, brand, analytics and video, and the matching write tools, plus generate_campaign, render_video and upload_asset. Reads are marked read-only.
Skill sparkletree	How to work in a workspace: read mosaic://capabilities first, read before write, confirm before publish, deploy, delete or credit spend, and which skill fits the request.
Skills launch-campaign, products, brand, squid-design, review-variants, analytics, status, video, surfaces-and-embed, adapt, agency-workspaces, troubleshoot-connection	One job each: product URL or goal to a live link; products, photos and file uploads; brand book, voice, brand page and brand site; custom Squid designs, templates, design checks and design video; variant critique; results and reports; what is live and running; video renders from campaigns and templates; website, React SDK, screens and QR; a one-sentence live change, once or on a schedule; several client workspaces; connection problems. The model loads them when a request fits; you can also type /sparkletree:<name>.
Commands /sparkletree:setup, /sparkletree:launch	Guided first half hour, and a launch from a product URL or a goal. Only you can run these.
Agents campaign-reviewer, analytics-digest	Read-only subagents. They return verdicts and proposals; the main conversation confirms and writes.

This is the beginning of the README. Read the rest at the original. Read the full README ↗