@skyelight/mcp 0.5.3 → 0.7.0

package/CHANGELOG.md

@@ -11,7 +11,37 @@ 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.7.0 — unreleased
+
+### Changed
+
+- **`publish_prototype` is now `publish_review_link`, and takes `code` or
+  `url`.** With `code`, as before: Skyelight hosts one file at its own link.
+  With `url`, a deployed app (Lovable, v0, Bolt, Vercel) goes on the
+  project's Review Links, and the answer carries the script tag to add to
+  the app's `<head>`. Code that is part of a larger app is no longer hosted;
+  the answer says to send the app's `url`. The server still answers the old
+  name, so 0.6.0 keeps working.
+- **`source`:** where a hosted prototype was made (`claude`, `openai`, `v0`,
+  `lovable` and others), shown as its logo on the project's Review Links.
+
+- **`list_workspaces` says what an agent can't do in a workspace:** a
+  reviewer seat, a plan without agent tools, or Free, whose MCP publishes
+  prototypes.
+
+## 0.6.0 — 2026-10-05
+
+### 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.7.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,5 @@ 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_review_link: ["Publishing to Skyelight", "Published to Skyelight"],
 };

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),
+    publishReviewLink: (body) => post("/api/v1/review-links", body),
   };
 }

package/src/tools.d.ts

@@ -41,6 +41,8 @@ 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 renderReviewLink(result: unknown): string;
 export declare function renderPosted(
   result: unknown,
   opts: { kind: "update" | "item" },

package/src/tools.js

@@ -203,6 +203,67 @@ export function toolDefinitions(opts = {}) {
         required: ["url", "body"],
       },
     },
+    {
+      name: "publish_review_link",
+      description:
+        "Share something with Skyelight for review, and get a link people can pin feedback on. " +
+        "Two ways:\n" +
+        "- code: one file Skyelight hosts at its own link with the review badge on it. 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). For Claude prototypes, v0 snippets and single pages. " +
+        "Publishing again with the same prototypeId, or the same name in the same project, makes a new " +
+        "version at the same link.\n" +
+        "- url: an app already deployed (a Lovable, v0, Bolt or Vercel project: anything with more than " +
+        "one file). Adds its address to the project's Review Links and returns a script tag to add to the " +
+        "app's <head> (index.html, or the root layout); add it and redeploy. Owners and admins.\n" +
+        "Returns the share link and the project link; give both to the person. A hosted link is public " +
+        "to anyone who has it.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          code: {
+            type: "string",
+            description:
+              "For Skyelight to host: the complete file, never a summary or an excerpt. Or give url.",
+          },
+          url: {
+            type: "string",
+            description:
+              "Where the app is deployed, e.g. https://my-app.lovable.app. Or give code.",
+          },
+          name: {
+            type: "string",
+            description:
+              "What it is, in a few words. Names the hosted link and, when no project is given, a new project.",
+          },
+          kind: {
+            type: "string",
+            enum: ["html", "react"],
+            description: "With code; worked out from it 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:
+              "With code: 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.",
+          },
+          source: {
+            type: "string",
+            description:
+              'With code: where it was made, shown as its logo in Skyelight: "claude", "claude-code", "openai" (ChatGPT), "cursor", "windsurf", "v0", "lovable" or "other". Name yourself.',
+          },
+        },
+      },
+    },
     {
       name: "list_members",
       description:
@@ -340,6 +401,9 @@ 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, or lets reviewers sign in on another site:
+  // either way, something the person should agree to.
+  publish_review_link: { ...WRITE, openWorldHint: true },
 };
 
 function plural(n, one, many) {
@@ -385,6 +449,9 @@ export function renderWorkspaces(result) {
     const projects = plural(w.projectCount, "project", "projects");
     lines.push(`  ${w.name} — ${w.role}, ${projects}`);
     lines.push(`    ${w.id}`);
+    // What an agent cannot do here, and why: a seat to ask for, a plan to
+    // upgrade, or Free's MCP, which publishes prototypes.
+    if (w.unavailableReason) lines.push(`    ${w.unavailableReason}`);
   }
   return lines.join("\n");
 }
@@ -749,6 +816,32 @@ 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 renderReviewLink(result) {
+  return [
+    result.alreadyAdded
+      ? `${result.origin} was already on ${result.projectName}'s Review Links.`
+      : `Added ${result.origin} to ${result.projectName}'s Review Links${result.createdProject ? " (new project)" : ""}.`,
+    "Add this to the app's <head> (index.html, or the root layout), then redeploy:",
+    result.scriptTag,
+    `Share link: ${result.shareUrl}`,
+    `Project: ${result.projectUrl}`,
+    "Reviewers sign in to Skyelight from the badge to leave pins.",
+  ].join("\n");
+}
+
 export function renderMembers(result) {
   const members = result?.members ?? [];
   const where = result?.workspace?.name ? ` in ${result.workspace.name}` : "";
@@ -836,6 +929,40 @@ export async function callTool(name, args, { client, config }) {
     return { text: renderPosted(result, { kind: "item" }), data: result };
   }
 
+  if (name === "publish_review_link" || name === "publish_prototype") {
+    const hasCode = !!args.code?.trim();
+    const hasUrl = !!args.url?.trim();
+    if (hasCode === hasUrl) {
+      throw new Error(
+        "publish_review_link takes code (one file for Skyelight to host) or url (where the app is deployed)",
+      );
+    }
+    if (hasCode && !args.prototypeId && !args.name?.trim()) {
+      throw new Error("publish_review_link needs a name");
+    }
+    const pick = (keys) =>
+      Object.fromEntries(keys.filter((k) => args[k]).map((k) => [k, args[k]]));
+    const result = await client.publishReviewLink(
+      hasUrl
+        ? pick(["url", "projectId", "name", "workspaceId"])
+        : {
+            name: args.name ?? "",
+            ...pick([
+              "code",
+              "kind",
+              "projectId",
+              "prototypeId",
+              "workspaceId",
+              "source",
+            ]),
+          },
+    );
+    return {
+      text: result?.linked ? renderReviewLink(result) : 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.7.0";