mcp-server-andru-intelligence 1.0.0 → 1.1.0

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "mcp-server-andru-intelligence",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "mcpName": "io.github.geter-andru/andru-intelligence",
-  "description": "Buyer intelligence for technical founders who sell to enterprises — know who to target, what to say, and when to walk away. 15 MCP tools: ICP scoring, persona lookup, battlecards, deal classification, prospect discovery.",
+  "description": "Buyer intelligence for technical founders who sell to enterprises — know who to target, what to say, and when to walk away. 19 MCP tools + CLI: ICP scoring, persona simulation, battlecards, deal classification, prospect discovery, sales hiring, investor matching, founder wellness.",
   "type": "module",
   "bin": {
-    "andru-mcp": "./src/index.js"
+    "andru-mcp": "./src/index.js",
+    "andru-intel": "./src/cli.js"
   },
   "main": "./src/index.js",
   "keywords": [

package/src/catalog.js

@@ -30,7 +30,7 @@ const COLD_START_PARAMS = {
   },
 };
 
-// ── 15 Tools ────────────────────────────────────────────────────────────────
+// ── 19 Tools ────────────────────────────────────────────────────────────────
 
 export const tools = [
   {
@@ -372,6 +372,119 @@ export const tools = [
       required: ['companies'],
     },
   },
+
+  {
+    name: 'get_sales_blueprint',
+    description: 'Builds everything you need to make your first sales hire — job description, comp structure, interview questions that actually reveal sales ability, 90-day ramp plan, and weekly activity targets tied to your ARR goal.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        companyStage: {
+          type: 'string',
+          enum: ['Pre-Seed', 'Seed', 'Series A', 'Series B'],
+          description: 'Current funding stage. Infer from conversation context if the user has mentioned it.',
+        },
+        arrTarget: {
+          type: 'string',
+          description: 'Annual recurring revenue target (e.g., "$2M", "$5M", "$10M"). Ask the user if not mentioned.',
+        },
+        dealSize: {
+          type: 'string',
+          description: 'Average deal size (e.g., "$15K ACV", "$50K ACV"). Infer from context or ask.',
+        },
+        avgCycleLength: {
+          type: 'string',
+          description: 'Average sales cycle length (e.g., "30 days", "60 days", "90+ days"). Infer or ask.',
+        },
+        teamSize: {
+          type: 'number',
+          description: 'Current team size. Infer from context if mentioned.',
+        },
+      },
+      required: ['companyStage', 'arrTarget'],
+    },
+  },
+
+  {
+    name: 'get_thesis_match',
+    description: 'Finds the 5 VCs whose investment thesis best matches your company — scores each on fit, explains why they\'d be interested, and tells you how to approach them. Saves weeks of investor research.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        productDescription: {
+          type: 'string',
+          description: 'What the company does and who it serves. Infer from conversation context if the user has already described their product.',
+        },
+        stage: {
+          type: 'string',
+          enum: ['Pre-Seed', 'Seed', 'Series A', 'Series B', 'Series C+'],
+          description: 'Current funding stage. Infer from context if mentioned.',
+        },
+        arrRange: {
+          type: 'string',
+          description: 'Current ARR range (e.g., "$0-$500K", "$500K-$2M", "$2M-$10M"). Infer or ask.',
+        },
+        vertical: {
+          type: 'string',
+          description: 'Industry vertical (e.g., "AI/ML", "FinTech", "HealthTech", "SaaS"). Infer from product description.',
+        },
+      },
+      required: ['productDescription', 'stage'],
+    },
+  },
+
+  {
+    name: 'get_founder_wellness',
+    description: 'Checks if you\'re burning out before you notice — tracks consecutive work days, late nights, and meeting density, then gives you a risk score and specific recovery actions. Because the founder who crashes can\'t close deals.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        userId: {
+          type: 'string',
+          description: 'The user\'s Andru account ID. Required for personalized wellness tracking.',
+        },
+        mode: {
+          type: 'string',
+          enum: ['assessment', 'dashboard'],
+          description: 'assessment = burnout risk score + recommendations. dashboard = full wellness data. Default: assessment.',
+        },
+      },
+    },
+  },
+
+  {
+    name: 'simulate_buyer_persona',
+    description: 'Practice your pitch against a realistic buyer — pick a CFO, CTO, COO, VP Sales, or VP Engineering and get their opening challenge. They\'ll push back the way real buyers do, so you can sharpen your story before the actual meeting.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        persona: {
+          type: 'string',
+          enum: ['CFO', 'CTO', 'COO', 'VP Sales', 'VP Engineering'],
+          description: 'Which buyer to simulate. Pick based on who the user is preparing to meet.',
+        },
+        stageId: {
+          type: 'number',
+          enum: [0, 1, 2, 3, 4, 5, 6, 7],
+          description: 'Buyer journey stage (0=Unaware through 7=Advocating). Default: 3.',
+        },
+        productDescription: {
+          type: 'string',
+          description: 'What the user\'s product does. Infer from conversation context.',
+        },
+        productName: {
+          type: 'string',
+          description: 'Product name. Infer from context.',
+        },
+        mode: {
+          type: 'string',
+          enum: ['opening', 'list'],
+          description: 'opening = buyer\'s opening message. list = available personas. Default: opening.',
+        },
+      },
+      required: ['persona'],
+    },
+  },
 ];
 
 // ── 3 Resources ─────────────────────────────────────────────────────────────

