@shoppexio/mcp-theme-server 0.1.2 → 0.1.3

package/README.md

@@ -1,104 +1,48 @@
 # @shoppexio/mcp-theme-server
 
-Model Context Protocol server for Shoppex theme operations.
+MCP server for Shoppex theme operations.
 
-Connect any MCP-capable client — Claude Desktop, Claude Code, Cursor, Windsurf, Codex — to your Shoppex themes. Inspect, edit, validate, preview, and publish themes directly from your LLM workflow.
+Use this package when you want an MCP-compatible client like Claude Code, Codex, Cursor, or OpenCode to work against hosted Shoppex themes.
 
-## Install
+## What It Exposes
+
+The server exposes tools for:
+- inspect and diff
+- read and search
+- apply changes
+- create sections and pages
+- validate, preview, publish, and rollback
+
+## Runtime Config
+
+Set these environment variables before starting the server:
 
 ```bash
-npm install -g @shoppexio/mcp-theme-server
+export SHOPPEX_API_KEY=shx_your_key
+export SHOPPEX_API_URL=https://api.shoppex.io
 ```
 
-Or run without installing:
+## Start
+
+Install and run from npm:
 
 ```bash
 npx -y @shoppexio/mcp-theme-server
 ```
 
-## Claude Desktop
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
-
-```json
-{
-  "mcpServers": {
-    "shoppex-themes": {
-      "command": "npx",
-      "args": ["-y", "@shoppexio/mcp-theme-server"],
-      "env": {
-        "SHOPPEX_API_KEY": "shx_your_dev_api_key"
-      }
-    }
-  }
-}
+Or, if you are working from this repo:
+
+```bash
+bun packages/mcp-theme-server/bin/shoppex-mcp-theme-server.mjs
 ```
 
-Restart Claude Desktop. The themes tools appear under the tools menu.
-
-## Cursor / Windsurf / Other
-
-Any MCP client with stdio transport works. Set the same env var and point to `shoppex-mcp-theme-server` as the command.
-
-## Tools (19)
-
-| Tool | Purpose |
-|------|---------|
-| `theme.inspect` | Inspect theme structure and manifest |
-| `theme.diff` | Diff theme state against a target |
-| `theme.read_file` | Read one file from a theme |
-| `theme.search_files` | Search across theme files |
-| `theme.apply` | Apply a change set to a theme |
-| `theme.accept` | Accept a pending change |
-| `theme.create` | Scaffold a new theme |
-| `theme.create_section` | Add a section |
-| `theme.create_page` | Add a page |
-| `theme.update_config` | Update `theme.config.ts` |
-| `theme.preview` | Start a preview instance |
-| `theme.stop_preview` | Stop a preview instance |
-| `theme.publish` | Publish theme |
-| `theme.publish_status` | Check publish status |
-| `theme.validate` | Validate theme build |
-| `theme.settings_get` | Read theme settings |
-| `theme.settings_update` | Update theme settings |
-| `theme.backups` | List backups |
-| `theme.rollback` | Rollback to a previous version |
-| `theme.latest_run` | Inspect last run result |
-
-## Required Scopes
-
-Your Shoppex Dev API key needs:
+## Auth
+
+Recommended scopes:
 - `themes.read`
 - `themes.write`
 
-Create one at [dashboard.shoppex.io/developer/api](https://dashboard.shoppex.io/developer/api).
-
-## Environment Variables
-
-| Variable | Required | Default |
-|----------|----------|---------|
-| `SHOPPEX_API_KEY` | yes | — |
-| `SHOPPEX_API_URL` | no | `https://api.shoppex.io` |
-
-## Example Prompts
-
-Once connected in Claude Desktop:
-
-- "Inspect the Nebula theme and list its sections."
-- "Create a new Hero section in my Pulse theme with a purple gradient background."
-- "Preview the Classic theme with the accent color set to `#7C3AED`."
-- "Publish the current draft of my Starlight theme."
-
-## Companion
-
-Pair with [`@shoppexio/mcp-commerce-server`](https://www.npmjs.com/package/@shoppexio/mcp-commerce-server) for products, orders, customers, coupons, and payment links.
-
-## Docs
-
-- [AI Workflows](https://docs.shoppex.io/themes/ai-workflows)
-- [Build & Customize with AI](https://docs.shoppex.io/themes/build-and-customize-with-ai)
-- [Developer API](https://docs.shoppex.io/api-reference/introduction)
-
-## License
+## Related Docs
 
-Proprietary. © Shoppex.
+- AI Workflows: `https://docs.shoppex.io/themes/ai-workflows`
+- Theme Control Plane: `https://docs.shoppex.io/themes/theme-control-plane`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/mcp-theme-server",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Shoppex MCP server for theme control plane operations",
   "type": "module",
   "repository": {
@@ -38,6 +38,6 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",
-    "@shoppexio/theme-control-client": "workspace:*"
+    "@shoppexio/theme-control-client": "^0.1.0"
   }
 }