@shadsapp/mcp 0.1.4 → 1.0.0

package/README.md

@@ -1,190 +1,45 @@
-# @shadsapp/mcp
+# @shadsapp/mcp (Deprecated)
 
-MCP server for [shads.app](https://shads.app). It gives AI clients access to curated shadcn/ui themes, theme validation, registry URLs, theme skills, and installation plans.
+> [!WARNING]
+> **DEPRECATION NOTICE**: This npm package is deprecated in favor of the official zero-install remote HTTP MCP server at **`https://mcp.shads.app`**.
+>
+> You no longer need to install or run Node.js packages locally. Remove the `@shadsapp/mcp` entry from your MCP client config and connect directly to the HTTP endpoint. Each client uses a different config format, so follow the guide for yours: [shads.app/docs/mcp](https://shads.app/docs/mcp).
 
-The server uses the MCP **stdio transport**. It runs as a child process started by an MCP client such as Claude Desktop, Cursor, VS Code, or another MCP host.
+## Migration
 
-## Requirements
+If you previously configured the `@shadsapp/mcp` command in your MCP client settings (e.g. `npx -y @shadsapp/mcp`), delete it and add the remote server `https://mcp.shads.app` using the [client guide](https://shads.app/docs/mcp). For any client, `npx add-mcp https://mcp.shads.app` writes the config for you.
 
-- Node.js 18 or newer
-- Internet access for registry tools (`resolve_share`, `get_theme_package`, `get_skill`, and `install_plan`)
-- A project using the shadcn CLI for generated install commands
+Executing `npx @shadsapp/mcp` will output this deprecation notice and exit.
 
-`list_themes`, `get_theme`, `validate_theme`, `theme_schema`, and `list_starters` work from the installed package without a network request.
+## Available tools on `https://mcp.shads.app`
 
-## Installation
-
-### Run directly with npx
-
-This is the simplest option. The MCP client downloads the package when it starts the server:
-
-```bash
-npx -y @shadsapp/mcp
-```
-
-Use the following configuration in an MCP client that supports JSON server configuration:
-
-```json
-{
-  "mcpServers": {
-    "shads": {
-      "command": "npx",
-      "args": ["-y", "@shadsapp/mcp"]
-    }
-  }
-}
-```
-
-### Install globally
-
-```bash
-npm install --global @shadsapp/mcp
-shads-mcp
-```
-
-Then configure the client with:
-
-```json
-{
-  "mcpServers": {
-    "shads": {
-      "command": "shads-mcp"
-    }
-  }
-}
-```
-
-### Install locally in a project
-
-```bash
-npm install --save-dev @shadsapp/mcp
-```
-
-Use an absolute executable path when the MCP host does not inherit your project's `node_modules/.bin` path. For example:
-
-```json
-{
-  "mcpServers": {
-    "shads": {
-      "command": "/absolute/path/to/project/node_modules/.bin/shads-mcp"
-    }
-  }
-}
-```
-
-On Windows, use the generated `shads-mcp.cmd` path or run through `npx.cmd`:
-
-```json
-{
-  "mcpServers": {
-    "shads": {
-      "command": "npx.cmd",
-      "args": ["-y", "@shadsapp/mcp"]
-    }
-  }
-}
-```
-
-## Client setup
-
-Add the configuration to the MCP client's server settings, then restart the client. The server communicates over stdin/stdout, so do not add logging or other output to stdout in a wrapper script. Diagnostics belong on stderr.
-
-If the client supports an explicit working directory, set it to the project where shadcn commands should run. The MCP server itself does not modify that project; it returns install commands for the agent or user to review and run.
-
-## Available tools
+### Public tools
 
 | Tool                 | Input                                       | Purpose                                              |
 | -------------------- | ------------------------------------------- | ---------------------------------------------------- |
-| `list_themes`        | `{}`                                        | List bundled starter theme metadata.                 |
-| `get_theme`          | `{ "id": "workspace" }`                     | Return a bundled theme and CSS.                      |
+| `list_themes`        | `{}`                                        | List curated public starter themes.                  |
+| `get_theme`          | `{ "id": "system-modern-default-theme" }`                     | Return a theme document and CSS.                     |
 | `validate_theme`     | `{ "source": "..." }`                       | Validate raw or fenced `theme.json` text.            |
 | `theme_schema`       | `{}`                                        | Return the active schema id.                         |
 | `list_starters`      | `{}`                                        | List starter registry and skill URLs.                |
-| `get_install_prompt` | `{ "item": "workspace", "mode": "both" }`   | Return a copyable install prompt.                    |
+| `get_install_prompt` | `{ "item": "system-modern-default-theme", "mode": "both" }`   | Return a copyable install prompt.                    |
 | `resolve_share`      | `{ "item": "abc123" }`                      | Resolve a registry/share item and return its prompt. |
-| `get_theme_package`  | `{ "id": "workspace" }`                     | Return theme, skill, dependencies, and install data. |
-| `get_skill`          | `{ "id": "workspace" }`                     | Return the theme-specific skill markdown.            |
-| `install_plan`       | `{ "id": "workspace", "mode": "existing" }` | Return validated install commands and notes.         |
-
-Starter names such as `workspace` are converted to registry item ids such as `workspace-theme`. You may also provide a theme item id, a share id, or a registry URL such as `https://shads.app/r/workspace-theme.json`.
-
-Registry item ids accept only letters, numbers, hyphens, and underscores. This keeps generated shell commands safe to review and execute.
-
-## Typical workflows
-
-### Install a starter into an existing app
-
-1. Call `get_theme_package` with `{ "id": "workspace" }`.
-2. Review the returned theme URL, skill markdown, dependencies, and prompt.
-3. Call `install_plan` with mode `existing` if you only need the command.
-4. Run the returned command from the target shadcn project.
-
-### Create a new app from a starter
-
-Call `get_install_prompt` with mode `new`:
-
-```json
-{
-  "item": "workspace",
-  "mode": "new"
-}
-```
-
-The result contains the `shadcn create` command and the relevant theme skill instructions.
-
-### Validate a theme document
-
-Pass the complete JSON text or a fenced JSON block:
-
-````json
-{
-  "source": "```json\n{\"$schema\":\"shads-theme/v1\",\"config\":{}}\n```"
-}
-````
-
-The result has `ok: true` and a normalized document when valid, or `ok: false` with a list of validation errors.
-
-## Troubleshooting
-
-### The client cannot start the server
-
-Check that Node.js 18 or newer is available to the client process:
-
-```bash
-node --version
-npx -y @shadsapp/mcp
-```
-
-For GUI clients, use an absolute command path or configure the full path to `npx`/`npx.cmd`. GUI applications often have a smaller `PATH` than your shell.
-
-### The server starts but registry tools fail
-
-The remote registry tools require network access to `https://shads.app`. Check that the client process can reach the registry and that the item exists. Remote requests fail with a bounded timeout rather than waiting indefinitely.
-
-### Install commands do not affect the project
-
-The server only returns commands. Run them from the target shadcn project, or configure the MCP host's working directory when supported.
-
-## Development
-
-From the repository root:
-
-```bash
-npm install
-npm run test -w @shadsapp/mcp
-npm run typecheck -w @shadsapp/mcp
-npm run build -w @shadsapp/mcp
-npm pack -w @shadsapp/mcp --dry-run
-```
-
-The published package contains `dist`, the executable entrypoint, and this README. The server uses stderr for fatal startup diagnostics and reserves stdout for MCP protocol messages.
-
-## Related packages
-
-- [`@shadsapp/schema`](https://www.npmjs.com/package/@shadsapp/schema)
-- [`@shadsapp/themes`](https://www.npmjs.com/package/@shadsapp/themes)
-- [`@shadsapp/cli`](https://www.npmjs.com/package/@shadsapp/cli)
-
-## License
-
-MIT
+| `get_theme_package`  | `{ "id": "system-modern-default-theme" }`                     | Return theme, skill, dependencies, and install data. |
+| `get_skill`          | `{ "id": "system-modern-default-theme" }`                     | Return the theme-specific skill markdown.            |
+| `install_plan`       | `{ "id": "system-modern-default-theme", "mode": "existing" }` | Return validated install commands and notes.         |
+| `list_concepts`      | `{}`                                        | List visual-language concepts.                       |
+| `get_concept`        | `{ "slug": "terminal" }`                    | Return a concept document.                           |
+| `connection_status`  | `{}`                                        | Verify the connection, plan, and API key status.     |
+
+### Pro tools (require `Authorization: Bearer <key>`)
+
+| Tool                 | Input                                                 | Purpose                                                 |
+| -------------------- | ----------------------------------------------------- | ------------------------------------------------------- |
+| `list_my_themes`     | `{}`                                                  | List your saved cloud themes.                           |
+| `get_my_theme`       | `{ "id": "<theme id>" }`                              | Return one theme as `theme.json` + a single stylesheet. |
+| `save_theme`         | `{ "name": "...", "document": "..." }`                | Save a theme document to your account.                  |
+| `update_theme`       | `{ "id": "...", "name?": "...", "document?": "..." }` | Rename and/or update a saved theme.                     |
+| `generate_theme`     | `{ "description": "..." }`                            | Hosted AI generation (uses your monthly quota).         |
+| `check_subscription` | `{}`                                                  | Show plan, MCP access, AI quota, and theme count.       |
+
+For more information, visit [shads.app/docs/mcp](https://shads.app/docs/mcp).

package/dist/api-client.d.ts

@@ -0,0 +1,65 @@
+export declare const API_BASE: string;
+export declare function readApiKey(): string | null;
+export declare class ShadsApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export type ConceptSummary = {
+    id: string;
+    version: number;
+    trust: "system" | "user";
+    name: string;
+    family: string;
+    description: string;
+    swatch: string[];
+    baseThemes: Array<{
+        id: string;
+        label: string;
+    }>;
+    runtimes: Array<"base-ui" | "radix" | "react-aria">;
+    modes: Array<"light" | "dark">;
+};
+export declare function listConcepts(): Promise<{
+    items: ConceptSummary[];
+}>;
+export declare function getConcept(slug: string): Promise<Record<string, unknown>>;
+export type CloudThemeSummary = {
+    id: string;
+    name: string;
+    updatedAt: string;
+};
+export type CloudThemeDetail = {
+    id: string;
+    name: string;
+    config: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    /** Full theme.json document (shads-theme/v1). */
+    themeDocumentJson: string;
+    /** Single stylesheet: tokens, adapters, and the @theme wiring. */
+    themeCss: string;
+};
+export type GenerateThemeResult = {
+    documents: Array<Record<string, unknown>>;
+    usage: number;
+};
+export type SubscriptionStatus = {
+    plan: string;
+    mcpAccess: boolean;
+    aiGenerations: {
+        used: number;
+        limit: number | null;
+    };
+    savedThemes: number;
+    entitlements: Record<string, unknown>;
+};
+export declare function listMyThemes(): Promise<CloudThemeSummary[]>;
+export declare function getMyTheme(id: string): Promise<CloudThemeDetail>;
+export declare function saveTheme(name: string, config: Record<string, unknown>): Promise<CloudThemeSummary>;
+export declare function updateTheme(id: string, patch: {
+    name?: string;
+    config?: Record<string, unknown>;
+}): Promise<CloudThemeDetail>;
+export declare function generateTheme(description: string): Promise<GenerateThemeResult>;
+export declare function checkSubscription(): Promise<SubscriptionStatus>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/api-client.js

@@ -0,0 +1,125 @@
+import { REGISTRY_HOMEPAGE } from "./install-prompt.js";
+export const API_BASE = (process.env.SHADS_API_BASE ?? REGISTRY_HOMEPAGE).replace(/\/+$/, "");
+const REQUEST_TIMEOUT_MS = 30_000;
+const GENERATE_TIMEOUT_MS = 90_000;
+export function readApiKey() {
+    const key = process.env.SHADS_API_KEY?.trim();
+    return key && key.startsWith("shads_live_") ? key : null;
+}
+export class ShadsApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.name = "ShadsApiError";
+        this.status = status;
+    }
+}
+function friendlyError(status, payloadError) {
+    if (status === 401) {
+        return (payloadError ??
+            "Your shads.app API key is invalid or revoked. Create a new one in Account settings > API keys (shads.app).");
+    }
+    if (status === 402) {
+        return (payloadError ??
+            "This feature requires a Pro plan. Upgrade: https://shads.app/pricing");
+    }
+    if (status === 429) {
+        return (payloadError ??
+            "Rate limited by shads.app (too many requests). Wait a moment and retry.");
+    }
+    return payloadError ?? `shads.app request failed (${status})`;
+}
+async function request(path, init = {}) {
+    const apiKey = readApiKey();
+    if (!apiKey) {
+        throw new ShadsApiError(401, "No shads.app API key configured. Set SHADS_API_KEY in your MCP server env (Pro feature: https://shads.app/pricing).");
+    }
+    let response;
+    try {
+        response = await fetch(`${API_BASE}${path}`, {
+            method: init.method ?? "GET",
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${apiKey}`,
+                ...(init.body === undefined
+                    ? {}
+                    : { "Content-Type": "application/json" }),
+            },
+            body: init.body === undefined ? undefined : JSON.stringify(init.body),
+            signal: AbortSignal.timeout(init.timeoutMs ?? REQUEST_TIMEOUT_MS),
+        });
+    }
+    catch (cause) {
+        if (cause instanceof Error && cause.name === "TimeoutError") {
+            throw new ShadsApiError(504, "shads.app request timed out. Retry.");
+        }
+        throw new ShadsApiError(0, `Could not reach shads.app at ${API_BASE}. Check your network.`);
+    }
+    const payload = (await response
+        .json()
+        .catch(() => null));
+    if (!response.ok) {
+        const payloadError = payload && typeof payload.error === "string" ? payload.error : null;
+        throw new ShadsApiError(response.status, friendlyError(response.status, payloadError));
+    }
+    return payload;
+}
+async function requestPublic(path) {
+    let response;
+    try {
+        response = await fetch(`${API_BASE}${path}`, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+    }
+    catch (cause) {
+        if (cause instanceof Error && cause.name === "TimeoutError") {
+            throw new ShadsApiError(504, "shads.app request timed out. Retry.");
+        }
+        throw new ShadsApiError(0, `Could not reach shads.app at ${API_BASE}. Check your network.`);
+    }
+    const payload = (await response
+        .json()
+        .catch(() => null));
+    if (!response.ok) {
+        const payloadError = payload && typeof payload.error === "string" ? payload.error : null;
+        throw new ShadsApiError(response.status, payloadError ?? `shads.app request failed (${response.status})`);
+    }
+    return payload;
+}
+export async function listConcepts() {
+    return requestPublic("/api/concepts");
+}
+export async function getConcept(slug) {
+    return requestPublic(`/api/concepts/${encodeURIComponent(slug)}`);
+}
+export async function listMyThemes() {
+    const data = await request("/api/themes");
+    return data.items.map((item) => ({
+        id: item.id,
+        name: item.name,
+        updatedAt: item.updatedAt,
+    }));
+}
+export async function getMyTheme(id) {
+    return request(`/api/themes/${encodeURIComponent(id)}?format=bundle`);
+}
+export async function saveTheme(name, config) {
+    const created = await request("/api/themes", { method: "POST", body: { name, config } });
+    return { id: created.id, name: created.name, updatedAt: created.updatedAt };
+}
+export async function updateTheme(id, patch) {
+    const updated = await request(`/api/themes/${encodeURIComponent(id)}`, { method: "PATCH", body: patch });
+    return updated;
+}
+export async function generateTheme(description) {
+    return request("/api/ai/generate", {
+        method: "POST",
+        body: { description },
+        timeoutMs: GENERATE_TIMEOUT_MS,
+    });
+}
+export async function checkSubscription() {
+    return request("/api/mcp/status");
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,CAAC,MAAM,QAAQ,GAAW,CAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,iBAAiB,CAChD,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAErB,MAAM,kBAAkB,GAAG,MAAM,CAAA;AACjC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAElC,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAA;IAC7C,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAQ;IAEvB,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,YAA2B;IAChE,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,CACL,YAAY;YACZ,4GAA4G,CAC7G,CAAA;IACH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,CACL,YAAY;YACZ,sEAAsE,CACvE,CAAA;IACH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,CACL,YAAY;YACZ,yEAAyE,CAC1E,CAAA;IACH,CAAC;IACD,OAAO,YAAY,IAAI,6BAA6B,MAAM,GAAG,CAAA;AAC/D,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,IAAY,EACZ,OAAgE,EAAE;IAElE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,aAAa,CACrB,GAAG,EACH,qHAAqH,CACtH,CAAA;IACH,CAAC;IAED,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;YAC3C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;oBACzB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;aAC5C;YACD,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YACrE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;SAClE,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5D,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,qCAAqC,CAAC,CAAA;QACrE,CAAC;QACD,MAAM,IAAI,aAAa,CACrB,CAAC,EACD,gCAAgC,QAAQ,uBAAuB,CAChE,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ;SAC5B,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAmC,CAAA;IAEvD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,YAAY,GAChB,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;QACrE,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACxF,CAAC;IAED,OAAO,OAAY,CAAA;AACrB,CAAC;AAED,KAAK,UAAU,aAAa,CAAI,IAAY;IAC1C,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;YAC3C,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC;SAChD,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5D,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,qCAAqC,CAAC,CAAA;QACrE,CAAC;QACD,MAAM,IAAI,aAAa,CACrB,CAAC,EACD,gCAAgC,QAAQ,uBAAuB,CAChE,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ;SAC5B,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAmC,CAAA;IAEvD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,YAAY,GAChB,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;QACrE,MAAM,IAAI,aAAa,CACrB,QAAQ,CAAC,MAAM,EACf,YAAY,IAAI,6BAA6B,QAAQ,CAAC,MAAM,GAAG,CAChE,CAAA;IACH,CAAC;IAED,OAAO,OAAY,CAAA;AACrB,CAAC;AAeD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,aAAa,CAA8B,eAAe,CAAC,CAAA;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,OAAO,aAAa,CAClB,iBAAiB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAC5C,CAAA;AACH,CAAC;AAiCD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,IAAI,GAAG,MAAM,OAAO,CAEvB,aAAa,CAAC,CAAA;IACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC,CAAA;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU;IACzC,OAAO,OAAO,CACZ,eAAe,kBAAkB,CAAC,EAAE,CAAC,gBAAgB,CACtD,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,MAA+B;IAE/B,MAAM,OAAO,GAAG,MAAM,OAAO,CAI1B,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IAC7D,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAA;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAU,EACV,KAA0D;IAE1D,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACvC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CACjC,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB;IAEnB,OAAO,OAAO,CAAsB,kBAAkB,EAAE;QACtD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,EAAE,WAAW,EAAE;QACrB,SAAS,EAAE,mBAAmB;KAC/B,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,OAAO,OAAO,CAAqB,iBAAiB,CAAC,CAAA;AACvD,CAAC"}

package/dist/index.js

@@ -1,419 +1,38 @@
 #!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { parseThemeDocumentInput, THEME_SCHEMA } from "@shadsapp/schema";
-import { getTheme, listThemes } from "@shadsapp/themes";
-import { buildAgentInstallPrompt, buildInstallPlan, listStarterInstallEntries, REGISTRY_HOMEPAGE, resolveSafeItemId, systemSkillItemId, } from "./install-prompt.js";
-const server = new Server({
-    name: "shads",
-    version: "0.1.1",
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: [
-        {
-            name: "list_themes",
-            description: "List curated public shads starter themes",
-            inputSchema: {
-                type: "object",
-                properties: {},
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "get_theme",
-            description: "Get a public theme bundle (theme.json + theme.css)",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    id: {
-                        type: "string",
-                        description: "Theme id, e.g. workspace",
-                    },
-                },
-                required: ["id"],
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "validate_theme",
-            description: "Validate a theme.json document string",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    source: {
-                        type: "string",
-                        description: "Raw theme.json text or fenced JSON",
-                    },
-                },
-                required: ["source"],
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "theme_schema",
-            description: "Return the active shads theme document schema id",
-            inputSchema: {
-                type: "object",
-                properties: {},
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "list_starters",
-            description: "List all shads starter themes with registry install URLs for agents",
-            inputSchema: {
-                type: "object",
-                properties: {},
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "get_install_prompt",
-            description: "Return a copyable agent install prompt for a starter, share id, or registry URL",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    item: {
-                        type: "string",
-                        description: "Starter id (workspace), theme item id, share id, or full registry URL",
-                    },
-                    mode: {
-                        type: "string",
-                        enum: ["existing", "new", "both"],
-                        description: "Which install commands to include (default both)",
-                    },
-                },
-                required: ["item"],
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "resolve_share",
-            description: "Resolve a share or registry item URL and return title plus install prompt",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    item: {
-                        type: "string",
-                        description: "Share id, theme item id, or registry URL",
-                    },
-                },
-                required: ["item"],
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "get_theme_package",
-            description: "Fetch a full theme package: registry theme, theme skill markdown, and install URLs",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    id: {
-                        type: "string",
-                        description: "Starter id (workspace), theme item id, share id, or registry URL",
-                    },
-                },
-                required: ["id"],
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "get_skill",
-            description: "Return the theme-specific skill markdown for a starter or share",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    id: {
-                        type: "string",
-                        description: "Starter id, theme item id, share id, or registry URL",
-                    },
-                },
-                required: ["id"],
-                additionalProperties: false,
-            },
-        },
-        {
-            name: "install_plan",
-            description: "Ordered shell commands to install a theme into a new or existing project",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    id: {
-                        type: "string",
-                        description: "Starter id, theme item id, share id, or registry URL",
-                    },
-                    mode: {
-                        type: "string",
-                        enum: ["new", "existing"],
-                        description: "Install target (default existing)",
-                    },
-                },
-                required: ["id"],
-                additionalProperties: false,
-            },
-        },
-    ],
-}));
-const REGISTRY_FETCH_TIMEOUT_MS = 10_000;
-async function fetchRegistryItem(itemId) {
-    try {
-        const response = await fetch(`${REGISTRY_HOMEPAGE}/r/${itemId}.json`, {
-            headers: { Accept: "application/json" },
-            signal: AbortSignal.timeout(REGISTRY_FETCH_TIMEOUT_MS),
-        });
-        if (!response.ok) {
-            return null;
-        }
-        return (await response.json());
+console.error(`
+[@shadsapp/mcp] DEPRECATION NOTICE
+================================================================================
+The @shadsapp/mcp npm package is deprecated in favor of our zero-install
+remote HTTP MCP server at:
+
+  https://mcp.shads.app
+
+Please update your MCP client configuration (Cursor, Claude Desktop, VS Code,
+Windsurf, Zed, etc.) to connect directly to the HTTP endpoint:
+
+{
+  "mcpServers": {
+    "shads": {
+      "url": "https://mcp.shads.app"
     }
-    catch {
-        return null;
-    }
-}
-function skillMarkdownFromItem(item) {
-    const skillFile = item.files?.find((file) => file.target?.endsWith("SKILL.md"));
-    return skillFile?.content ?? null;
+  }
 }
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    switch (request.params.name) {
-        case "list_themes": {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify(listThemes(), null, 2),
-                    },
-                ],
-            };
-        }
-        case "get_theme": {
-            const id = String(request.params.arguments?.id ?? "");
-            const bundle = getTheme(id);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            id: bundle.id,
-                            meta: bundle.meta,
-                            theme: bundle.theme,
-                            themeCss: bundle.themeCss,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        case "validate_theme": {
-            const source = String(request.params.arguments?.source ?? "");
-            const result = parseThemeDocumentInput(source);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        case "theme_schema": {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: THEME_SCHEMA,
-                    },
-                ],
-            };
-        }
-        case "list_starters": {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify(listStarterInstallEntries(), null, 2),
-                    },
-                ],
-            };
-        }
-        case "get_install_prompt": {
-            const item = String(request.params.arguments?.item ?? "");
-            const mode = request.params.arguments?.mode;
-            const itemId = resolveSafeItemId(item);
-            const prompt = buildAgentInstallPrompt({ itemId, mode });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: prompt,
-                    },
-                ],
-            };
-        }
-        case "resolve_share": {
-            const item = String(request.params.arguments?.item ?? "");
-            const itemId = resolveSafeItemId(item);
-            const registryItem = await fetchRegistryItem(itemId);
-            if (!registryItem) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                error: "Registry item not found",
-                                itemId,
-                            }, null, 2),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const prompt = buildAgentInstallPrompt({
-                itemId,
-                title: registryItem.title ?? registryItem.name,
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            itemId,
-                            title: registryItem.title ?? registryItem.name ?? itemId,
-                            prompt,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        case "get_theme_package": {
-            const id = String(request.params.arguments?.id ?? "");
-            const itemId = resolveSafeItemId(id);
-            const themeItem = await fetchRegistryItem(itemId);
-            if (!themeItem) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({ error: "Registry item not found", itemId }, null, 2),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const skillItemId = systemSkillItemId(itemId);
-            const skillItem = await fetchRegistryItem(skillItemId);
-            const skillMarkdown = skillItem
-                ? skillMarkdownFromItem(skillItem)
-                : null;
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            itemId,
-                            title: themeItem.title ?? themeItem.name ?? itemId,
-                            themeUrl: `${REGISTRY_HOMEPAGE}/r/${itemId}.json`,
-                            skillItemId,
-                            skillUrl: `${REGISTRY_HOMEPAGE}/r/${skillItemId}.json`,
-                            skillMarkdown,
-                            registryDependencies: themeItem.registryDependencies ?? [],
-                            installPrompt: buildAgentInstallPrompt({
-                                itemId,
-                                title: themeItem.title ?? themeItem.name,
-                            }),
-                            installPlan: buildInstallPlan({
-                                itemId,
-                                title: themeItem.title ?? themeItem.name,
-                                mode: "existing",
-                            }),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        case "get_skill": {
-            const id = String(request.params.arguments?.id ?? "");
-            const itemId = resolveSafeItemId(id);
-            const skillItemId = itemId.endsWith("-skill")
-                ? itemId
-                : systemSkillItemId(itemId);
-            const skillItem = await fetchRegistryItem(skillItemId);
-            if (!skillItem) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({ error: "Theme skill not found", skillItemId }, null, 2),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const markdown = skillMarkdownFromItem(skillItem);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: markdown ??
-                            JSON.stringify({ error: "Skill markdown missing", skillItemId }, null, 2),
-                    },
-                ],
-                isError: !markdown,
-            };
-        }
-        case "install_plan": {
-            const id = String(request.params.arguments?.id ?? "");
-            const mode = request.params.arguments?.mode === "new" ? "new" : "existing";
-            const itemId = resolveSafeItemId(id);
-            const registryItem = await fetchRegistryItem(itemId);
-            if (!registryItem) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({ error: "Registry item not found", itemId }, null, 2),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const plan = buildInstallPlan({
-                itemId,
-                mode,
-                title: registryItem?.title ?? registryItem?.name,
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            itemId,
-                            mode,
-                            ...plan,
-                            prompt: buildAgentInstallPrompt({
-                                itemId,
-                                mode: mode === "new" ? "new" : "existing",
-                                title: registryItem?.title ?? registryItem?.name,
-                            }),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        default:
-            throw new Error(`Unknown tool: ${request.params.name}`);
+
+For Pro accounts with an API key:
+{
+  "mcpServers": {
+    "shads": {
+      "url": "https://mcp.shads.app",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
     }
-});
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+  }
 }
-main().catch((error) => {
-    console.error(error);
-    process.exit(1);
-});
+
+Setup guides & documentation: https://shads.app/docs/mcp
+================================================================================
+`);
+process.exit(1);
+export {};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCb,CAAC,CAAA;AAEF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA"}

package/dist/premium-tools.d.ts

@@ -0,0 +1,43 @@
+export declare const AUTH_SETUP_MESSAGE = "shads.app premium tools need a Pro API key. Create one at https://shads.app (Account settings > API keys), then add it to your MCP client config: env { \"SHADS_API_KEY\": \"shads_live_...\" } for the @shadsapp/mcp server. Docs: https://shads.app/docs/mcp";
+/**
+ * Mirrors modules/config/src/ai/limits.ts. This package is published standalone
+ * and cannot depend on the private `@modules/*` workspace, so the bounds are
+ * repeated here rather than imported.
+ */
+export declare const DESCRIPTION_MIN_LENGTH = 10;
+export declare const DESCRIPTION_MAX_LENGTH = 400;
+export type ToolDefinition = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+};
+export declare const PREMIUM_TOOL_DEFINITIONS: ToolDefinition[];
+export declare const AUTHENTICATE_TOOL: ToolDefinition;
+export declare function hasApiKeyConfigured(): boolean;
+export type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+};
+export declare function textResult(data: unknown, isError?: boolean): ToolResult;
+/**
+ * Runs a premium API call and normalizes errors into MCP tool results so the
+ * agent sees actionable text (invalid key, upgrade prompt, rate limit) rather
+ * than a thrown error.
+ */
+export declare function premiumCall(run: () => Promise<unknown>): Promise<ToolResult>;
+/**
+ * Accepts either a full theme.json document (with `$schema`/`config`) or a
+ * bare config object, validates via @shadsapp/schema, and returns the config
+ * payload the API expects.
+ */
+export declare function parseThemeConfigDocument(source: string): {
+    ok: true;
+    config: Record<string, unknown>;
+} | {
+    ok: false;
+    errors: string[];
+};
+//# sourceMappingURL=premium-tools.d.ts.map

