@skyelight/mcp 0.5.3 → 0.6.0

package/CHANGELOG.md

@@ -11,7 +11,19 @@ keeps working. A **patch** is a fix or a wording change. A **major** would be
 removing a tool or an argument, or changing what an existing field means, and
 there has not been one.
 
-## 0.5.3 — unreleased
+## 0.6.0 — unreleased
+
+### Added
+
+- **`publish_prototype`.** Hosts a prototype on Skyelight: pass the complete
+  code of one file (an HTML page, or one React component with an export
+  default) and Skyelight serves it at its own link with the review badge on
+  it, in a project of your choosing or a new one. Returns the share link and
+  the project link. Publishing again with the same `prototypeId`, or the same
+  name in the same project, makes a new version at the same link. Owners,
+  admins and collaborators; on a person's own connection.
+
+## 0.5.3 — 2026-10-02
 
 ### Changed
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyelight/mcp",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "MCP server for Skyelight — read feedback items from your project as an agent",
   "type": "module",
   "bin": {

package/src/brand.js

@@ -61,4 +61,8 @@ export const STATUS = {
   merge_items: ["Merging duplicates", "Merged the duplicates"],
   decision_log: ["Reading the decisions", "Read the decisions"],
   save_rule: ["Saving the rule", "Saved the rule"],
+  publish_prototype: [
+    "Publishing the prototype to Skyelight",
+    "Published the prototype",
+  ],
 };

package/src/client.js

@@ -110,5 +110,6 @@ export function createClient({ apiUrl, token, fetchImpl = fetch }) {
     mergeItems: (body) => post("/api/v1/items/merge", body),
     decisionLog: (params) => request("/api/v1/decisions", params),
     saveRule: (body) => post("/api/v1/rules", body),
+    publishPrototype: (body) => post("/api/v1/prototypes/publish", body),
   };
 }

package/src/tools.d.ts

@@ -41,6 +41,7 @@ export declare function renderProjects(result: unknown): string;
 export declare function renderMembers(result: unknown): string;
 export declare function renderAssigned(result: unknown): string;
 
+export declare function renderPublished(result: unknown): string;
 export declare function renderPosted(
   result: unknown,
   opts: { kind: "update" | "item" },

package/src/tools.js

@@ -203,6 +203,52 @@ export function toolDefinitions(opts = {}) {
         required: ["url", "body"],
       },
     },
+    {
+      name: "publish_prototype",
+      description:
+        "Host a prototype on Skyelight so people can review it: Skyelight serves the code at " +
+        "its own link with the review badge on it, and their pins land in a Skyelight project. " +
+        "Pass the complete code of one file: a whole HTML page, or one React component with " +
+        "an export default (Tailwind classes and npm imports work; local imports such as " +
+        "@/components do not). Returns the share link and the project link; give both to the " +
+        "person. Publishing again with the same prototypeId, or the same name in the same " +
+        "project, makes a new version at the same link. The link is public to anyone who has it.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description:
+              "What it is, in a few words. Names the link and, when no project is given, a new project.",
+          },
+          code: {
+            type: "string",
+            description: "The complete file. Never a summary or an excerpt.",
+          },
+          kind: {
+            type: "string",
+            enum: ["html", "react"],
+            description: "Optional; worked out from the code when left out.",
+          },
+          projectId: {
+            type: "string",
+            description:
+              "Optional: the project to put it in. Left out, a new project is made for it.",
+          },
+          prototypeId: {
+            type: "string",
+            description:
+              "To publish a new version of a prototype published before.",
+          },
+          workspaceId: {
+            type: "string",
+            description:
+              "When you are in more than one workspace and give no project, from list_workspaces.",
+          },
+        },
+        required: ["code"],
+      },
+    },
     {
       name: "list_members",
       description:
@@ -340,6 +386,8 @@ const TOOL_ANNOTATIONS = {
   save_rule: { ...WRITE, idempotentHint: true },
   // Hides items from every list (reversible in the app, but not here).
   merge_items: { ...WRITE, destructiveHint: true },
+  // Puts code at a public link: something the person should agree to.
+  publish_prototype: { ...WRITE, openWorldHint: true },
 };
 
 function plural(n, one, many) {
@@ -749,6 +797,19 @@ export function renderPosted(result, { kind }) {
   );
 }
 
+export function renderPublished(result) {
+  const lines = [
+    result.newPrototype
+      ? `Published "${result.name}" in ${result.projectName}.`
+      : `Published version ${result.version}. The link is the same, and shows this version now.`,
+    `Share link: ${result.shareUrl}`,
+    `Project: ${result.projectUrl}${result.createdProject ? " (new project)" : ""}`,
+    `prototypeId ${result.prototypeId}: pass it to publish the next version at the same link.`,
+    "Anyone with the share link can open it; people sign in to Skyelight to leave pins.",
+  ];
+  return lines.join("\n");
+}
+
 export function renderMembers(result) {
   const members = result?.members ?? [];
   const where = result?.workspace?.name ? ` in ${result.workspace.name}` : "";
@@ -836,6 +897,26 @@ export async function callTool(name, args, { client, config }) {
     return { text: renderPosted(result, { kind: "item" }), data: result };
   }
 
+  if (name === "publish_prototype") {
+    if (!args.code?.trim()) {
+      throw new Error(
+        "publish_prototype needs code: the whole page, or one React component",
+      );
+    }
+    if (!args.prototypeId && !args.name?.trim()) {
+      throw new Error("publish_prototype needs a name");
+    }
+    const result = await client.publishPrototype({
+      name: args.name ?? "",
+      code: args.code,
+      ...(args.kind ? { kind: args.kind } : {}),
+      ...(args.projectId ? { projectId: args.projectId } : {}),
+      ...(args.prototypeId ? { prototypeId: args.prototypeId } : {}),
+      ...(args.workspaceId ? { workspaceId: args.workspaceId } : {}),
+    });
+    return { text: renderPublished(result), data: result };
+  }
+
   if (name === "list_members") {
     const result = await client.listMembers({
       projectId,

package/src/version.js

@@ -12,4 +12,4 @@
  * filesystem there. `test/server.test.js` asserts the two agree, so the pair
  * cannot drift again without a test going red.
  */
-export const VERSION = "0.5.3";
+export const VERSION = "0.6.0";