rankcontrol 0.2.0 → 0.6.0

package/README.md

@@ -29,13 +29,38 @@ The env var wins over the stored config when both exist. Scopes are set per key;
 
 ```bash
 npx rankcontrol funnel                 # AI crawls / AI visits / AI leads (30d)
+npx rankcontrol score                  # composite visibility score + subscores (AI/Google/Bing)
+npx rankcontrol leads --limit 100      # captured leads with AI source attribution
+npx rankcontrol traffic --days 30      # page views, visitors, bounce rate, time on page
 npx rankcontrol visibility --days 60   # daily AI visibility score trend
+npx rankcontrol sov --days 30          # share of voice vs competitors
+npx rankcontrol sources --days 30      # cited domains typed brand/competitive/ugc/editorial
+npx rankcontrol sentiment --days 30    # how AI answers frame your brand
+npx rankcontrol optimizer --limit 25   # pages ranked by citability, worst first
 npx rankcontrol citations --model chatgpt
+npx rankcontrol queries                # tracked queries checked weekly across AI engines
 npx rankcontrol capacity               # remaining content-plan slots
 npx rankcontrol plan-content --topics "bus travel" --max-difficulty 40
 npx rankcontrol commit-titles --file titles.json
 npx rankcontrol publish <contentId>            # dry run
 npx rankcontrol publish <contentId> --confirm  # actually publish
+npx rankcontrol generate <contentId>           # dry run
+npx rankcontrol generate <contentId> --confirm # write a planned article now (slot unchanged)
+npx rankcontrol settings               # article policy (auto-write, auto-publish, images, ...)
+npx rankcontrol settings-set --auto-generate off --auto-publish off
+npx rankcontrol reschedule <contentId> 2026-08-04
+npx rankcontrol internal-links <contentId>     # who links here / links out
+npx rankcontrol site-pages             # pages used for internal links
+npx rankcontrol detect-links https://example.com/sitemap.xml
+npx rankcontrol add-pages https://example.com/pricing
+npx rankcontrol repurpose              # published articles + social draft chips
+npx rankcontrol repurpose <contentId>  # full drafts for one article
+npx rankcontrol repurpose-generate <contentId> --platforms twitter --confirm
+npx rankcontrol repurpose-edit <draftId> --title "New hook"
+npx rankcontrol repurpose-channels     # Postiz channel ids (for repurpose-push)
+npx rankcontrol repurpose-push <draftId> --channels <id>   # dry run
+npx rankcontrol repurpose-push <draftId> --channels <id> --confirm
+npx rankcontrol repurpose-mark-posted <draftId>            # posted it yourself
 npx rankcontrol jobs                   # async job status (agent runs)
 ```
 
@@ -66,14 +91,34 @@ Or in `.mcp.json` / Cursor `mcp.json`:
 | Tool | What it does |
 |---|---|
 | `get_overview_funnel` | AI crawls / AI visits / AI leads, last 30 days |
+| `list_leads` | Captured leads with AI model / query / page attribution |
+| `get_traffic_overview` | Page views, visitors, sessions, bounce rate, time on page |
 | `get_visibility_trend` | Daily visibility score from stored weekly citation checks |
 | `list_citations` | Recent citation checks per AI model |
-| `get_visibility_score` | Current overall AI visibility score |
+| `list_tracked_queries` | The queries checked weekly across the AI engines |
+| `get_visibility_score` | Composite score (50% AI + 30% Google + 20% Bing) with subscores |
+| `get_share_of_voice` | Your citation rate vs competitor mention rates + your share |
+| `get_citation_sources` | Cited domains typed brand / competitive / UGC / editorial |
+| `get_citation_sentiment` | Positive / neutral / negative framing with recent receipts |
+| `get_citability_report` | Published pages by citability score, worst first, with fixes |
 | `get_planning_capacity` | Remaining calendar slots (check before planning) |
 | `plan_content` | Generate candidate titles (capacity-gated, nothing scheduled) |
 | `commit_planned_titles` | Approve reviewed titles onto the calendar |
 | `publish_content` | Dry run by default; `confirm: true` publishes |
+| `generate_article` | Write a planned article's body now, slot unchanged; dry run by default |
+| `get_article_settings` / `update_article_settings` | Read / merge-patch the article policy (auto-write, auto-publish, images, links, ...) |
+| `reschedule_article` | Move a planned article to another day (flexible schedule) |
+| `get_internal_links` | Who links to this article internally, and its outbound count |
+| `list_site_pages` / `add_site_pages` | Pages used for in-article internal links |
+| `detect_site_links` | Scan a sitemap or blog root for site pages |
+| `list_repurpose_queue` | Published articles + social draft chips per platform |
+| `get_repurpose_drafts` | Full social drafts for one article (8 platforms) |
+| `generate_repurpose_drafts` | Draft social posts for an article; dry run by default |
+| `update_repurpose_draft` | Edit a draft's body/title before pushing |
+| `mark_repurpose_posted` | Record a draft as posted manually |
+| `list_postiz_channels` | Connected Postiz channels (ids for pushing) |
+| `push_repurpose_draft` | Send a draft to Postiz; dry run by default |
 | `list_content` | Content pages with status |
 | `list_jobs` | Async job status (agent runs) |
 
-The plan→commit split is intentional: `plan_content` proposes, a human (or a supervising agent) reviews, `commit_planned_titles` approves. `publish_content` is dry-run-first for the same reason.
+The plan→commit split is intentional: `plan_content` proposes, a human (or a supervising agent) reviews, `commit_planned_titles` approves. `publish_content` and `generate_article` are dry-run-first for the same reason.

package/package.json

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