package/dist/premium-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-tools.d.ts","sourceRoot":"","sources":["../src/premium-tools.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,mQACmO,CAAA;AAElQ;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAA;AACxC,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,cAAc,EA6FpD,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,cAS/B,CAAA;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,UAAQ,GAAG,UAAU,CAKrE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC1B,OAAO,CAAC,UAAU,CAAC,CAUrB;AAMD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAEZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBlC"}

package/dist/premium-tools.js

@@ -0,0 +1,161 @@
+import { extractJsonFromText, parseThemeDocumentInput, } from "@shadsapp/schema";
+import { ShadsApiError, readApiKey } from "./api-client.js";
+export const AUTH_SETUP_MESSAGE = "shads.app premium tools need a Pro API key. Create one at https://shads.app (Account settings > API keys), then add it to your MCP client config: env { \"SHADS_API_KEY\": \"shads_live_...\" } for the @shadsapp/mcp server. Docs: https://shads.app/docs/mcp";
+/**
+ * Mirrors modules/config/src/ai/limits.ts. This package is published standalone
+ * and cannot depend on the private `@modules/*` workspace, so the bounds are
+ * repeated here rather than imported.
+ */
+export const DESCRIPTION_MIN_LENGTH = 10;
+export const DESCRIPTION_MAX_LENGTH = 400;
+export const PREMIUM_TOOL_DEFINITIONS = [
+    {
+        name: "list_my_themes",
+        description: "List the signed-in user's saved cloud themes from shads.app (Pro)",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "get_my_theme",
+        description: "Fetch one saved theme as a theme.json document plus a single standalone theme.css (Pro)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "Saved theme id (from list_my_themes)",
+                },
+            },
+            required: ["id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "save_theme",
+        description: "Save a validated theme document to the user's shads.app account (Pro)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Theme display name",
+                },
+                document: {
+                    type: "string",
+                    description: "theme.json text (with $schema shads-theme/v1) or raw config object as JSON",
+                },
+            },
+            required: ["name", "document"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "update_theme",
+        description: "Update the name and/or config of a saved theme (Pro). Snapshots history on Pro accounts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Saved theme id" },
+                name: { type: "string", description: "New display name (optional)" },
+                document: {
+                    type: "string",
+                    description: "New theme.json text or raw config JSON (optional; omit to rename only)",
+                },
+            },
+            required: ["id"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "generate_theme",
+        description: "Generate theme variations from a text description using shads.app hosted AI (Pro, counts against monthly AI quota)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: `Visual brief, ${DESCRIPTION_MIN_LENGTH}-${DESCRIPTION_MAX_LENGTH} chars, e.g. 'calm journaling app, sage green, serif headings'`,
+                },
+            },
+            required: ["description"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "check_subscription",
+        description: "Check the connected shads.app plan, MCP access, AI quota usage, and saved theme count",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+];
+export const AUTHENTICATE_TOOL = {
+    name: "authenticate",
+    description: "Returns setup guidance for connecting a shads.app Pro API key to unlock saved-theme access and AI generation",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+};
+export function hasApiKeyConfigured() {
+    return readApiKey() !== null;
+}
+export function textResult(data, isError = false) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        isError,
+    };
+}
+/**
+ * Runs a premium API call and normalizes errors into MCP tool results so the
+ * agent sees actionable text (invalid key, upgrade prompt, rate limit) rather
+ * than a thrown error.
+ */
+export async function premiumCall(run) {
+    try {
+        return textResult(await run());
+    }
+    catch (cause) {
+        if (cause instanceof ShadsApiError) {
+            return textResult({ error: cause.message, status: cause.status }, true);
+        }
+        const message = cause instanceof Error ? cause.message : String(cause);
+        return textResult({ error: message }, true);
+    }
+}
+function extractJsonObject(source) {
+    return extractJsonFromText(source.trim());
+}
+/**
+ * Accepts either a full theme.json document (with `$schema`/`config`) or a
+ * bare config object, validates via @shadsapp/schema, and returns the config
+ * payload the API expects.
+ */
+export function parseThemeConfigDocument(source) {
+    const result = parseThemeDocumentInput(source);
+    if (result.ok) {
+        return { ok: true, config: result.document.config };
+    }
+    // A bare config object (no $schema/config wrapper) fails document
+    // validation; retry treating the whole payload as config.
+    const jsonText = extractJsonObject(source);
+    if (jsonText) {
+        try {
+            const raw = JSON.parse(jsonText);
+            if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+                return { ok: true, config: raw };
+            }
+        }
+        catch {
+            // fall through to the original errors
+        }
+    }
+    return { ok: false, errors: result.errors };
+}
+//# sourceMappingURL=premium-tools.js.map

package/dist/premium-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-tools.js","sourceRoot":"","sources":["../src/premium-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@shadsapp/mcp",
-  "version": "0.1.4",
+  "version": "1.0.0",
   "description": "MCP server that lets AI agents list, fetch, and validate shads.app shadcn/ui themes",
+  "deprecated": "The @shadsapp/mcp package is deprecated. Please migrate to the remote HTTP MCP server at https://mcp.shads.app. Docs: https://shads.app/docs/mcp",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -22,11 +23,6 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run"
   },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.5",
-    "@shadsapp/schema": "0.1.2",
-    "@shadsapp/themes": "0.1.3"
-  },
   "devDependencies": {
     "vitest": "^5.0.0"
   },