rankcontrol 0.8.1 → 0.8.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rankcontrol",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "RankControl CLI + MCP server: drive your SEO/AI-visibility workspace from the terminal or any AI agent",
   "license": "MIT",
   "homepage": "https://rctrl.com",

package/src/cli.mjs

@@ -63,6 +63,11 @@ export function runCli(argv) {
     .description("Composite visibility score blending AI citation rate with Google and Bing rank share, with subscores")
     .action(() => api.visibilityScore().then(out).catch(fail));
 
+  program
+    .command("expedition")
+    .description("First-run setup progress: five acts with per-step completion and the current act")
+    .action(() => api.expedition().then(out).catch(fail));
+
   program
     .command("visibility")
     .description("Daily AI visibility score trend from the stored weekly citation checks")
@@ -414,7 +419,7 @@ export function runCli(argv) {
   program
     .command("generate <contentId>")
     .description("Write a planned article's body now, keeping its publish slot (past-due or ≤3 days ahead; dry run unless --confirm)")
-    .option("--confirm", "Actually start generation (spends LLM budget)")
+    .option("--confirm", "Actually start generation (costly)")
     .action((contentId, opts) =>
       api.generateContent(contentId, !!opts.confirm).then(out).catch(fail)
     );
@@ -531,7 +536,7 @@ export function runCli(argv) {
 
   program
     .command("repurpose-generate <contentId>")
-    .description("Draft social posts for a published article (dry run unless --confirm; spends LLM budget)")
+    .description("Draft social posts for a published article (dry run unless --confirm; costly)")
     .option(
       "--platforms <a,b>",
       "Subset: linkedin,twitter,pinterest,instagram,facebook,threads,youtube,tiktok"

package/src/client.mjs

@@ -103,6 +103,7 @@ export const api = {
     return request("GET", `/api/v1/citations${qs ? `?${qs}` : ""}`);
   },
   visibilityScore: () => request("GET", "/api/v1/visibility/score"),
+  expedition: () => request("GET", "/api/v1/expedition"),
   planningCapacity: () => request("GET", "/api/v1/content/planning-capacity"),
   jobs: (limit = 20) => request("GET", `/api/v1/jobs?limit=${limit}`),
   content: () => request("GET", "/api/v1/content"),

package/src/mcp.mjs

@@ -29,7 +29,7 @@ const plannedTitle = z.object({
 });
 
 export async function startMcpServer() {
-  const server = new McpServer({ name: "rankcontrol", version: "0.8.1" });
+  const server = new McpServer({ name: "rankcontrol", version: "0.8.3" });
 
   server.tool(
     "get_overview_funnel",
@@ -40,7 +40,7 @@ export async function startMcpServer() {
 
   server.tool(
     "get_visibility_trend",
-    "Daily AI visibility score series (share of weekly citation checks where the brand was cited across the 6 tracked AI engines). Data comes from RankControl's stored weekly checks.",
+    "Daily AI visibility score series across the 6 tracked AI engines, from RankControl's stored weekly citation checks.",
     { days: z.enum(["30", "60", "90"]).optional().describe("Window size in days, default 30") },
     run(({ days }) => api.visibilityTrend(days ? Number(days) : 30))
   );
@@ -62,6 +62,13 @@ export async function startMcpServer() {
     run(() => api.visibilityScore())
   );
 
+  server.tool(
+    "get_setup_progress",
+    "First-run setup progress for the workspace: five acts from first article live through analytics, each with per-step completion, plus the current act. Use to tell the user what remains to finish setting up.",
+    {},
+    run(() => api.expedition())
+  );
+
   server.tool(
     "get_citability_report",
     "Published pages ranked by citability score (how extractable each page is for AI answers), worst first, each with its top open fixes. Use to decide which articles to improve.",
@@ -339,7 +346,7 @@ export async function startMcpServer() {
 
   server.tool(
     "find_outreach_contact",
-    "Find an outreach email for one prospect by scraping their site (mailto links, contact page, obfuscated text; Prospeo fallback when configured). Returns the stored contact or found:false. Capped at 5/min.",
+    "Find an outreach email for one prospect site. Returns the stored contact or found:false. Capped at 5/min.",
     { backlinkId: z.string().describe("Prospect id from list_outreach_prospects") },
     run(({ backlinkId }) => api.outreachFindContact(backlinkId))
   );
@@ -353,7 +360,7 @@ export async function startMcpServer() {
 
   server.tool(
     "queue_outreach_email",
-    "Queue an outreach email to a prospect. It sends from the workspace's own connected mailbox, paced ~1 per 10 minutes up to the daily cap. Uses the stored draft unless subject/body are given. Dry-run unless confirm is true — a confirmed queue leads to a REAL email being sent.",
+    "Queue an outreach email to a prospect. It sends from the workspace's own connected mailbox, paced automatically with a daily cap. Uses the stored draft unless subject/body are given. Dry-run unless confirm is true — a confirmed queue leads to a REAL email being sent.",
     {
       backlinkId: z.string().describe("Prospect id from list_outreach_prospects"),
       subject: z.string().optional().describe("Override the drafted subject"),
@@ -379,7 +386,7 @@ export async function startMcpServer() {
 
   server.tool(
     "plan_content",
-    "Generate candidate article titles (capacity-gated). This DOES NOT put anything on the calendar: review the returned titles, then call commit_planned_titles with the keepers. Costs an LLM call; capped at 5/min.",
+    "Generate candidate article titles (capacity-gated). This DOES NOT put anything on the calendar: review the returned titles, then call commit_planned_titles with the keepers. Costly; capped at 5/min.",
     {
       topics: z.array(z.string()).optional().describe("Brand topics to focus on; omit for auto"),
       contentTypes: z.array(z.string()).optional(),
@@ -413,7 +420,7 @@ export async function startMcpServer() {
 
   server.tool(
     "generate_article",
-    "Write a PLANNED article's body immediately instead of waiting for the scheduled pipeline (generate-only: its publish slot is unchanged). Allowed for past-due slots and up to 3 days ahead. Defaults to a DRY RUN; a human should approve before calling again with confirm=true since generation spends LLM budget.",
+    "Write a PLANNED article's body immediately instead of waiting for the scheduled pipeline (generate-only: its publish slot is unchanged). Allowed for past-due slots and up to 3 days ahead. Defaults to a DRY RUN; a human should approve before calling again with confirm=true since generation is costly.",
     {
       contentId: z.string().describe("The planned content page id"),
       confirm: z.boolean().optional().describe("Set true to actually start generation (default: dry run)"),
@@ -432,7 +439,7 @@ export async function startMcpServer() {
 
   server.tool(
     "get_article_settings",
-    "The workspace article policy: per-article defaults (auto-write, auto-publish, images, title-in-hero, section infographics, Related Reading, YouTube, emojis, link counts, global instructions) plus the flexible-scheduling flag.",
+    "The workspace article policy: per-article defaults (auto-write, auto-publish, images, title-in-hero, section infographics, Related Reading, YouTube, emojis, link counts, global instructions) plus the flexible-scheduling flag. News and trending articles always publish manually, regardless of auto-publish.",
     {},
     run(() => api.articleSettings())
   );
@@ -529,7 +536,7 @@ export async function startMcpServer() {
 
   server.tool(
     "generate_repurpose_drafts",
-    "Draft platform-native social posts for a published article. Regeneration replaces unposted drafts for the chosen platforms. Defaults to a DRY RUN; confirm=true generates (spends LLM budget).",
+    "Draft platform-native social posts for a published article. Regeneration replaces unposted drafts for the chosen platforms. Defaults to a DRY RUN; confirm=true generates (costly).",
     {
       contentId: z.string(),
       platforms: z