@nooticr/mcp 1.26.80 → 1.26.81

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-119 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+123 tools, grouped by what you are trying to do. Prices are in nooticr credits and
 match what the server actually charges.
 
 The job tools under **Answer a question you actually have** are not
@@ -204,6 +204,10 @@ a `scanId` for the rest.
 | `list_employees` | free | Your AI employees with status, schedule, next run and budget left; `includeFired: true` adds the ones let go. |
 | `pause_employee` | free | Pause an AI employee (it keeps its memory and thread) or resume it with `resume: true`. Only the person who hired it or a workspace admin can. |
 | `fire_employee` | free | Let an AI employee go for good: runs stop and actions awaiting approval are discarded. The first call only describes what will happen; confirm with `confirm: true`. |
+| `crm_upsert_creator` | free | Add a creator to your creator pipeline, or update the one already there (matched by `platform` + `handle`). Only the fields you pass change; new creators start as `prospect`. Every number cited goes in `evidence`. |
+| `crm_list_creators` | free | Your creator pipeline, most recently updated first, each with its last interaction. Filter by `status`, `appId`, `query` or `dueBefore`. |
+| `crm_update_status` | free | Move a creator to a new pipeline status and record why. `do_not_contact` stays unless a person changes it; AI employees may only use `prospect`, `shortlisted` or `paused`. |
+| `crm_log_interaction` | free | Record a note, vetting result, outreach draft, reply or deliverable against a creator. AI employees cannot log `outreach_sent`. |
 | `list_pending_actions` | free | What your AI employees are waiting to do until you approve, each with a preview of what will be published, sent or changed. Optionally one `employeeId`. |
 | `get_employee_audit` | free | One AI employee's audit trail, newest first: runs, model calls and their cost, tool calls (arguments redacted), sources read, approvals with the approver's edits, executed actions and their external ids, config changes, pauses and errors. Filter by `from`/`to`, `types`, `runId` or `actionId`; `verify: true` re-checks the tamper-evident hash chain. Workspace owners and admins only. |
 | `approve_action` | free | Approve one pending action by `actionId`. The first call returns the preview and a `confirmationToken` and runs nothing; after you confirm, the stored action runs exactly once. |

package/dist/shared/crm.js

