rankcontrol 0.8.0 → 0.8.2

package/README.md

@@ -154,7 +154,7 @@ Or in `.mcp.json` / Cursor `mcp.json`:
 | Tool | What it does |
 |---|---|
 | `get_overview_funnel` | AI crawls / AI visits, last 30 days |
-| `get_visibility_score` | Composite score (50% AI + 30% Google + 20% Bing) with subscores |
+| `get_visibility_score` | Composite score blending AI citations with Google and Bing rank share, with subscores |
 | `get_visibility_trend` | Daily visibility score from stored weekly citation checks |
 | `get_share_of_voice` | Your citation rate vs competitor mention rates + your share |
 | `get_citation_sources` | Cited domains typed brand / competitive / UGC / editorial |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rankcontrol",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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

@@ -60,7 +60,7 @@ export function runCli(argv) {
 
   program
     .command("score")
-    .description("Composite visibility score: 50% AI citation rate + 30% Google + 20% Bing rank share, with subscores")
+    .description("Composite visibility score blending AI citation rate with Google and Bing rank share, with subscores")
     .action(() => api.visibilityScore().then(out).catch(fail));
 
   program
@@ -414,7 +414,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 +531,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/mcp.mjs

@@ -29,7 +29,7 @@ const plannedTitle = z.object({
 });
 
 export async function startMcpServer() {
-  const server = new McpServer({ name: "rankcontrol", version: "0.8.0" });
+  const server = new McpServer({ name: "rankcontrol", version: "0.8.2" });
 
   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))
   );
@@ -57,7 +57,7 @@ export async function startMcpServer() {
 
   server.tool(
     "get_visibility_score",
-    "Composite visibility score for the workspace: 50% AI citation rate + 30% Google + 20% Bing position-weighted top-10 rank share (top 3 = full credit, 4-10 = half). Returns the composite, weights, and per-pillar subscores (the AI pillar includes a per-model breakdown).",
+    "Composite AI visibility score for the workspace, blending AI citation rate across the tracked models with Google and Bing rank share. Returns the composite and per-pillar subscores (the AI pillar includes a per-model breakdown).",
     {},
     run(() => api.visibilityScore())
   );
@@ -339,7 +339,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 +353,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 +379,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 +413,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)"),
@@ -529,7 +529,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