@cmo-so/mcp 0.7.4 → 0.7.6

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.4",
+  version: "0.7.6",
   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,32 @@ 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)}`),
+      /** Vote on or save a skill (on: false undoes it). "like" is an upvote. */
+      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(
@@ -8366,6 +8392,10 @@ var confirmCopy = {
     en: (a) => `Remove the call-to-action for ${q(a.target_keyword)}.`,
     "zh-Hant": (a) => `\u522A\u9664 ${q(a.target_keyword)} \u7684\u884C\u52D5\u547C\u7C72\u3002`
   },
+  internal_links_set: {
+    en: (a) => Number(a.count) ? `Link each new post to ${a.count} of your latest articles.` : "Stop linking new posts to your other articles.",
+    "zh-Hant": (a) => Number(a.count) ? `\u6BCF\u7BC7\u65B0\u6587\u7AE0\u9023\u7D50\u5230\u4F60\u6700\u65B0\u7684 ${a.count} \u7BC7\u6587\u7AE0\u3002` : "\u65B0\u6587\u7AE0\u4E0D\u518D\u9023\u7D50\u5230\u4F60\u7684\u5176\u4ED6\u6587\u7AE0\u3002"
+  },
   testimonial_upsert: {
     en: (a) => `Save the testimonial from ${a.name}${a.use_in_posts ? " and use testimonials in posts" : ""}.`,
     "zh-Hant": (a) => `\u5132\u5B58 ${a.name} \u7684\u5BA2\u6236\u8A55\u50F9${a.use_in_posts ? "\uFF0C\u4E26\u5728\u6587\u7AE0\u88E1\u4F7F\u7528\u8A55\u50F9" : ""}\u3002`
@@ -8612,6 +8642,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 upvote on" : "Upvote"} the skill ${q(a.skill_id)} on cmo.so.`,
+    "zh-Hant": (a) => `${a.undo ? "\u6536\u56DE\u5C0D" : "\u5728 cmo.so \u6295\u7968\u652F\u6301"}\u6280\u80FD ${q(a.skill_id)}${a.undo ? " \u7684\u652F\u6301\u7968" : ""}\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"
@@ -9630,6 +9673,24 @@ var brandTools = [
       return { ctas: out.ctas?.map((c) => c.target_keyword) };
     }
   }),
+  tool({
+    name: "internal_links_set",
+    description: "Set how many of the website's own latest articles each new post links to (internal cross-links, picked for the topic; separate from CTAs). 0 turns it off, max 10, default 3.",
+    parameters: {
+      type: "object",
+      properties: { count: { type: "integer", minimum: 0, maximum: 10 } },
+      required: ["count"]
+    },
+    group: "brand",
+    need: write2,
+    risk: "W1",
+    run: async (ctx, { count }) => {
+      const n = Math.round(Number(count));
+      if (!Number.isFinite(n) || n < 0 || n > 10) throw new Error("count must be 0 to 10.");
+      const out = await ws(ctx).updateBrand({ internal_links: { count: n } });
+      return { internal_links: out.internal_links ?? { count: n } };
+    }
+  }),
   tool({
     name: "testimonial_upsert",
     description: "Add a customer testimonial, or change the one from the same person. Only real quotes the user gives (or examples they asked for). use_in_posts turns testimonials on in posts.",
@@ -10702,6 +10763,161 @@ 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, vote score 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,
+          score: s.score ?? 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,
+        score: s.score ?? 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: "Upvote a skill in the cmo.so library for the user (or take the upvote back with undo). Votes 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 upvote 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, upvoted: r.liked, score: r.counts.score ?? 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 under Saved at cmo.so/skills 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 a vote score of 10 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" };
@@ -12158,7 +12374,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.4",
+	"version": "0.7.6",
 	"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",