@@ -0,0 +1,125 @@
+/**
+ * Creator CRM (nooticr-server E1): the workspace's creator pipeline. Every tool
+ * here is a passthrough to the server's `POST /mcp` dispatch; the server owns
+ * the tenancy check, the status rules (an AI employee may only use prospect,
+ * shortlisted or paused, cannot log outreach_sent, and cannot leave
+ * do_not_contact) and the history. `status_change` is not a loggable kind: only
+ * crm_update_status writes it.
+ *
+ * None of these has a view: the pipeline would be a table the design system has
+ * no card for, and the other three are pure state mutations.
+ */
+import { z } from "zod";
+import { OUTPUT_SCHEMAS } from "./output-schemas.js";
+function toResult(proxy) {
+    const textBlock = proxy.contentBlocks.find((c) => c.type === "text");
+    const structured = proxy.structured;
+    // No view here, so the model reads the payload from the text: carry it in both.
+    const text = structured ? JSON.stringify(structured) : String(textBlock?.text ?? "");
+    return { content: [{ type: "text", text }], structuredContent: structured };
+}
+function failed(prefix, err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: "text", text: `${prefix}: ${msg}` }],
+        isError: true,
+    };
+}
+/** Pipeline statuses, as the server's CRM_STATUSES. */
+export const CRM_STATUSES = ["prospect", "shortlisted", "contacted", "replied", "negotiating", "active", "paused", "declined", "do_not_contact"];
+/** Kinds crm_log_interaction accepts, as the server's CRM_INTERACTION_KINDS (no status_change). */
+export const CRM_INTERACTION_KINDS = ["note", "vetting", "outreach_draft", "outreach_sent", "reply", "deliverable"];
+export function registerCrmTools(server, makeClient) {
+    const passthrough = (name) => async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        try {
+            return toResult(await client.callTool(name, args));
+        }
+        catch (err) {
+            return failed(`${name} failed`, err);
+        }
+    };
+    server.registerTool("crm_upsert_creator", {
+        title: "Upsert Creator",
+        description: "Use when you want to track a creator or record new numbers for one already tracked. " +
+            "Add a creator to this workspace's creator pipeline, or update the one already there " +
+            "(matched by platform + handle, case-insensitive). Only the fields you pass change. New " +
+            "creators start as 'prospect'; use crm_update_status to change that. Put every number you " +
+            "cite in `evidence` as [{tool, url, metric, value, at}]. engagementRate is a fraction " +
+            "(0.052 = 5.2%). No cost to call.",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+        inputSchema: z
+            .object({
+            platform: z.string().describe("tiktok, instagram, youtube, ..."),
+            handle: z.string(),
+            displayName: z.string().optional(),
+            profileUrl: z.string().optional(),
+            followers: z.number().int().min(0).optional(),
+            avgViews: z.number().int().min(0).optional(),
+            engagementRate: z.number().min(0).max(1).optional(),
+            niche: z.string().optional(),
+            country: z.string().optional(),
+            contactEmail: z.string().optional().describe("Only an address the creator published."),
+            fitScore: z.number().int().min(0).max(100).optional(),
+            fitReasons: z.array(z.string()).optional(),
+            risks: z.array(z.string()).optional(),
+            evidence: z.array(z.object({}).passthrough()).optional(),
+            nextStep: z.string().optional(),
+            nextStepDue: z.string().optional().describe("YYYY-MM-DD"),
+            appId: z.number().int().optional().describe("Product this creator is for."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.crm_upsert_creator,
+    }, passthrough("crm_upsert_creator"));
+    server.registerTool("crm_list_creators", {
+        title: "List Creators",
+        description: "Use when someone asks who is in their creator pipeline or which next steps are due. " +
+            "List the workspace's creator pipeline, most recently updated first, each with its last " +
+            "interaction. Filter by status, appId, query (handle or name) or dueBefore (next step due " +
+            "on or before YYYY-MM-DD). limit is at most 100. No cost to call.",
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: z
+            .object({
+            status: z.enum(CRM_STATUSES).optional(),
+            appId: z.number().int().optional(),
+            query: z.string().optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+            dueBefore: z.string().optional().describe("YYYY-MM-DD"),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.crm_list_creators,
+    }, passthrough("crm_list_creators"));
+    server.registerTool("crm_update_status", {
+        title: "Update Creator Status",
+        description: "Use when a creator moves forward or back in the pipeline, for example after a reply or a decision. " +
+            "Move a creator to a new pipeline status and record why (writes a status_change entry). " +
+            "A creator marked do_not_contact stays that way unless a person changes it. AI employees " +
+            "may only use prospect, shortlisted or paused. No cost to call.",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        inputSchema: z
+            .object({
+            creatorId: z.string().describe("Id from crm_list_creators."),
+            status: z.enum(CRM_STATUSES),
+            note: z.string().describe("Why."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.crm_update_status,
+    }, passthrough("crm_update_status"));
+    server.registerTool("crm_log_interaction", {
+        title: "Log Creator Interaction",
+        description: "Use when something happens with a creator that the pipeline should remember. " +
+            "Record something that happened with a creator: a note, vetting result, outreach draft " +
+            "(put the message in body), reply or deliverable. AI employees cannot log outreach_sent: a " +
+            "person sends outreach and logs it. No cost to call.",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        inputSchema: z
+            .object({
+            creatorId: z.string(),
+            kind: z.enum(CRM_INTERACTION_KINDS),
+            summary: z.string().describe("At most 4000 characters."),
+            body: z.string().optional().describe("At most 8000 characters, e.g. the drafted message."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.crm_log_interaction,
+    }, passthrough("crm_log_interaction"));
+}

package/dist/shared/loading-plans.js

@@ -503,6 +503,11 @@ export const LOADING_PLANS = {
     list_employees: { label: "Reading your employees", kind: "list", n: 3, steps: [], free: true },
     pause_employee: { label: "Updating the employee", kind: "text", n: 1, steps: [], free: true },
     fire_employee: { label: "Letting the employee go", kind: "text", n: 1, steps: [], free: true },
+    // Creator CRM (crm.ts): free, and none of it fetches.
+    crm_upsert_creator: { label: "Saving the creator", kind: "text", n: 1, steps: [], free: true },
+    crm_list_creators: { label: "Reading your creator pipeline", kind: "list", n: 3, steps: [], free: true },
+    crm_update_status: { label: "Updating the creator's status", kind: "text", n: 1, steps: [], free: true },
+    crm_log_interaction: { label: "Logging the interaction", kind: "text", n: 1, steps: [], free: true },
     list_pending_actions: { label: "Reading what awaits approval", kind: "list", n: 3, steps: [], free: true },
     get_employee_audit: { label: "Reading the audit trail", kind: "list", n: 3, steps: [], free: true },
     approve_action: { label: "Approving the action", kind: "text", n: 1, steps: [], free: true },

package/dist/shared/output-schemas.js

@@ -1785,6 +1785,11 @@ export const OUTPUT_SCHEMAS = {
         action: anyObject().nullish(),
     }),
     reject_action: open({ rejected: scalar(), action: anyObject().nullish() }),
+    // Creator CRM (nooticr-server E1): the creator/interaction views are the server's own shapes.
+    crm_upsert_creator: open({ creator: anyObject().nullish() }),
+    crm_list_creators: open({ creators: listOf(open({ id: scalar(), platform: scalar(), handle: scalar(), status: scalar() })) }),
+    crm_update_status: open({ creator: anyObject().nullish() }),
+    crm_log_interaction: open({ interaction: anyObject().nullish() }),
     list_employees: open({ employees: listOf(open({ id: scalar(), name: scalar(), status: scalar() })) }),
     list_pending_actions: open({ actions: listOf(open({ id: scalar(), employeeId: scalar() })) }),
     // AU1 (nooticr-server employees/mcp.rs get_employee_audit; event shape from employee_audit_view::event_view).

package/dist/shared/tools-def.js

@@ -672,6 +672,30 @@ export const TOOL_DEFINITIONS = [
         description: "Reject one pending AI-employee action by actionId, with an optional note the employee can learn from. Only the hiring user or a workspace admin can. No cost to call.",
         inputSchema: z.object({ actionId: z.string().describe("Action id from list_pending_actions."), note: z.string().optional().describe("Why, so the employee can learn.") }).strict(),
     },
+    {
+        name: "crm_upsert_creator",
+        title: "Upsert Creator",
+        description: "Use when you want to track a creator or record new numbers for one already tracked. Add a creator to this workspace's creator pipeline, or update the one already there (matched by platform + handle, case-insensitive). Only the fields you pass change. New creators start as 'prospect'; use crm_update_status to change that. Put every number you cite in `evidence` as [{tool, url, metric, value, at}]. engagementRate is a fraction (0.052 = 5.2%). No cost to call.",
+        inputSchema: z.object({ platform: z.string().describe("tiktok, instagram, youtube, ..."), handle: z.string(), displayName: z.string().optional(), profileUrl: z.string().optional(), followers: z.number().int().min(0).optional(), avgViews: z.number().int().min(0).optional(), engagementRate: z.number().min(0).max(1).optional(), niche: z.string().optional(), country: z.string().optional(), contactEmail: z.string().optional().describe("Only an address the creator published."), fitScore: z.number().int().min(0).max(100).optional(), fitReasons: z.array(z.string()).optional(), risks: z.array(z.string()).optional(), evidence: z.array(z.object({}).passthrough()).optional(), nextStep: z.string().optional(), nextStepDue: z.string().optional().describe("YYYY-MM-DD"), appId: z.number().int().optional().describe("Product this creator is for.") }).strict(),
+    },
+    {
+        name: "crm_list_creators",
+        title: "List Creators",
+        description: "Use when someone asks who is in their creator pipeline or which next steps are due. List the workspace's creator pipeline, most recently updated first, each with its last interaction. Filter by status, appId, query (handle or name) or dueBefore (next step due on or before YYYY-MM-DD). limit is at most 100. No cost to call.",
+        inputSchema: z.object({ status: z.enum(["prospect", "shortlisted", "contacted", "replied", "negotiating", "active", "paused", "declined", "do_not_contact"]).optional(), appId: z.number().int().optional(), query: z.string().optional(), limit: z.number().int().min(1).max(100).optional(), dueBefore: z.string().optional().describe("YYYY-MM-DD") }).strict(),
+    },
+    {
+        name: "crm_update_status",
+        title: "Update Creator Status",
+        description: "Use when a creator moves forward or back in the pipeline, for example after a reply or a decision. Move a creator to a new pipeline status and record why (writes a status_change entry). A creator marked do_not_contact stays that way unless a person changes it. AI employees may only use prospect, shortlisted or paused. No cost to call.",
+        inputSchema: z.object({ creatorId: z.string().describe("Id from crm_list_creators."), status: z.enum(["prospect", "shortlisted", "contacted", "replied", "negotiating", "active", "paused", "declined", "do_not_contact"]), note: z.string().describe("Why.") }).strict(),
+    },
+    {
+        name: "crm_log_interaction",
+        title: "Log Creator Interaction",
+        description: "Use when something happens with a creator that the pipeline should remember. Record something that happened with a creator: a note, vetting result, outreach draft (put the message in body), reply or deliverable. AI employees cannot log outreach_sent: a person sends outreach and logs it. No cost to call.",
+        inputSchema: z.object({ creatorId: z.string(), kind: z.enum(["note", "vetting", "outreach_draft", "outreach_sent", "reply", "deliverable"]), summary: z.string().describe("At most 4000 characters."), body: z.string().optional().describe("At most 8000 characters, e.g. the drafted message.") }).strict(),
+    },
     {
         name: "marketplace_changes",
         title: "Marketplace Changes",

package/dist/shared/tools.js

@@ -27,6 +27,7 @@ import { registerOwnAccountTools } from "./own-account.js";
 import { registerConnectionTools } from "./connections.js";
 import { registerReplyTools } from "./replies.js";
 import { registerEmployeeTools } from "./employees.js";
+import { registerCrmTools } from "./crm.js";
 import { registerStoreReadTools } from "./store-read.js";
 import { registerGettingStarted, SERVER_INSTRUCTIONS } from "./getting-started.js";
 import { loadingPlansJson } from "./loading-plans.js";
@@ -36,7 +37,7 @@ import { registerAmazonTools } from "./amazon.js";
 import { registerMarketplaceTools } from "./marketplace.js";
 import { DEFAULT_NOOTICR_SETTINGS, DEFAULT_SOCIAL_PLATFORMS, MemorySettingsStore, SETTINGS_READ_TOOL, SETTINGS_UPDATE_TOOL, settingsOwnerFromAuth, } from "./settings.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.80";
+export const MCP_SERVER_VERSION = "1.26.81";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -2820,6 +2821,8 @@ export function createMcpServer(rawMakeClient, opts) {
     registerReplyTools(server, makeClient);
     // AI employees (employees.ts): hire, list, pause, fire, and approve or reject what they queue.
     registerEmployeeTools(server, makeClient);
+    // Creator CRM (crm.ts): the workspace's creator pipeline.
+    registerCrmTools(server, makeClient);
     // Store connections (store-read.ts): the connect link and the catalogue read.
     registerStoreReadTools(server, makeClient);
     registerGettingStarted(server, makeClient, watchStore);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nooticr/mcp",
   "mcpName": "com.nooticr/mcp",
-  "version": "1.26.80",
+  "version": "1.26.81",
   "description": "MCP server for nooticr - fetch, discover and understand TikTok/Instagram/YouTube/X/Reddit/LinkedIn/Weibo posts with AI (media metadata, niche discovery, brand monitoring, hook & viral analysis)",
   "homepage": "https://mcp.nooticr.com",
   "repository": {