package/src/cli.js

@@ -0,0 +1,202 @@
+#!/usr/bin/env node
+
+/**
+ * Andru Intelligence CLI
+ *
+ * Direct command-line access to all 19 Andru intelligence tools.
+ * Works from any terminal — Claude Code, Cursor, Codex, plain shell.
+ *
+ * Usage:
+ *   npx andru-intel <tool-name> [--param value ...]
+ *   npx andru-intel list
+ *   npx andru-intel help <tool-name>
+ *
+ * Examples:
+ *   npx andru-intel get_thesis_match --productDescription "AI sales platform" --stage "Series A"
+ *   npx andru-intel simulate_buyer_persona --persona CFO --productDescription "DevOps automation"
+ *   npx andru-intel get_sales_blueprint --companyStage "Series A" --arrTarget "$5M"
+ *   npx andru-intel get_icp_fit_score --companyName "Acme Corp" --industry "SaaS"
+ *
+ * Environment:
+ *   ANDRU_API_KEY  (required) — Your Andru Platform API key
+ *   ANDRU_API_URL  (optional) — API base URL (default: https://api.andru.ai)
+ */
+
+import { tools } from './catalog.js';
+import { AndruClient } from './client.js';
+
+function printUsage() {
+  console.log(`
+andru-intel — Buyer intelligence from your terminal
+
+Usage:
+  andru-intel <tool-name> [--param value ...]
+  andru-intel list                  Show all available tools
+  andru-intel help <tool-name>      Show tool parameters
+
+Examples:
+  andru-intel get_thesis_match --productDescription "AI sales platform" --stage "Series A"
+  andru-intel simulate_buyer_persona --persona CFO
+  andru-intel get_sales_blueprint --companyStage "Series A" --arrTarget "$5M"
+
+Environment:
+  ANDRU_API_KEY   Your API key (get one at https://app.andru.ai/settings/api-keys)
+  ANDRU_API_URL   API endpoint (default: https://api.andru.ai)
+
+${tools.length} tools available. Run 'andru-intel list' to see them all.
+`);
+}
+
+function printToolList() {
+  console.log(`\n${tools.length} Andru Intelligence Tools:\n`);
+  const maxName = Math.max(...tools.map(t => t.name.length));
+  for (const tool of tools) {
+    const name = tool.name.padEnd(maxName + 2);
+    // Truncate description to fit terminal
+    const desc = tool.description.length > 80
+      ? tool.description.slice(0, 77) + '...'
+      : tool.description;
+    console.log(`  ${name}${desc}`);
+  }
+  console.log(`\nRun 'andru-intel help <tool-name>' for parameters.\n`);
+}
+
+function printToolHelp(toolName) {
+  const tool = tools.find(t => t.name === toolName);
+  if (!tool) {
+    console.error(`Unknown tool: ${toolName}`);
+    console.error(`Run 'andru-intel list' to see available tools.`);
+    process.exit(1);
+  }
+
+  console.log(`\n${tool.name}`);
+  console.log(`${'─'.repeat(tool.name.length)}`);
+  console.log(tool.description);
+
+  const props = tool.inputSchema?.properties || {};
+  const required = new Set(tool.inputSchema?.required || []);
+
+  if (Object.keys(props).length > 0) {
+    console.log(`\nParameters:`);
+    for (const [name, schema] of Object.entries(props)) {
+      const req = required.has(name) ? ' (required)' : '';
+      const type = schema.enum ? schema.enum.join(' | ') : schema.type;
+      console.log(`  --${name}  [${type}]${req}`);
+      if (schema.description) {
+        // Indent description, truncate long ones
+        const desc = schema.description.length > 100
+          ? schema.description.slice(0, 97) + '...'
+          : schema.description;
+        console.log(`      ${desc}`);
+      }
+    }
+  }
+
+  console.log(`\nExample:`);
+  const exampleArgs = [];
+  for (const [name, schema] of Object.entries(props)) {
+    if (required.has(name)) {
+      const val = schema.enum ? schema.enum[0] : `"..."`;
+      exampleArgs.push(`--${name} ${val}`);
+    }
+  }
+  console.log(`  andru-intel ${tool.name} ${exampleArgs.join(' ')}\n`);
+}
+
+function parseArgs(argv) {
+  const args = {};
+  let i = 0;
+  while (i < argv.length) {
+    const arg = argv[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith('--')) {
+        // Try to parse as JSON for arrays/objects/numbers
+        try {
+          args[key] = JSON.parse(next);
+        } catch {
+          args[key] = next;
+        }
+        i += 2;
+      } else {
+        args[key] = true;
+        i += 1;
+      }
+    } else {
+      i += 1;
+    }
+  }
+  return args;
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+
+  if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+    printUsage();
+    process.exit(0);
+  }
+
+  const command = argv[0];
+
+  if (command === 'list') {
+    printToolList();
+    process.exit(0);
+  }
+
+  if (command === 'help') {
+    if (!argv[1]) {
+      printUsage();
+    } else {
+      printToolHelp(argv[1]);
+    }
+    process.exit(0);
+  }
+
+  // Tool execution
+  const toolName = command;
+  const tool = tools.find(t => t.name === toolName);
+  if (!tool) {
+    console.error(`Unknown tool: ${toolName}`);
+    console.error(`Run 'andru-intel list' to see available tools.`);
+    process.exit(1);
+  }
+
+  const apiKey = process.env.ANDRU_API_KEY;
+  if (!apiKey) {
+    console.error('ANDRU_API_KEY not set.');
+    console.error('Get your API key at https://app.andru.ai/settings/api-keys');
+    console.error('');
+    console.error('Usage: ANDRU_API_KEY=sk_live_... andru-intel ' + toolName + ' [args]');
+    process.exit(1);
+  }
+
+  const apiUrl = process.env.ANDRU_API_URL || 'https://api.andru.ai';
+  const client = new AndruClient(apiKey, apiUrl);
+  const toolArgs = parseArgs(argv.slice(1));
+
+  try {
+    const result = await client.callTool(toolName, toolArgs);
+
+    if (result.isError) {
+      const text = result.content?.[0]?.text || 'Unknown error';
+      console.error(text);
+      process.exit(1);
+    }
+
+    // Print result — if it's JSON, pretty-print it
+    const text = result.content?.[0]?.text || '{}';
+    try {
+      const parsed = JSON.parse(text);
+      console.log(JSON.stringify(parsed, null, 2));
+    } catch {
+      console.log(text);
+    }
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();