@@ -12,13 +12,16 @@ const fail = (err) => {
 const list = (val) => val.split(",").map((s) => s.trim()).filter(Boolean);
 
 export function runCli(argv) {
+  const pkg = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8")
+  );
   const program = new Command();
   program
     .name("rankcontrol")
     .description(
       "RankControl from the terminal. Auth: `rankcontrol login` (browser approval) or export RANKCONTROL_API_KEY=rctrl_pk_..."
     )
-    .version("0.2.0");
+    .version(pkg.version);
 
   program
     .command("mcp")
@@ -50,12 +53,53 @@ export function runCli(argv) {
     .description("AI pipeline last 30 days: crawls, AI visits, AI leads")
     .action(() => api.overviewFunnel().then(out).catch(fail));
 
+  program
+    .command("leads")
+    .description("Captured leads with source attribution (AI model, query, page)")
+    .option("--limit <n>", "Max rows, up to 500", "100")
+    .action((opts) => api.leads(Number(opts.limit)).then(out).catch(fail));
+
+  program
+    .command("traffic")
+    .description("Traffic overview: page views, visitors, sessions, bounce rate, time on page")
+    .option("--days <n>", "7, 30 or 90", "30")
+    .action((opts) => api.trafficOverview(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("score")
+    .description("Composite visibility score: 50% AI citation rate + 30% Google + 20% Bing rank share, with subscores")
+    .action(() => api.visibilityScore().then(out).catch(fail));
+
   program
     .command("visibility")
     .description("Daily AI visibility score trend from the stored weekly citation checks")
     .option("--days <n>", "30, 60 or 90", "30")
     .action((opts) => api.visibilityTrend(Number(opts.days)).then(out).catch(fail));
 
+  program
+    .command("sov")
+    .description("Share of voice: your citation rate vs top competitors, plus your share of all brand appearances")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.shareOfVoice(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("sources")
+    .description("Domains AI answers cite for your tracked queries, typed brand/competitive/ugc/editorial")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.citationSources(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("sentiment")
+    .description("How AI answers frame your brand when cited: positive/neutral/negative with recent receipts")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.citationSentiment(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("optimizer")
+    .description("Published pages ranked by citability score, worst first, with their open fixes")
+    .option("--limit <n>", "Max rows", "25")
+    .action((opts) => api.optimizer(Number(opts.limit)).then(out).catch(fail));
+
   program
     .command("citations")
     .description("Recent AI citation checks")
@@ -68,11 +112,115 @@ export function runCli(argv) {
         .catch(fail)
     );
 
+  program
+    .command("queries")
+    .description("List the tracked queries checked weekly across the AI engines")
+    .action(() => api.trackedQueries().then(out).catch(fail));
+
+  program
+    .command("crawler-access")
+    .description("Daily AI-crawler reachability probe: is the site's edge or robots.txt blocking GPTBot/ClaudeBot")
+    .action(() => api.crawlerAccess().then(out).catch(fail));
+
+  program
+    .command("query-add")
+    .description("Add a query to the tracking pool (tracks immediately when a plan slot is free)")
+    .argument("<queryText>", "The search/AI query to track")
+    .action((queryText) => api.addQuery(queryText).then(out).catch(fail));
+
   program
     .command("capacity")
     .description("Remaining plan slots on the content calendar")
     .action(() => api.planningCapacity().then(out).catch(fail));
 
+  program
+    .command("team")
+    .description("Workspace members and pending invites (owner surface)")
+    .action(() => api.team().then(out).catch(fail));
+
+  program
+    .command("team-invite")
+    .description("Invite a member (dry-run by default; --confirm sends the email)")
+    .argument("<email>", "Invitee email")
+    .option(
+      "--perms <area=level,...>",
+      "Per-screen levels, e.g. content=write,analytics=read (unspecified screens default to none)"
+    )
+    .option("--confirm", "Actually send the invite")
+    .action((email, opts) => {
+      const screenPermissions = {};
+      for (const pair of (opts.perms ?? "").split(",").filter(Boolean)) {
+        const [area, level] = pair.split("=");
+        screenPermissions[area?.trim()] = level?.trim();
+      }
+      return api
+        .teamInvite({
+          email,
+          ...(Object.keys(screenPermissions).length ? { screenPermissions } : {}),
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail);
+    });
+
+  program
+    .command("team-revoke")
+    .description("Revoke a pending invite")
+    .argument("<invitationId>", "Invitation id from `team`")
+    .action((invitationId) => api.teamRevoke(invitationId).then(out).catch(fail));
+
+  program
+    .command("team-remove")
+    .description("Remove a member (requires --confirm)")
+    .argument("<userId>", "Member user id from `team`")
+    .option("--confirm", "Actually remove the member")
+    .action((userId, opts) =>
+      api
+        .teamRemove({ userId, confirm: !!opts.confirm })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("outreach-prospects")
+    .description("Link outreach pipeline with any found contact emails")
+    .action(() => api.outreachProspects().then(out).catch(fail));
+
+  program
+    .command("outreach-find-contact")
+    .description("Find an outreach email for a prospect (scrapes their site)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .action((backlinkId) =>
+      api.outreachFindContact(backlinkId).then(out).catch(fail)
+    );
+
+  program
+    .command("outreach-draft-reply")
+    .description("AI-draft a reply to a prospect's inbound response (nothing sends)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .action((backlinkId) =>
+      api.outreachDraftReply(backlinkId).then(out).catch(fail)
+    );
+
+  program
+    .command("outreach-queue")
+    .description("Queue an outreach email to send from the connected mailbox (dry-run by default)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .option("--subject <subject>", "Override the drafted subject")
+    .option("--body <body>", "Override the drafted body")
+    .option("--confirm", "Actually queue the send")
+    .action((backlinkId, opts) =>
+      api
+        .outreachQueue({
+          backlinkId,
+          ...(opts.subject ? { subject: opts.subject } : {}),
+          ...(opts.body ? { body: opts.body } : {}),
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
   program
     .command("jobs")
     .description("Recent agent runs (async job status)")
@@ -131,5 +279,342 @@ export function runCli(argv) {
       api.publishContent(contentId, !!opts.confirm).then(out).catch(fail)
     );
 
+  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)")
+    .action((contentId, opts) =>
+      api.generateContent(contentId, !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("settings")
+    .description("Show the article policy: per-article defaults + flexible scheduling")
+    .action(() => api.articleSettings().then(out).catch(fail));
+
+  const onOff = (val) => {
+    if (val === "on" || val === "true") return true;
+    if (val === "off" || val === "false") return false;
+    throw new Error(`Expected on|off, got "${val}"`);
+  };
+
+  program
+    .command("settings-set")
+    .description("Merge-patch the article policy (only flags you pass change)")
+    .option("--auto-publish <on|off>")
+    .option("--auto-generate <on|off>", "Off = fully manual: write articles only on demand (generate command / Write now)")
+    .option("--images <on|off>", "AI hero + section images")
+    .option("--title-in-hero <on|off>", "Write the post title into the hero image")
+    .option("--section-infographics <on|off>", "Informational panels in 2,000+ word articles")
+    .option("--related-reading <on|off>", "Related Reading link block at the end")
+    .option("--youtube <on|off>", "Embedded video suggestions")
+    .option("--emojis <on|off>")
+    .option("--internal-links <n>", "Internal links per article (1-20)")
+    .option("--external-links <n>", "Outbound authority links per article (0-15)")
+    .option("--instructions <text>", "Global editorial instructions")
+    .option("--flexible-schedule <on|off>", "1-5 articles/day + calendar drag-and-drop")
+    .option(
+      "--image-style <set>",
+      "Image style set for all generated images: classic-editorial | print-craft | storybook-painterly | modern-saas | dark-premium | bold-poster"
+    )
+    .action((opts) => {
+      try {
+        const s = {};
+        if (opts.autoPublish !== undefined) s.autoPublish = onOff(opts.autoPublish);
+        if (opts.autoGenerate !== undefined) s.autoGenerate = onOff(opts.autoGenerate);
+        if (opts.images !== undefined) s.includeInfographics = onOff(opts.images);
+        if (opts.titleInHero !== undefined) s.titleInHeroImage = onOff(opts.titleInHero);
+        if (opts.sectionInfographics !== undefined)
+          s.includeSectionInfographics = onOff(opts.sectionInfographics);
+        if (opts.relatedReading !== undefined)
+          s.includeRelatedReading = onOff(opts.relatedReading);
+        if (opts.youtube !== undefined) s.includeYouTube = onOff(opts.youtube);
+        if (opts.emojis !== undefined) s.useEmojis = onOff(opts.emojis);
+        if (opts.internalLinks !== undefined)
+          s.internalLinksPerArticle = Number(opts.internalLinks);
+        if (opts.externalLinks !== undefined)
+          s.externalLinksPerArticle = Number(opts.externalLinks);
+        if (opts.instructions !== undefined) s.globalInstructions = opts.instructions;
+        const body = {};
+        if (Object.keys(s).length > 0) body.articleSettings = s;
+        if (opts.flexibleSchedule !== undefined)
+          body.flexibleScheduling = onOff(opts.flexibleSchedule);
+        if (opts.imageStyle !== undefined) body.styleSet = opts.imageStyle;
+        if (Object.keys(body).length === 0)
+          throw new Error("Pass at least one flag to change (see --help)");
+        return api.updateArticleSettings(body).then(out).catch(fail);
+      } catch (err) {
+        fail(err);
+      }
+    });
+
+  program
+    .command("reschedule <contentId> <date>")
+    .description("Move a planned article to a day (YYYY-MM-DD, local time; needs the flexible schedule)")
+    .action((contentId, date) => {
+      const day = new Date(`${date}T00:00:00`);
+      if (Number.isNaN(day.getTime())) return fail(new Error("Date must be YYYY-MM-DD"));
+      return api.reschedule(contentId, day.getTime()).then(out).catch(fail);
+    });
+
+  program
+    .command("internal-links <contentId>")
+    .description("Inbound and outbound internal links recorded for an article (from the publish-time link graph)")
+    .action((contentId) => api.internalLinks(contentId).then(out).catch(fail));
+
+  program
+    .command("site-pages")
+    .description("List the site pages used for in-article links and Related Reading")
+    .action(() => api.sitePages().then(out).catch(fail));
+
+  program
+    .command("detect-links <url>")
+    .description("Scan a sitemap (nested indexes too) or a blog root page for site pages")
+    .option("--blog-root", "Treat the URL as a page to crawl instead of a sitemap")
+    .action((url, opts) =>
+      api
+        .detectSiteLinks(opts.blogRoot ? "blogroot" : "sitemap", url)
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("add-pages <urls...>")
+    .description("Add site page URLs for internal linking (dedupes; titles auto-fill)")
+    .action((urls) => api.addSitePages(urls).then(out).catch(fail));
+
+  program
+    .command("repurpose [contentId]")
+    .description("Repurpose queue (published articles + draft chips), or full drafts for one article")
+    .action((contentId) =>
+      (contentId ? api.repurposeDrafts(contentId) : api.repurposeQueue())
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-generate <contentId>")
+    .description("Draft social posts for a published article (dry run unless --confirm; spends LLM budget)")
+    .option(
+      "--platforms <a,b>",
+      "Subset: linkedin,twitter,pinterest,instagram,facebook,threads,youtube,tiktok"
+    )
+    .option("--confirm", "Actually generate")
+    .action((contentId, opts) =>
+      api
+        .repurposeGenerate({
+          contentId,
+          platforms: opts.platforms ? list(opts.platforms) : undefined,
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-edit <draftId>")
+    .description("Edit a repurpose draft's text/title before pushing")
+    .option("--body <text>")
+    .option("--title <text>")
+    .action((draftId, opts) =>
+      api
+        .repurposeEditDraft({ draftId, body: opts.body, title: opts.title })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-mark-posted <draftId>")
+    .description("Mark a draft as posted (you published it yourself)")
+    .action((draftId) => api.repurposeMarkPosted(draftId).then(out).catch(fail));
+
+  program
+    .command("repurpose-channels")
+    .description("Connected Postiz channels (ids needed for repurpose-push)")
+    .action(() => api.repurposeChannels().then(out).catch(fail));
+
+  program
+    .command("repurpose-push <draftId>")
+    .description("Send a draft to Postiz (dry run unless --confirm)")
+    .option("--channels <id1,id2>", "Postiz channel ids (see repurpose-channels)")
+    .option("--when <now|schedule|draft>", "Postiz mode", "now")
+    .option("--date <iso>", "ISO time for --when schedule")
+    .option("--confirm", "Actually push (publicly visible)")
+    .action((draftId, opts) =>
+      api
+        .repurposePush({
+          draftId,
+          integrationIds: opts.channels ? list(opts.channels) : undefined,
+          scheduleType: opts.when,
+          date: opts.date,
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  const parseJson = (raw, label) => {
+    try {
+      return JSON.parse(raw.startsWith("@") ? readFileSync(raw.slice(1), "utf8") : raw);
+    } catch {
+      fail(new Error(`--json for ${label} must be valid JSON (or @file.json)`));
+    }
+  };
+
+  program
+    .command("ideas")
+    .description("Scored content-idea backlog: uncovered queries, citation gaps, quick wins")
+    .action(() => api.contentIdeas().then(out).catch(fail));
+
+  program
+    .command("plan-idea <queryText>")
+    .description("Put an idea on the content calendar (uses its stored title, or generates one)")
+    .option("--title <title>", "Exact headline to plan")
+    .action((queryText, opts) =>
+      api.planIdea({ queryText, title: opts.title }).then(out).catch(fail)
+    );
+
+  program
+    .command("archive <contentId>")
+    .description("Archive an article (removes it from the working set)")
+    .action((contentId) => api.archiveContent(contentId).then(out).catch(fail));
+
+  program
+    .command("engagement")
+    .description("Per-page views + citations for the last 30 days, with view sparklines")
+    .action(() => api.pageEngagement().then(out).catch(fail));
+
+  program
+    .command("report")
+    .description("Executive summary: last 30 days vs the 30 before (citations, views, crawls, publishing)")
+    .action(() => api.reportSummary().then(out).catch(fail));
+
+  program
+    .command("wins")
+    .description("Biggest wins of the last 30 days: top cited page, cite-rate jump, ranking climb, best backlink")
+    .action(() => api.reportWins().then(out).catch(fail));
+
+  program
+    .command("agent-activity")
+    .description("Recent runs per agent lane (brand control, radar, forge, deploy, ...)")
+    .option("--per-agent <n>", "Runs per lane, up to 50", "15")
+    .option("--since-days <n>", "Window in days", "30")
+    .action((opts) =>
+      api
+        .agentActivity({ perAgent: Number(opts.perAgent), sinceDays: Number(opts.sinceDays) })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("backlinks")
+    .description("The backlink table, newest first")
+    .option("--status <status>", "Filter: discovered, verified, lost, identified, contacted, replied, link_placed, rejected")
+    .action((opts) => api.backlinks(opts.status).then(out).catch(fail));
+
+  program
+    .command("backlink-stats")
+    .description("Backlink totals + the outreach pipeline counts")
+    .action(() => api.backlinkStats().then(out).catch(fail));
+
+  program
+    .command("outreach-status <backlinkId> <status>")
+    .description("Move an outreach prospect through the pipeline (identified|contacted|replied|link_placed|rejected)")
+    .action((backlinkId, status) =>
+      api.outreachStatus(backlinkId, status).then(out).catch(fail)
+    );
+
+  program
+    .command("network")
+    .description("Link Network credit stats, membership state, and hosted/received placements")
+    .action(() => api.linkNetwork().then(out).catch(fail));
+
+  program
+    .command("network-opt-in <on|off>")
+    .description("Join or leave the Link Network (dry run unless --confirm; leaving retires live links)")
+    .option("--confirm", "Actually change membership")
+    .action((state, opts) =>
+      api.linkNetworkOptIn(state === "on", !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("network-remove-placement <placementId>")
+    .description("Retire one network placement (dry run unless --confirm; visible on the partner site)")
+    .option("--confirm", "Actually remove it")
+    .action((placementId, opts) =>
+      api.linkNetworkRemovePlacement(placementId, !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("social")
+    .description("Social thread prospects (Reddit/X) with rules context and intent sort")
+    .option("--platform <reddit|twitter>")
+    .option("--status <status>")
+    .option("--age <ranked|new>")
+    .action((opts) =>
+      api
+        .socialThreads({ platform: opts.platform, status: opts.status, age: opts.age })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("social-stats")
+    .description("Social thread pipeline counts")
+    .action(() => api.socialStats().then(out).catch(fail));
+
+  program
+    .command("social-status <threadId> <status>")
+    .description("Move a social thread through the pipeline")
+    .action((threadId, status) =>
+      api.socialStatus(threadId, status).then(out).catch(fail)
+    );
+
+  program
+    .command("social-draft-reply <threadId>")
+    .description("AI-draft a reply for a thread (nothing posts; the draft lands for review)")
+    .option("--mention <none|natural|founderOpen>", "Brand-mention mode")
+    .action((threadId, opts) =>
+      api.socialDraftReply(threadId, opts.mention).then(out).catch(fail)
+    );
+
+  program
+    .command("support <subject>")
+    .description("Send a message or bug report to RankControl support (emails the team, capped 3/min)")
+    .requiredOption("--message <text>", "What happened — include errors, ids, and steps")
+    .option("--page <url>", "Related dashboard or API URL")
+    .action((subject, opts) =>
+      api.support({ subject, message: opts.message, pageUrl: opts.page }).then(out).catch(fail)
+    );
+
+  program
+    .command("brand")
+    .description("Brand profile, products, and buyer profiles (ICPs) in one read")
+    .action(() => api.brand().then(out).catch(fail));
+
+  program
+    .command("brand-profile-set")
+    .description("Patch brand voice/style fields. --json '{\"tone\":\"...\"}' or --json @file.json")
+    .requiredOption("--json <json>", "Fields: tone, primaryColor, secondaryColor, fontFamily, metaTitle, metaDescription, metaKeywords, defaultLocale, flexibleScheduling")
+    .action((opts) =>
+      api.brandProfileSet(parseJson(opts.json, "brand-profile-set")).then(out).catch(fail)
+    );
+
+  program
+    .command("brand-product")
+    .description("Create, update, or delete a product. Create: name+description+category; update: productId + fields; delete: productId + del:true")
+    .requiredOption("--json <json>", "Product JSON (or @file.json)")
+    .action((opts) =>
+      api.brandProductWrite(parseJson(opts.json, "brand-product")).then(out).catch(fail)
+    );
+
+  program
+    .command("brand-icp")
+    .description("Create, update, or delete a buyer profile. Create: title+industry+demographics; update: profileId + fields; delete: profileId + del:true")
+    .requiredOption("--json <json>", "Buyer profile JSON (or @file.json)")
+    .action((opts) =>
+      api.brandIcpWrite(parseJson(opts.json, "brand-icp")).then(out).catch(fail)
+    );
+
   program.parseAsync(argv);
 }

package/src/client.mjs

@@ -87,6 +87,14 @@ export const api = {
   overviewFunnel: () => request("GET", "/api/v1/overview/funnel"),
   visibilityTrend: (days = 30) =>
     request("GET", `/api/v1/visibility/trend?days=${days}`),
+  shareOfVoice: (days = 30) =>
+    request("GET", `/api/v1/visibility/share-of-voice?days=${days}`),
+  citationSources: (days = 30) =>
+    request("GET", `/api/v1/visibility/sources?days=${days}`),
+  citationSentiment: (days = 30) =>
+    request("GET", `/api/v1/visibility/sentiment?days=${days}`),
+  optimizer: (limit = 25) =>
+    request("GET", `/api/v1/content/optimizer?limit=${limit}`),
   citations: (params = {}) => {
     const q = new URLSearchParams();
     if (params.model) q.set("model", params.model);
@@ -103,4 +111,98 @@ export const api = {
     request("POST", "/api/v1/content/plan/commit", opts),
   publishContent: (contentId, confirm = false) =>
     request("POST", "/api/v1/content/publish", { contentId, confirm }),
+  generateContent: (contentId, confirm = false) =>
+    request("POST", "/api/v1/content/generate", { contentId, confirm }),
+  internalLinks: (contentId) =>
+    request(
+      "GET",
+      `/api/v1/content/internal-links?contentId=${encodeURIComponent(contentId)}`
+    ),
+  articleSettings: () => request("GET", "/api/v1/settings/articles"),
+  updateArticleSettings: (opts) =>
+    request("POST", "/api/v1/settings/articles", opts),
+  reschedule: (contentId, targetDayStartMs) =>
+    request("POST", "/api/v1/content/reschedule", { contentId, targetDayStartMs }),
+  sitePages: () => request("GET", "/api/v1/links/pages"),
+  detectSiteLinks: (source, url) =>
+    request("POST", "/api/v1/links/detect", { source, url }),
+  addSitePages: (urls) => request("POST", "/api/v1/links/pages", { urls }),
+  leads: (limit = 100) => request("GET", `/api/v1/leads?limit=${limit}`),
+  repurposeQueue: () => request("GET", "/api/v1/repurpose"),
+  repurposeDrafts: (contentId) =>
+    request(
+      "GET",
+      `/api/v1/repurpose?contentId=${encodeURIComponent(contentId)}`
+    ),
+  repurposeChannels: () => request("GET", "/api/v1/repurpose/channels"),
+  repurposeGenerate: (opts) =>
+    request("POST", "/api/v1/repurpose/generate", opts),
+  repurposeEditDraft: (opts) => request("POST", "/api/v1/repurpose/draft", opts),
+  repurposeMarkPosted: (draftId) =>
+    request("POST", "/api/v1/repurpose/mark-posted", { draftId }),
+  repurposePush: (opts) => request("POST", "/api/v1/repurpose/push", opts),
+  trackedQueries: () => request("GET", "/api/v1/queries"),
+  addQuery: (queryText) => request("POST", "/api/v1/queries", { queryText }),
+  crawlerAccess: () => request("GET", "/api/v1/crawler-access"),
+  trafficOverview: (days = 30) =>
+    request("GET", `/api/v1/analytics/traffic?days=${days}`),
+  team: () => request("GET", "/api/v1/team"),
+  teamInvite: (opts) => request("POST", "/api/v1/team/invite", opts),
+  teamRevoke: (invitationId) =>
+    request("POST", "/api/v1/team/revoke", { invitationId }),
+  teamRemove: (opts) => request("POST", "/api/v1/team/remove", opts),
+  outreachProspects: () => request("GET", "/api/v1/outreach/prospects"),
+  outreachFindContact: (backlinkId) =>
+    request("POST", "/api/v1/outreach/find-contact", { backlinkId }),
+  outreachQueue: (opts) => request("POST", "/api/v1/outreach/queue", opts),
+  outreachDraftReply: (backlinkId) =>
+    request("POST", "/api/v1/outreach/draft-reply", { backlinkId }),
+  contentIdeas: () => request("GET", "/api/v1/content/ideas"),
+  planIdea: (opts) => request("POST", "/api/v1/content/ideas/plan", opts),
+  archiveContent: (contentId) =>
+    request("POST", "/api/v1/content/archive", { contentId }),
+  pageEngagement: () => request("GET", "/api/v1/analytics/engagement"),
+  reportSummary: () => request("GET", "/api/v1/reports/summary"),
+  reportWins: () => request("GET", "/api/v1/reports/wins"),
+  agentActivity: (params = {}) => {
+    const q = new URLSearchParams();
+    if (params.perAgent) q.set("perAgent", String(params.perAgent));
+    if (params.sinceDays) q.set("sinceDays", String(params.sinceDays));
+    const qs = q.toString();
+    return request("GET", `/api/v1/reports/agent-activity${qs ? `?${qs}` : ""}`);
+  },
+  backlinks: (status) =>
+    request(
+      "GET",
+      `/api/v1/backlinks${status ? `?status=${encodeURIComponent(status)}` : ""}`
+    ),
+  backlinkStats: () => request("GET", "/api/v1/backlinks/stats"),
+  outreachStatus: (backlinkId, status) =>
+    request("POST", "/api/v1/outreach/status", { backlinkId, status }),
+  linkNetwork: () => request("GET", "/api/v1/link-network"),
+  linkNetworkOptIn: (optIn, confirm = false) =>
+    request("POST", "/api/v1/link-network/opt-in", { optIn, confirm }),
+  linkNetworkRemovePlacement: (placementId, confirm = false) =>
+    request("POST", "/api/v1/link-network/remove-placement", {
+      placementId,
+      confirm,
+    }),
+  socialThreads: (params = {}) => {
+    const q = new URLSearchParams();
+    if (params.platform) q.set("platform", params.platform);
+    if (params.status) q.set("status", params.status);
+    if (params.age) q.set("age", params.age);
+    const qs = q.toString();
+    return request("GET", `/api/v1/social${qs ? `?${qs}` : ""}`);
+  },
+  socialStats: () => request("GET", "/api/v1/social/stats"),
+  socialStatus: (threadId, status) =>
+    request("POST", "/api/v1/social/status", { threadId, status }),
+  socialDraftReply: (threadId, mentionMode) =>
+    request("POST", "/api/v1/social/draft-reply", { threadId, mentionMode }),
+  support: (opts) => request("POST", "/api/v1/support", opts),
+  brand: () => request("GET", "/api/v1/brand"),
+  brandProfileSet: (opts) => request("POST", "/api/v1/brand/profile", opts),
+  brandProductWrite: (opts) => request("POST", "/api/v1/brand/product", opts),
+  brandIcpWrite: (opts) => request("POST", "/api/v1/brand/icp", opts),
 };

package/src/mcp.mjs

@@ -29,7 +29,7 @@ const plannedTitle = z.object({
 });
 
 export async function startMcpServer() {
-  const server = new McpServer({ name: "rankcontrol", version: "0.2.0" });
+  const server = new McpServer({ name: "rankcontrol", version: "0.6.0" });
 
   server.tool(
     "get_overview_funnel",
@@ -57,11 +57,74 @@ export async function startMcpServer() {
 
   server.tool(
     "get_visibility_score",
-    "Current overall AI visibility score for the workspace.",
+    "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).",
     {},
     run(() => api.visibilityScore())
   );
 
+  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.",
+    { limit: z.number().max(100).optional().describe("Max rows, default 25") },
+    run(({ limit }) => api.optimizer(limit ?? 25))
+  );
+
+  server.tool(
+    "get_citation_sentiment",
+    "How AI answers frame the brand when it's cited: positive / neutral / negative counts, daily trend, and recent answer snippets as receipts.",
+    { days: z.number().min(7).max(90).optional().describe("Window in days, default 30") },
+    run(({ days }) => api.citationSentiment(days ?? 30))
+  );
+
+  server.tool(
+    "get_citation_sources",
+    "Which domains AI engines cite when answering the brand's tracked queries, typed brand / competitive / UGC / editorial with counts and share. Shows where citation presence must be earned.",
+    { days: z.number().min(7).max(90).optional().describe("Window in days, default 30") },
+    run(({ days }) => api.citationSources(days ?? 30))
+  );
+
+  server.tool(
+    "get_share_of_voice",
+    "Share of voice vs competitors: the brand's citation rate, top competitor mention rates, and the brand's share of all brand appearances in AI answers over the window.",
+    { days: z.number().min(7).max(90).optional().describe("Window in days, default 30") },
+    run(({ days }) => api.shareOfVoice(days ?? 30))
+  );
+
+  server.tool(
+    "list_leads",
+    "Captured leads with source attribution: email, name, company, status, lead score, and the AI model / query / page that produced each lead.",
+    { limit: z.number().max(500).optional().describe("Max rows, default 100") },
+    run(({ limit }) => api.leads(limit ?? 100))
+  );
+
+  server.tool(
+    "list_tracked_queries",
+    "The workspace's tracked queries — the questions RankControl checks weekly across the 6 AI engines for brand citations — with their status and metadata.",
+    {},
+    run(() => api.trackedQueries())
+  );
+
+  server.tool(
+    "get_crawler_access",
+    "Daily AI-crawler reachability probe result: whether the site's edge (e.g. Cloudflare Bot Fight Mode) or robots.txt blocks GPTBot/ClaudeBot — a blocked site cannot be read or cited by AI engines.",
+    {},
+    run(() => api.crawlerAccess())
+  );
+
+  server.tool(
+    "add_tracked_query",
+    "Add a query to the tracking pool. It starts weekly AI citation checks immediately when a plan slot is free; otherwise it joins the pool untracked.",
+    { queryText: z.string().describe("The search/AI query to track") },
+    run(({ queryText }) => api.addQuery(queryText))
+  );
+
+  server.tool(
+    "get_traffic_overview",
+    "Traffic overview from RankControl's own page analytics: total page views, unique visitors, sessions, bounce rate, and average time on page.",
+    { days: z.enum(["7", "30", "90"]).optional().describe("Window in days, default 30") },
+    run(({ days }) => api.trafficOverview(days ? Number(days) : 30))
+  );
+
   server.tool(
     "get_planning_capacity",
     "How many article titles can still be planned onto the content calendar within the scheduling horizon. Check before plan_content.",
@@ -69,6 +132,88 @@ export async function startMcpServer() {
     run(() => api.planningCapacity())
   );
 
+  const permLevel = z.enum(["none", "read", "write"]);
+  server.tool(
+    "get_team",
+    "Workspace members and pending invites, with each member's per-screen permission matrix and the seat cap.",
+    {},
+    run(() => api.team())
+  );
+
+  server.tool(
+    "invite_team_member",
+    "Invite a member to the workspace with per-screen none/read/write access (unspecified screens default to none — grant at least one). Dry-run unless confirm is true; confirming sends the invite email.",
+    {
+      email: z.string().describe("Invitee email address"),
+      screenPermissions: z
+        .object({
+          overview: permLevel.optional(),
+          content: permLevel.optional(),
+          visibility: permLevel.optional(),
+          brandControl: permLevel.optional(),
+          linkControl: permLevel.optional(),
+          analytics: permLevel.optional(),
+          reports: permLevel.optional(),
+        })
+        .optional(),
+      confirm: z
+        .boolean()
+        .optional()
+        .describe("Set true to actually send the invite (default dry-run)"),
+    },
+    run((args) => api.teamInvite(args))
+  );
+
+  server.tool(
+    "revoke_team_invite",
+    "Revoke a pending team invite by invitation id (from get_team).",
+    { invitationId: z.string() },
+    run(({ invitationId }) => api.teamRevoke(invitationId))
+  );
+
+  server.tool(
+    "remove_team_member",
+    "Remove a member from the workspace (access revoked immediately). Dry-run unless confirm is true.",
+    {
+      userId: z.string().describe("Member user id from get_team"),
+      confirm: z.boolean().optional(),
+    },
+    run((args) => api.teamRemove(args))
+  );
+
+  server.tool(
+    "list_outreach_prospects",
+    "Link outreach pipeline: prospect sites per published article with status (identified → contacted → replied → link placed) and any contact email already found.",
+    {},
+    run(() => api.outreachProspects())
+  );
+
+  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.",
+    { backlinkId: z.string().describe("Prospect id from list_outreach_prospects") },
+    run(({ backlinkId }) => api.outreachFindContact(backlinkId))
+  );
+
+  server.tool(
+    "draft_outreach_reply",
+    "AI-draft the next reply in an outreach conversation where the prospect has responded (replySnippet present on the prospect). Returns subject/body only — nothing sends; follow with queue_outreach_email to send it.",
+    { backlinkId: z.string().describe("Prospect id from list_outreach_prospects") },
+    run(({ backlinkId }) => api.outreachDraftReply(backlinkId))
+  );
+
+  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.",
+    {
+      backlinkId: z.string().describe("Prospect id from list_outreach_prospects"),
+      subject: z.string().optional().describe("Override the drafted subject"),
+      body: z.string().optional().describe("Override the drafted body"),
+      confirm: z.boolean().optional().describe("Set true to actually queue the send"),
+    },
+    run((args) => api.outreachQueue({ ...args, confirm: args.confirm === true }))
+  );
+
   server.tool(
     "list_jobs",
     "Recent agent runs (job status feed). Async actions like content planning show up here with their outputs.",
@@ -117,6 +262,404 @@ export async function startMcpServer() {
     run(({ contentId, confirm }) => api.publishContent(contentId, confirm === true))
   );
 
+  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.",
+    {
+      contentId: z.string().describe("The planned content page id"),
+      confirm: z.boolean().optional().describe("Set true to actually start generation (default: dry run)"),
+    },
+    run(({ contentId, confirm }) => api.generateContent(contentId, confirm === true))
+  );
+
+  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.",
+    {},
+    run(() => api.articleSettings())
+  );
+
+  const articleSettingsShape = {
+    autoPublish: z.boolean().optional(),
+    autoGenerate: z.boolean().optional().describe("Off = fully manual mode: articles are written only on demand (generate_article) and publish only from the editor"),
+    includeInfographics: z.boolean().optional().describe("AI hero + section images"),
+    titleInHeroImage: z.boolean().optional().describe("Write the post title into the hero image"),
+    includeSectionInfographics: z.boolean().optional().describe("Informational panels in 2,000+ word articles"),
+    includeRelatedReading: z.boolean().optional().describe("Related Reading link block at the end"),
+    includeYouTube: z.boolean().optional(),
+    useEmojis: z.boolean().optional(),
+    internalLinksPerArticle: z.number().min(1).max(20).optional(),
+    externalLinksPerArticle: z.number().min(0).max(15).optional(),
+    globalInstructions: z.string().optional(),
+  };
+
+  server.tool(
+    "update_article_settings",
+    "Merge-patch the article policy: only the fields you pass change. Set flexibleScheduling true to allow 1-5 articles/day and manual rescheduling. styleSet picks the image style set applied to all generated images (heroes, infographic panels, social cards).",
+    {
+      articleSettings: z.object(articleSettingsShape).optional(),
+      flexibleScheduling: z.boolean().optional(),
+      styleSet: z
+        .enum([
+          "classic-editorial",
+          "print-craft",
+          "storybook-painterly",
+          "modern-saas",
+          "dark-premium",
+          "bold-poster",
+        ])
+        .optional()
+        .describe("Image style set for all generated images"),
+    },
+    run((args) => api.updateArticleSettings(args))
+  );
+
+  server.tool(
+    "reschedule_article",
+    "Move a PLANNED article to another day (requires the flexible schedule; max 5/day; the exact hour is placed automatically). Pass the target day as epoch ms of local midnight.",
+    {
+      contentId: z.string(),
+      targetDayStartMs: z.number().describe("Epoch ms of the target day's local midnight"),
+    },
+    run(({ contentId, targetDayStartMs }) => api.reschedule(contentId, targetDayStartMs))
+  );
+
+  server.tool(
+    "get_internal_links",
+    "How the workspace's articles interlink: how many published articles link TO this page (with the source list) and how many internal links it sends out. Recorded from the real injected links at publish render time.",
+    { contentId: z.string().describe("The content page id") },
+    run(({ contentId }) => api.internalLinks(contentId))
+  );
+
+  server.tool(
+    "list_site_pages",
+    "Site pages RankControl links to from inside articles and the Related Reading block (with linkable/alive flags).",
+    {},
+    run(() => api.sitePages())
+  );
+
+  server.tool(
+    "detect_site_links",
+    "Scan the customer's sitemap (nested indexes handled) or crawl a blog root page and return same-site page URLs. Costly (3/min); review the URLs, then call add_site_pages with the keepers.",
+    {
+      source: z.enum(["sitemap", "blogroot"]),
+      url: z.string().describe("Sitemap XML URL or a page URL to crawl"),
+    },
+    run(({ source, url }) => api.detectSiteLinks(source, url))
+  );
+
+  server.tool(
+    "add_site_pages",
+    "Add site page URLs for internal linking. Duplicates are skipped; page titles fill in automatically in the background.",
+    { urls: z.array(z.string()) },
+    run(({ urls }) => api.addSitePages(urls))
+  );
+
+  server.tool(
+    "list_repurpose_queue",
+    "Published articles with their social repurpose drafts per platform (platform + status chips). Shows which articles still need drafts and whether Postiz is connected.",
+    {},
+    run(() => api.repurposeQueue())
+  );
+
+  server.tool(
+    "get_repurpose_drafts",
+    "Full social drafts (title, body, images, status) for one published article across the 8 platforms (LinkedIn, X/Twitter, Pinterest, Instagram, Facebook, Threads, YouTube, TikTok).",
+    { contentId: z.string().describe("The content page id") },
+    run(({ contentId }) => api.repurposeDrafts(contentId))
+  );
+
+  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).",
+    {
+      contentId: z.string(),
+      platforms: z
+        .array(
+          z.enum([
+            "linkedin",
+            "twitter",
+            "pinterest",
+            "instagram",
+            "facebook",
+            "threads",
+            "youtube",
+            "tiktok",
+          ])
+        )
+        .optional()
+        .describe("Subset of platforms; omit for the workspace default"),
+      confirm: z.boolean().optional(),
+    },
+    run((args) => api.repurposeGenerate(args))
+  );
+
+  server.tool(
+    "update_repurpose_draft",
+    "Edit a repurpose draft's body and/or title before pushing or posting.",
+    {
+      draftId: z.string(),
+      body: z.string().optional(),
+      title: z.string().optional(),
+    },
+    run((args) => api.repurposeEditDraft(args))
+  );
+
+  server.tool(
+    "mark_repurpose_posted",
+    "Mark a repurpose draft as posted — use after publishing its text manually (outside Postiz).",
+    { draftId: z.string() },
+    run(({ draftId }) => api.repurposeMarkPosted(draftId))
+  );
+
+  server.tool(
+    "list_postiz_channels",
+    "Connected Postiz social channels (id, name, platform). Channel ids are required by push_repurpose_draft.",
+    {},
+    run(() => api.repurposeChannels())
+  );
+
+  server.tool(
+    "push_repurpose_draft",
+    "Send a repurpose draft to connected Postiz channels (post now, schedule, or save as a Postiz draft). PUBLICLY VISIBLE side effect: defaults to a DRY RUN; a human should approve before calling again with confirm=true.",
+    {
+      draftId: z.string(),
+      integrationIds: z
+        .array(z.string())
+        .optional()
+        .describe(
+          "Postiz channel ids from list_postiz_channels (required with confirm)"
+        ),
+      scheduleType: z
+        .enum(["now", "schedule", "draft"])
+        .optional()
+        .describe("Default now"),
+      date: z.string().optional().describe("ISO time for scheduleType=schedule"),
+      confirm: z.boolean().optional(),
+    },
+    run((args) => api.repurposePush(args))
+  );
+
+  server.tool(
+    "get_content_ideas",
+    "Scored content-idea backlog: uncovered tracked queries ranked by citation gaps, competitor citations, trending topics, and quick-win rankings. Each idea carries a suggested title and winnability metrics.",
+    {},
+    run(() => api.contentIdeas())
+  );
+
+  server.tool(
+    "plan_content_idea",
+    "Put a content idea on the calendar as a planned article. Pass the idea's queryText (and its suggested title if you have it — otherwise a title is generated).",
+    {
+      queryText: z.string().describe("The idea's keyword/query text"),
+      title: z.string().optional().describe("Exact headline to plan"),
+    },
+    run((args) => api.planIdea(args))
+  );
+
+  server.tool(
+    "archive_content",
+    "Archive an article, removing it from the working set. Reversible in the dashboard.",
+    { contentId: z.string() },
+    run(({ contentId }) => api.archiveContent(contentId))
+  );
+
+  server.tool(
+    "get_page_engagement",
+    "Per-page engagement for the last 30 days: views, AI citations, and a view sparkline per published page.",
+    {},
+    run(() => api.pageEngagement())
+  );
+
+  server.tool(
+    "get_exec_summary",
+    "Executive report: last 30 days vs the 30 before — cite rate, citations, page views, AI-referred views, crawler hits, and articles published.",
+    {},
+    run(() => api.reportSummary())
+  );
+
+  server.tool(
+    "get_top_wins",
+    "Biggest wins of the last 30 days: most-cited page, best query cite-rate jump, biggest Google ranking climb, best new backlink.",
+    {},
+    run(() => api.reportWins())
+  );
+
+  server.tool(
+    "get_agent_activity",
+    "Recent pipeline runs per agent lane (brand control, radar, forge, recon, deploy, outreach, sentinel, social).",
+    {
+      perAgent: z.number().max(50).optional().describe("Runs per lane, default 15"),
+      sinceDays: z.number().optional().describe("Window in days, default 30"),
+    },
+    run((args) => api.agentActivity(args))
+  );
+
+  server.tool(
+    "list_backlinks",
+    "The workspace's backlink table, newest first.",
+    {
+      status: z
+        .string()
+        .optional()
+        .describe(
+          "Filter: discovered, verified, lost, identified, contacted, replied, link_placed, rejected"
+        ),
+    },
+    run(({ status }) => api.backlinks(status))
+  );
+
+  server.tool(
+    "get_backlink_stats",
+    "Backlink totals (live, lost, avg DA, unique domains) plus outreach pipeline counts.",
+    {},
+    run(() => api.backlinkStats())
+  );
+
+  server.tool(
+    "update_outreach_status",
+    "Move an outreach prospect through the pipeline.",
+    {
+      backlinkId: z.string(),
+      status: z.enum(["identified", "contacted", "replied", "link_placed", "rejected"]),
+    },
+    run(({ backlinkId, status }) => api.outreachStatus(backlinkId, status))
+  );
+
+  server.tool(
+    "get_link_network",
+    "Link Network state: credit balance/earn/spend, membership (optedIn), and hosted/received placements with partners and anchors.",
+    {},
+    run(() => api.linkNetwork())
+  );
+
+  server.tool(
+    "set_link_network_opt_in",
+    "Join or leave the Link Network. SIDE EFFECT on partner sites (leaving retires live links): defaults to a DRY RUN; a human should approve before calling again with confirm=true.",
+    { optIn: z.boolean(), confirm: z.boolean().optional() },
+    run(({ optIn, confirm }) => api.linkNetworkOptIn(optIn, confirm))
+  );
+
+  server.tool(
+    "remove_network_placement",
+    "Retire one Link Network placement. VISIBLE on the partner site: defaults to a DRY RUN; call again with confirm=true after human approval.",
+    { placementId: z.string(), confirm: z.boolean().optional() },
+    run(({ placementId, confirm }) => api.linkNetworkRemovePlacement(placementId, confirm))
+  );
+
+  server.tool(
+    "list_social_threads",
+    "Social thread prospects (Reddit/X) where the brand's articles could earn a mention, with subreddit rules context, sorted by intent.",
+    {
+      platform: z.enum(["reddit", "twitter"]).optional(),
+      status: z.string().optional(),
+      age: z.enum(["ranked", "new"]).optional(),
+    },
+    run((args) => api.socialThreads(args))
+  );
+
+  server.tool(
+    "get_social_stats",
+    "Social thread pipeline counts.",
+    {},
+    run(() => api.socialStats())
+  );
+
+  server.tool(
+    "update_social_thread_status",
+    "Move a social thread through the pipeline (e.g. dismissed, replied).",
+    { threadId: z.string(), status: z.string() },
+    run(({ threadId, status }) => api.socialStatus(threadId, status))
+  );
+
+  server.tool(
+    "draft_social_reply",
+    "AI-draft a reply for a social thread. Nothing posts — the draft lands on the thread for human review. Subject to the same warm-up/pacing guards as the dashboard.",
+    {
+      threadId: z.string(),
+      mentionMode: z
+        .enum(["none", "natural", "founderOpen"])
+        .optional()
+        .describe("Brand-mention mode; warm-up accounts are clamped to none"),
+    },
+    run(({ threadId, mentionMode }) => api.socialDraftReply(threadId, mentionMode))
+  );
+
+  server.tool(
+    "contact_support",
+    "Send a message or bug report to the RankControl team (emails support with the workspace identified; the org owner is set as reply-to). Use when an API call errors unexpectedly or data looks wrong — include the failing request, ids, and what you expected. Capped at 3/min.",
+    {
+      subject: z.string(),
+      message: z.string().describe("Details: what happened, errors, ids, steps to reproduce"),
+      pageUrl: z.string().optional().describe("Related dashboard or API URL"),
+    },
+    run((args) => api.support(args))
+  );
+
+  server.tool(
+    "get_brand",
+    "The workspace's brand data in one read: brand profile (voice, colors, meta), links/CTAs, products, and buyer profiles (ICPs). This is the context RankControl's writers use.",
+    {},
+    run(() => api.brand())
+  );
+
+  server.tool(
+    "update_brand_profile",
+    "Patch brand voice/style fields: tone, colors, fontFamily, metaTitle/Description/Keywords, defaultLocale, flexibleScheduling. Only provided fields change; they steer all future article generation.",
+    {
+      tone: z.string().optional(),
+      primaryColor: z.string().optional(),
+      secondaryColor: z.string().optional(),
+      fontFamily: z.string().optional(),
+      metaTitle: z.string().optional(),
+      metaDescription: z.string().optional(),
+      metaKeywords: z.string().optional(),
+      defaultLocale: z.string().optional().describe("BCP-47 tag from the supported registry"),
+      flexibleScheduling: z.boolean().optional(),
+    },
+    run((args) => api.brandProfileSet(args))
+  );
+
+  server.tool(
+    "write_brand_product",
+    "Create, update, or delete a product in brand memory (feeds article context + entity triples). Create: name+description+category. Update: productId + changed fields. Delete: productId + del=true.",
+    {
+      productId: z.string().optional(),
+      del: z.boolean().optional(),
+      name: z.string().optional(),
+      description: z.string().optional(),
+      url: z.string().optional(),
+      features: z.array(z.string()).optional(),
+      pricing: z.string().optional(),
+      category: z.string().optional(),
+      usps: z.array(z.string()).optional(),
+      isActive: z.boolean().optional(),
+    },
+    run((args) => api.brandProductWrite(args))
+  );
+
+  server.tool(
+    "write_brand_icp",
+    "Create, update, or delete a buyer profile / ICP (feeds article targeting + entity triples). Create: title+industry+demographics. Update: profileId + changed fields. Delete: profileId + del=true.",
+    {
+      profileId: z.string().optional(),
+      del: z.boolean().optional(),
+      title: z.string().optional(),
+      industry: z.string().optional(),
+      companySize: z.string().optional(),
+      painPoints: z.array(z.string()).optional(),
+      buyingTriggers: z.array(z.string()).optional(),
+      objections: z.array(z.string()).optional(),
+      preferredChannels: z.array(z.string()).optional(),
+      demographics: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Demographics object; required on create (same shape the dashboard saves)"),
+      isActive: z.boolean().optional(),
+    },
+    run((args) => api.brandIcpWrite(args))
+  );
+
   await server.connect(new StdioServerTransport());
   // Keep the process alive; the transport owns stdin/stdout from here
   console.error("rankcontrol MCP server running on stdio");