@tacitai/mcp-server 0.6.2 → 0.6.4

package/dist/index.js

@@ -59,6 +59,7 @@ import { registerGmTools } from './tools/gm.js';
 import { registerSkillTools } from './tools/skills.js';
 import { registerWikiTools } from './tools/wiki.js';
 import { registerVoiceTools } from './tools/voice.js';
+import { registerOnboardingTools } from './tools/onboarding.js';
 import { registerPrompts } from './prompts.js';
 import { getRequestPrincipal } from './client.js';
 // Setup wizard (MV-1057h / W5)
@@ -183,6 +184,7 @@ async function run() {
     registerSkillTools(server, getClient);
     registerWikiTools(server, getClient);
     registerVoiceTools(server, getClient);
+    registerOnboardingTools(server, getClient);
     registerPrompts(server, getClient);
     if (process.env['MCP_TRANSPORT'] === 'http') {
         await startHttpTransport(server);

package/dist/prompts.d.ts

@@ -1,3 +1,90 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { TacitClient } from './client.js';
+export interface WorkspaceState {
+    name: string;
+    collectionNames: string[];
+    collectionCount: number;
+    portfolioNames: string[];
+    portfolioCount: number;
+    sourceCount: number;
+}
+export declare function fetchWorkspaceState(client: TacitClient): Promise<WorkspaceState>;
+export declare const CAPABILITY_DOMAINS: Array<{
+    domain: string;
+    triggers: string[];
+    description: string;
+}>;
+export declare const EXPERIENCES: readonly [{
+    readonly id: "first_light";
+    readonly num: 1;
+    readonly name: "First Light";
+    readonly tier: 1;
+    readonly tierName: "Orient & Equip";
+    readonly action: "Ask a question about your business — try \"What do we know about [topic]?\"";
+    readonly signal: "First grounded, cited answer about your company";
+}, {
+    readonly id: "feed_it";
+    readonly num: 2;
+    readonly name: "Feed It";
+    readonly tier: 1;
+    readonly tierName: "Orient & Equip";
+    readonly action: "Add something to your workspace — share a URL, document, or file.";
+    readonly signal: "First successful content ingestion";
+}, {
+    readonly id: "build_your_map";
+    readonly num: 3;
+    readonly name: "Build Your Map";
+    readonly tier: 1;
+    readonly tierName: "Orient & Equip";
+    readonly action: "Organize your work — ask to create a collection, build a portfolio, or structure your business.";
+    readonly signal: "First organizational write operation";
+}, {
+    readonly id: "connect_your_tools";
+    readonly num: 4;
+    readonly name: "Connect Your Tools";
+    readonly tier: 1;
+    readonly tierName: "Orient & Equip";
+    readonly action: "Connect Slack and Gmail through claude.ai Integrations — type \"How do I connect my tools?\" for a walkthrough.";
+    readonly signal: "Connectors active — email and Slack flowing into your workspace";
+}, {
+    readonly id: "morning_brief";
+    readonly num: 5;
+    readonly name: "Morning Brief";
+    readonly tier: 2;
+    readonly tierName: "The Operating System";
+    readonly action: "Start a session with \"What happened while I was away?\" or \"Morning brief\" — includes email triage, Slack synthesis, and calendar prep.";
+    readonly signal: "First daily operating picture with email triage, Slack synthesis, and calendar prep";
+}, {
+    readonly id: "run_sales";
+    readonly num: 6;
+    readonly name: "Run Sales";
+    readonly tier: 2;
+    readonly tierName: "The Operating System";
+    readonly action: "Ask to prepare a proposal, run discovery on a prospect, or build a quote.";
+    readonly signal: "First compound business deliverable";
+}, {
+    readonly id: "research_publish";
+    readonly num: 7;
+    readonly name: "Research & Publish";
+    readonly tier: 2;
+    readonly tierName: "The Operating System";
+    readonly action: "Ask to research a topic and publish the findings as institutional knowledge.";
+    readonly signal: "First published wiki article or KB entry";
+}, {
+    readonly id: "audit_business";
+    readonly num: 8;
+    readonly name: "Audit Your Business";
+    readonly tier: 2;
+    readonly tierName: "The Operating System";
+    readonly action: "Ask \"How healthy is our business?\" or request a pulse audit.";
+    readonly signal: "First scored business health audit";
+}, {
+    readonly id: "operating_rhythm";
+    readonly num: 9;
+    readonly name: "Your Operating Rhythm";
+    readonly tier: 3;
+    readonly tierName: "Agentic Mastery";
+    readonly action: "Set up weekly reviews, delegate recurring work to crews, and build your voice profile.";
+    readonly signal: "Return for second session with intent; establish a routine";
+}];
 export declare function registerPrompts(server: McpServer, getClientFn?: () => Promise<TacitClient>): void;

package/dist/prompts.js

@@ -45,7 +45,7 @@ function buildAssistantSystemPrompt(state) {
     lines.push('Prefer a single read tool for direct lookups, synthesis for open questions, and ask before any write or dispatch.');
     return lines.join('\n');
 }
-async function fetchWorkspaceState(client) {
+export async function fetchWorkspaceState(client) {
     await client.initialize();
     const wsName = client.workspaceName || 'your workspace';
     const [collectionsRes, portfoliosRes, sourcesRes] = await Promise.all([
@@ -71,7 +71,7 @@ async function fetchWorkspaceState(client) {
         sourceCount: sources.length,
     };
 }
-const CAPABILITY_DOMAINS = [
+export const CAPABILITY_DOMAINS = [
     { domain: 'Search & Recall', triggers: ['What do we know about…', 'Find me…', 'Look up…'], description: 'Search workspace knowledge and recall specific items' },
     { domain: 'Synthesis & Analysis', triggers: ['Summarize…', 'What does our data say about…', 'Compare…'], description: 'Grounded answers with citations from your workspace' },
     { domain: 'Knowledge Base', triggers: ['Create an article about…', 'Organize our knowledge on…'], description: 'Build and organize your reference library' },
@@ -91,7 +91,7 @@ const CAPABILITY_DOMAINS = [
     { domain: 'Connectors', triggers: ['Connect my Gmail…', 'Add Slack…'], description: 'Connect external tools via claude.ai Integrations' },
     { domain: 'Code & GitHub', triggers: ['Show my repo connections…', 'Sync from GitHub…'], description: 'Repository connections and code sync' },
 ];
-const EXPERIENCES = [
+export const EXPERIENCES = [
     { id: 'first_light', num: 1, name: 'First Light', tier: 1, tierName: 'Orient & Equip', action: 'Ask a question about your business — try "What do we know about [topic]?"', signal: 'First grounded, cited answer about your company' },
     { id: 'feed_it', num: 2, name: 'Feed It', tier: 1, tierName: 'Orient & Equip', action: 'Add something to your workspace — share a URL, document, or file.', signal: 'First successful content ingestion' },
     { id: 'build_your_map', num: 3, name: 'Build Your Map', tier: 1, tierName: 'Orient & Equip', action: 'Organize your work — ask to create a collection, build a portfolio, or structure your business.', signal: 'First organizational write operation' },

package/dist/setup.js

@@ -463,42 +463,60 @@ export async function setup(argv) {
     // fall back to env-var placeholder when the token came from the environment.
     const resolvedToken = token ?? null;
     const profileEntry = buildProfileEntry(apiUrl, envVarName, resolvedToken);
-    const existing = readExistingConfig();
-    const merged = mergeConfig(existing, profile, profileEntry);
-    const output = configToBytes(merged);
     // D10: emit confirmation string BEFORE writing (also printed in dry-run).
-    process.stdout.write(`Writing tacit entry to ~/.claude/mcp.json (profile: ${profile})...\n`);
+    process.stdout.write(`\n  Registering MCP server "${profile}" with Claude Code...\n`);
     if (opts.dryRun) {
-        // Redact any literal token in dry-run preview to avoid leaking secrets to stdout.
-        const redacted = resolvedToken
-            ? configToBytes(mergeConfig(existing, profile, buildProfileEntry(apiUrl, envVarName, null)))
-            : output;
-        process.stdout.write('(dry-run) Would write:\n');
-        process.stdout.write(redacted);
+        process.stdout.write('  (dry-run) Would register:\n');
+        const redactedEntry = buildProfileEntry(apiUrl, envVarName, null);
+        process.stdout.write(`  ${JSON.stringify(redactedEntry, null, 2)}\n`);
         process.exit(0);
         return;
     }
-    // Create ~/.claude with mode 0700 if absent.
+    // Register via `claude mcp add-json` — the only way Claude Code discovers MCP servers.
+    // Writing ~/.claude/mcp.json directly does NOT work (Claude Code ignores that file).
+    const jsonConfig = JSON.stringify(profileEntry);
+    const registered = await new Promise((resolve) => {
+        execFile('claude', ['mcp', 'add-json', '--scope', 'user', profile, jsonConfig], {
+            timeout: 15_000,
+        }, (err, stdout, stderr) => {
+            if (err) {
+                process.stderr.write(`\n  Warning: could not register via "claude mcp add-json".\n`);
+                process.stderr.write(`  ${stderr || err.message}\n`);
+                resolve(false);
+            }
+            else {
+                resolve(true);
+            }
+        });
+    });
+    // Fallback: also write ~/.claude/mcp.json for environments without `claude` CLI.
     const dir = claudeDir();
     if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
     }
+    const existing = readExistingConfig();
+    const merged = mergeConfig(existing, profile, profileEntry);
+    const output = configToBytes(merged);
     const dest = mcpJsonPath();
     fs.writeFileSync(dest, output, { encoding: 'utf-8', mode: 0o600 });
-    // Ensure 0600 even when the file pre-existed with looser permissions.
     fs.chmodSync(dest, 0o600);
     // AC-12: write ~/.tacit/profiles/<profile>.json metadata (token NOT included).
     if (expiresAt) {
         writeProfileMetadata(profile, expiresAt, apiUrl);
     }
-    if (resolvedToken) {
-        process.stdout.write(`\nSetup complete. Your token has been saved to ~/.claude/mcp.json.\n` +
-            `Start a new Claude Code session to connect.\n`);
+    if (registered) {
+        process.stdout.write(`\n  Done! Start a new Claude Code session to connect.\n`);
+    }
+    else if (resolvedToken) {
+        process.stdout.write(`\n  Config written to ~/.claude/mcp.json (fallback).\n` +
+            `  If Claude Code doesn't pick it up, run:\n` +
+            `    claude mcp add-json --scope user ${profile} '${jsonConfig}'\n` +
+            `  Then start a new Claude Code session.\n`);
     }
     else {
-        process.stdout.write(`\nSetup complete. Add this to your shell profile:\n` +
-            `  export ${envVarName}=<your-token>\n` +
-            `\nThen start a new Claude Code session to connect.\n`);
+        process.stdout.write(`\n  Setup complete. Add this to your shell profile:\n` +
+            `    export ${envVarName}=<your-token>\n` +
+            `\n  Then start a new Claude Code session to connect.\n`);
     }
     if (opts.smoke) {
         await runSmoke(apiUrl, token);

package/dist/tools/onboarding.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TacitClient } from '../client.js';
+export declare function registerOnboardingTools(server: McpServer, getClient: () => Promise<TacitClient>): void;

package/dist/tools/onboarding.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { TacitApiError } from '../client.js';
+import { success, error } from './errors.js';
+import { EXPERIENCES, fetchWorkspaceState } from '../prompts.js';
+export function registerOnboardingTools(server, getClient) {
+    server.tool('tacit_onboarding', 'Guide the user through the TACIT onboarding journey — the Nine Experiences that take them from first question to operating rhythm. ' +
+        'Call this when the user says things like: "onboard me", "take me through onboarding", "show me the way", ' +
+        '"get me started", "what should I try next", "how do I get started", "walk me through setup", ' +
+        '"what are the experiences", "show me what I can do", or any request for guided onboarding.', {
+        completed: z
+            .string()
+            .optional()
+            .describe('Comma-separated experience IDs the user has already completed (e.g. "first_light,feed_it"). ' +
+            'Omit if unknown — the tool will start from the beginning.'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const state = await fetchWorkspaceState(client);
+            const completedIds = (args.completed || '')
+                .split(',')
+                .map(s => s.trim().toLowerCase())
+                .filter(Boolean);
+            const completedSet = new Set(completedIds);
+            const tier1 = EXPERIENCES.filter(e => e.tier === 1);
+            const tier2 = EXPERIENCES.filter(e => e.tier === 2);
+            const tier3 = EXPERIENCES.filter(e => e.tier === 3);
+            const tier1Complete = tier1.every(e => completedSet.has(e.id));
+            let next;
+            if (!tier1Complete) {
+                next = tier1.find(e => !completedSet.has(e.id));
+            }
+            else {
+                next = tier2.find(e => !completedSet.has(e.id));
+                if (!next)
+                    next = tier3.find(e => !completedSet.has(e.id));
+            }
+            const lines = [];
+            lines.push(`## Onboarding: ${state.name}`);
+            lines.push('');
+            lines.push(`Progress: ${completedIds.length} of ${EXPERIENCES.length} experiences complete.`);
+            lines.push('');
+            if (!next) {
+                lines.push('All nine experiences complete — you are a TACIT power user.');
+                lines.push('');
+                lines.push('From here, build your own operating rhythm: set up recurring briefs, delegate complex tasks to crews, and let the system learn your patterns.');
+                return success({ onboarding: lines.join('\n'), status: 'complete', completed: completedIds.length, total: EXPERIENCES.length });
+            }
+            lines.push(`### Next: Experience ${next.num} — ${next.name}`);
+            lines.push(`*${next.tierName}*`);
+            lines.push('');
+            lines.push(next.action);
+            lines.push('');
+            lines.push(`**When complete:** ${next.signal}`);
+            if (next.tier === 2 && tier1Complete) {
+                const otherTier2 = tier2.filter(e => e.id !== next.id && !completedSet.has(e.id));
+                if (otherTier2.length > 0) {
+                    lines.push('');
+                    lines.push(`Also available: ${otherTier2.map(e => e.name).join(', ')} — Tier 2 experiences work in any order.`);
+                }
+            }
+            lines.push('');
+            lines.push('### All Nine Experiences');
+            lines.push('');
+            for (const exp of EXPERIENCES) {
+                const done = completedSet.has(exp.id);
+                const current = exp.id === next.id;
+                const prefix = done ? '✓' : current ? '→' : '○';
+                lines.push(`${prefix} **${exp.num}. ${exp.name}** (${exp.tierName})${done ? ' — done' : current ? ' — up next' : ''}`);
+            }
+            return success({
+                onboarding: lines.join('\n'),
+                status: 'in_progress',
+                completed: completedIds.length,
+                total: EXPERIENCES.length,
+                next_experience: { id: next.id, num: next.num, name: next.name, tier: next.tier, action: next.action },
+            });
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacitai/mcp-server",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "stdio MCP server wrapping Tacit /api/v1 REST/SSE API",
   "license": "UNLICENSED",
   "private": false,