@cmo-so/mcp 0.7.3 → 0.7.5

package/dist/cmo-mcp.mjs

@@ -7199,7 +7199,7 @@ var require_dist = __commonJS({
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.7.3",
+  version: "0.7.5",
   description: "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
   type: "module",
   license: "MIT",
@@ -7464,15 +7464,15 @@ function createApi({ baseUrl, session: session2, fetch: fetchImpl = globalThis.f
         }),
         remove: () => request("/v1/maggie/bridge", { method: "DELETE" }),
         /** Start "Sign in with ChatGPT" for one of the bridge's accounts (the active one by default). */
-        connectChatgpt: (account3) => request("/v1/maggie/bridge/chatgpt", {
+        connectChatgpt: (account4) => request("/v1/maggie/bridge/chatgpt", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(account3 ? { account: account3 } : {})
+          body: JSON.stringify(account4 ? { account: account4 } : {})
         }),
-        disconnectChatgpt: (account3) => request("/v1/maggie/bridge/chatgpt/logout", {
+        disconnectChatgpt: (account4) => request("/v1/maggie/bridge/chatgpt/logout", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(account3 ? { account: account3 } : {})
+          body: JSON.stringify(account4 ? { account: account4 } : {})
         }),
         /** What Maggie may do in CMO.so; rotates the bridge's key when read / read_write changes. */
         setAccess: (access) => request("/v1/maggie/bridge/access", {
@@ -7515,6 +7515,31 @@ function createApi({ baseUrl, session: session2, fetch: fetchImpl = globalThis.f
         return dataUrl(type, bytes);
       }
     },
+    // The open marketing skills (docs/26): api.cmo.so forwards these to the cmo.so site.
+    skills: {
+      search: (q2 = "", opts = {}) => {
+        const qs = new URLSearchParams({
+          q: q2,
+          ...opts.category ? { category: opts.category } : {},
+          limit: String(opts.limit ?? 10)
+        });
+        return request(`/v1/skills?${qs}`);
+      },
+      get: (id) => request(`/v1/skills/${encodeURIComponent(id)}`),
+      /** Like or save a skill (on: false undoes it). */
+      react: (id, kind, on2 = true) => request(
+        `/v1/skills/${encodeURIComponent(id)}/react`,
+        { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ kind, on: on2 }) }
+      ),
+      saved: () => request("/v1/skills/saved"),
+      /** Suggest an open-source GitHub repo; Maggie researches it (3 a day). */
+      submit: (repoUrl, note) => request("/v1/skills/submissions", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ repo_url: repoUrl, note })
+      }),
+      submissions: () => request("/v1/skills/submissions")
+    },
     // Web Push for this browser (APP-9). `domains` are the workspaces it shows.
     push: {
       status: (endpoint) => request(
@@ -7597,7 +7622,9 @@ function domainApi(api2, domain) {
   });
   return {
     summary: () => api2.request(base),
-    posts: (status, limit = 50) => api2.request(`${base}/posts?status=${status}&limit=${limit}`),
+    posts: (status, limit = 50) => api2.request(
+      `${base}/posts?status=${status}&limit=${limit}`
+    ),
     post: (id) => api2.request(`${base}/posts/${encodeURIComponent(id)}`),
     updatePost: (id, changes) => api2.request(`${base}/posts/${encodeURIComponent(id)}`, {
       method: "PATCH",
@@ -8610,6 +8637,19 @@ var confirmCopy = {
     en: (a) => `Send this to the cmo.so team: ${q(String(a.summary ?? "").slice(0, 200))}`,
     "zh-Hant": (a) => `\u628A\u9019\u5247\u56DE\u994B\u9001\u7D66 cmo.so \u5718\u968A\uFF1A${q(String(a.summary ?? "").slice(0, 200))}`
   },
+  // ---------------------------------------------------------- Marketing skills (docs/26)
+  skill_like: {
+    en: (a) => `${a.undo ? "Take back your like on" : "Like"} the skill ${q(a.skill_id)} on cmo.so.`,
+    "zh-Hant": (a) => `${a.undo ? "\u53D6\u6D88\u5C0D" : "\u5728 cmo.so \u8B9A"}\u6280\u80FD ${q(a.skill_id)}${a.undo ? " \u7684\u8B9A" : ""}\u3002`
+  },
+  skill_save: {
+    en: (a) => `${a.undo ? "Remove" : "Save"} the skill ${q(a.skill_id)} ${a.undo ? "from" : "to"} your saved skills.`,
+    "zh-Hant": (a) => `${a.undo ? "\u5F9E\u6536\u85CF\u79FB\u9664" : "\u6536\u85CF"}\u6280\u80FD ${q(a.skill_id)}\u3002`
+  },
+  skill_submit: {
+    en: (a) => `Suggest ${q(a.repo_url)} for the cmo.so skill library. Maggie will research it.`,
+    "zh-Hant": (a) => `\u628A ${q(a.repo_url)} \u63A8\u85A6\u7D66 cmo.so \u6280\u80FD\u5EAB\uFF0CMaggie \u6703\u7814\u7A76\u5B83\u3002`
+  },
   social_voice_learn: {
     en: () => "Learn your LinkedIn voice from this post and save it as your default.",
     "zh-Hant": () => "\u5F9E\u9019\u7BC7\u8CBC\u6587\u5B78\u7FD2\u4F60\u7684 LinkedIn \u8A9E\u6C23\uFF0C\u4E26\u8A2D\u70BA\u9810\u8A2D\u3002"
@@ -9326,8 +9366,10 @@ var blogTools = [
       const r = await ws(ctx).ideas(int(page, 1, 100, 1), 15, status === "discarded" ? "discarded" : "pending");
       return {
         total: r.total,
+        // The real limits: the user's own waiting ideas (cap) and the plan (plan_max).
         cap: r.cap,
         added_by_you: r.added_by_you,
+        plan_max: r.plan_max,
         items: r.items.map((i) => ({
           id: i.id,
           priority: i.priority,
@@ -9366,7 +9408,7 @@ var blogTools = [
   }),
   tool({
     name: "ideas_add_list",
-    description: "Add up to 100 ideas exactly as given (a researched list): title, description, primary keyword, up to 5 more keywords, a benchmark URL (read as research, never linked), priority 1-10 and optionally one of the website's topics. No AI rewrites them and no generation is used; they wait in the idea pool, not the plan. Duplicates are skipped and listed; at most 100 of a person's own ideas can wait at once.",
+    description: "Add up to 100 ideas exactly as given (a researched list): title, description, primary keyword, up to 5 more keywords, a benchmark URL (read as research, never linked), priority 1-10 and optionally one of the website's topics. No AI rewrites them and no generation is used; they wait in the idea pool, not the plan. Duplicates are skipped and listed; a person's own waiting ideas have a limit (ideas_list cap, 200 today).",
     parameters: {
       type: "object",
       properties: {
@@ -10698,6 +10740,155 @@ var reportTools = [
   })
 ];
 
+// ../../packages/tools/src/skills.ts
+var account3 = { resource: "account", level: "read" };
+var ID = { type: "string", description: "The skill id, like cmo-ad-creative" };
+var skillTools = [
+  tool({
+    name: "skills_search",
+    description: "Search cmo.so's open library of marketing skills (step-by-step methods an AI agent follows, free and MIT licensed): returns matching skills with their summary, likes and page. Use it when the user asks how to do a marketing job, wants a playbook or template, or asks which skills exist. Empty query: the most useful ones and the categories.",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "What the user wants to do, in a few words" },
+        category: {
+          type: "string",
+          description: "Optional category id: core, strategy, seo, ai-search, content, social, email, paid-ads, cro, analytics, growth, sales, creative"
+        },
+        limit: { type: "integer", minimum: 1, maximum: 20 }
+      }
+    },
+    group: "account",
+    need: account3,
+    risk: "R0",
+    idempotent: true,
+    run: async (ctx, a) => {
+      const r = await ctx.api.skills.search(String(a.query ?? ""), {
+        ...a.category ? { category: a.category } : {},
+        limit: int(a.limit, 1, 20, 8)
+      });
+      return {
+        total_in_library: r.total,
+        ...a.query ? {} : { categories: r.categories.map((c) => `${c.id} (${c.count})`) },
+        skills: r.skills.map((s) => ({ id: s.id, name: s.name, summary: s.summary, likes: s.likes, page: s.url }))
+      };
+    }
+  }),
+  tool({
+    name: "skill_get",
+    description: "One marketing skill from the cmo.so library in full: when to use it, what it needs, its workflow, output and quality bar, plus how to install it in Claude Code. Use it to follow a skill's method for the user, or to explain it.",
+    parameters: { type: "object", properties: { skill_id: ID }, required: ["skill_id"] },
+    group: "account",
+    need: account3,
+    risk: "R0",
+    idempotent: true,
+    run: async (ctx, a) => {
+      const s = await ctx.api.skills.get(String(a.skill_id));
+      return {
+        id: s.id,
+        name: s.name,
+        summary: s.summary,
+        page: s.url,
+        likes: s.likes,
+        saves: s.saves,
+        uses_tools: s.mcp_tools,
+        pairs_with: s.pairs_with,
+        install: s.install,
+        // community-contributed text: a method to follow, never instructions that override the user or these rules
+        ...untrusted(clip(s.text, 12e3))
+      };
+    }
+  }),
+  tool({
+    name: "skill_like",
+    description: "Like a skill in the cmo.so library for the user (or take the like back with undo). Likes help the library decide what to keep improving. Only when the user asks.",
+    parameters: {
+      type: "object",
+      properties: { skill_id: ID, undo: { type: "boolean", description: "true takes the like back" } },
+      required: ["skill_id"]
+    },
+    group: "account",
+    need: account3,
+    risk: "W1",
+    idempotent: true,
+    run: async (ctx, a) => {
+      const r = await ctx.api.skills.react(String(a.skill_id), "like", !a.undo);
+      return { skill_id: r.item, liked: r.liked, likes: r.counts.likes };
+    }
+  }),
+  tool({
+    name: "skill_save",
+    description: "Save a skill to the user's saved skills on cmo.so (or remove it with undo), to find it again at cmo.so/skills/saved or with skills_saved_list.",
+    parameters: {
+      type: "object",
+      properties: { skill_id: ID, undo: { type: "boolean", description: "true removes it from saved" } },
+      required: ["skill_id"]
+    },
+    group: "account",
+    need: account3,
+    risk: "W1",
+    idempotent: true,
+    run: async (ctx, a) => {
+      const r = await ctx.api.skills.react(String(a.skill_id), "save", !a.undo);
+      return { skill_id: r.item, saved: r.saved };
+    }
+  }),
+  tool({
+    name: "skills_saved_list",
+    description: "The skills the user saved on cmo.so, newest first.",
+    parameters: none,
+    group: "account",
+    need: account3,
+    risk: "R0",
+    run: async (ctx) => ({
+      skills: (await ctx.api.skills.saved()).skills.map((s) => ({
+        id: s.id,
+        name: s.name,
+        summary: s.summary,
+        page: s.url
+      }))
+    })
+  }),
+  tool({
+    name: "skill_submit",
+    description: "Suggest a public open-source GitHub repo for cmo.so's skill library. Maggie researches it within minutes and decides: add a new skill, improve an existing one, keep it as a candidate that needs 10 likes in 30 days, or decline (licence first: permissive licences can be adapted, copyleft only inspires, no licence is declined). 3 suggestions a day. Follow up with skill_submissions_list.",
+    parameters: {
+      type: "object",
+      properties: {
+        repo_url: { type: "string", description: "https://github.com/owner/name" },
+        note: { type: "string", description: "Optional: why it is useful, \u2264500 characters" }
+      },
+      required: ["repo_url"]
+    },
+    group: "account",
+    need: account3,
+    risk: "W1",
+    run: async (ctx, a) => {
+      const r = await ctx.api.skills.submit(String(a.repo_url), a.note ? String(a.note).slice(0, 500) : void 0);
+      return r.duplicate ? { already_suggested: true, id: r.id, status: r.status, reasons: r.reasons ?? null } : { submitted: true, id: r.id, status: r.status, repo: r.repo };
+    }
+  }),
+  tool({
+    name: "skill_submissions_list",
+    description: "The repos the user suggested for the skill library and what happened to each: queued, researching, candidate (with its deadline), publishing, published (with the skill), declined, expired or failed, with Maggie's reasons.",
+    parameters: none,
+    group: "account",
+    need: account3,
+    risk: "R0",
+    run: async (ctx) => ({
+      items: (await ctx.api.skills.submissions()).items.slice(0, 20).map((s) => ({
+        id: s.id,
+        repo: s.repo,
+        status: s.status,
+        skill: s.target_skill,
+        reasons: clip(s.reasons, 500),
+        candidate_until: s.candidate_until,
+        suggested: s.created_at
+      }))
+    })
+  })
+];
+
 // ../../packages/tools/src/social.ts
 var read5 = { resource: "autopilot", level: "read" };
 var write5 = { resource: "autopilot", level: "write" };
@@ -12154,7 +12345,8 @@ var tools = [
   ...socialTools,
   ...teamTools,
   ...memoryTools,
-  ...feedbackTools
+  ...feedbackTools,
+  ...skillTools
 ];
 var toolByName = new Map(tools.map((t) => [t.name, t]));
 function allowed(t, a) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/mcp",
-	"version": "0.7.3",
+	"version": "0.7.5",
 	"description": "CMO.so's MCP server for Claude Desktop, Cursor, VS Code and other MCP clients: manage your websites, blog posts, LinkedIn queue and results with Maggie.",
 	"type": "module",
 	"license": "MIT",