@engramx/mcp 0.1.0

package/dist/connect.js

@@ -0,0 +1,89 @@
+// `npx @engramx/mcp connect` — print ready-to-use config for connecting any MCP client to an
+// engram's remote MCP endpoint, and optionally write the Claude Desktop config file. Uses the
+// shared connect-config module (connect-config.ts) so every consumer emits identical config.
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { connectInfo, claudeDesktopConfig } from './connect-config.js';
+function parseFlags(argv) {
+    const f = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg && arg.startsWith('--')) {
+            const k = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith('--')) {
+                f[k] = next;
+                i++;
+            }
+            else {
+                f[k] = true;
+            }
+        }
+    }
+    return f;
+}
+/** Default claude_desktop_config.json path per OS. */
+function defaultClaudeDesktopPath() {
+    const home = homedir();
+    switch (platform()) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+        case 'win32':
+            return join(process.env['APPDATA'] || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+        default:
+            return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+    }
+}
+/** Merge the engramx server into an existing claude_desktop_config.json without clobbering others. */
+function writeClaudeDesktopConfig(path, p) {
+    let existing = {};
+    if (existsSync(path)) {
+        try {
+            existing = JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            throw new Error(`${path} exists but is not valid JSON — fix or remove it, then retry.`);
+        }
+    }
+    existing.mcpServers = existing.mcpServers || {};
+    existing.mcpServers.engramx = claudeDesktopConfig(p).mcpServers.engramx;
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(existing, null, 2) + '\n');
+}
+export async function runConnect(argv) {
+    const f = parseFlags(argv);
+    if (f['help'] || f['h']) {
+        console.log('Usage: npx @engramx/mcp connect --canister <id> [--host <url>] [--write [path]]');
+        return;
+    }
+    const canisterId = f['canister'] ||
+        process.env['ENGRAM_CANISTER_ID'] ||
+        process.env['VAULT_CANISTER_ID'];
+    const host = f['host'] || process.env['ENGRAM_HOST'] || 'https://icp0.io';
+    if (!canisterId) {
+        console.error('Error: --canister <id> (or ENGRAM_CANISTER_ID) is required.');
+        console.error('Usage: npx @engramx/mcp connect --canister <id> [--host <url>] [--write [path]]');
+        process.exit(2);
+    }
+    const info = connectInfo({ canisterId, host });
+    console.log('\nConnect Claude (and other MCP clients) to your engram\n');
+    console.log(`Remote MCP URL:\n  ${info.mcpUrl}\n`);
+    for (const g of info.guides) {
+        console.log(`• ${g.name}  [${g.transport}]`);
+        for (const s of g.steps)
+            console.log(`    - ${s}`);
+        if (g.snippet)
+            for (const line of g.snippet.split('\n'))
+                console.log(`      ${line}`);
+    }
+    if (f['write']) {
+        const path = typeof f['write'] === 'string' ? f['write'] : defaultClaudeDesktopPath();
+        writeClaudeDesktopConfig(path, { canisterId, host });
+        console.log(`\n✓ Wrote the engramx MCP server to ${path}. Restart Claude Desktop to load it.`);
+    }
+    else {
+        console.log('\n(Re-run with --write to merge the stdio config into claude_desktop_config.json.)');
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// Entry router. With no subcommand, start the stdio MCP server (the default). The `connect`
+// subcommand only generates client config, so it's handled BEFORE importing ./server.js — which
+// statically pulls in @engramx/client and requires a session key.
+import { runConnect } from './connect.js';
+if (process.argv[2] === 'connect') {
+    await runConnect(process.argv.slice(3));
+    process.exit(0);
+}
+await import('./server.js');
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,4FAA4F;AAC5F,gGAAgG;AAChG,kEAAkE;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;IAClC,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/dist/profile-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ProfileManager, SessionManager } from '@engramx/client';
+export declare function registerProfileTools(server: McpServer, profile: ProfileManager, sessions: SessionManager): void;

package/dist/profile-tools.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import { toSerializable } from './utils.js';
+function jsonText(value) {
+    return JSON.stringify(toSerializable(value), null, 2);
+}
+export function registerProfileTools(server, profile, sessions) {
+    // 1. engram_get_profile
+    server.tool('engram_get_profile', 'Load the user identity (soul, user, preferences) and accumulated lessons in one call. Use at session start to learn who the user is.', async () => {
+        try {
+            const p = await profile.getProfile();
+            return { content: [{ type: 'text', text: jsonText(p) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 2. engram_save_preference
+    server.tool('engram_save_preference', 'Save a user preference (e.g. "prefers terse responses", "uses dark mode"). Persists across platforms.', { preference: z.string().describe('The preference to save') }, async ({ preference }) => {
+        try {
+            const version = await profile.savePreference(preference);
+            return { content: [{ type: 'text', text: jsonText({ saved: true, version }) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 3. engram_save_insight
+    server.tool('engram_save_insight', 'Save a lesson learned or insight. Optionally provide a topic for domain-specific knowledge.', {
+        content: z.string().describe('The insight or lesson to save'),
+        topic: z
+            .string()
+            .optional()
+            .describe('Optional domain topic (e.g. "typescript", "devops"). Lowercase, alphanumeric.'),
+    }, async ({ content, topic }) => {
+        try {
+            const version = await profile.saveInsight({ content, topic });
+            return { content: [{ type: 'text', text: jsonText({ saved: true, version, topic }) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 4. engram_save_decision
+    server.tool('engram_save_decision', 'Record a decision and its rationale for future reference across platforms.', {
+        decision: z.string().describe('What was decided'),
+        rationale: z.string().describe('Why this decision was made'),
+    }, async ({ decision, rationale }) => {
+        try {
+            const version = await profile.saveDecision(decision, rationale);
+            return { content: [{ type: 'text', text: jsonText({ saved: true, version }) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 5. engram_session_summary
+    server.tool('engram_session_summary', 'Write a session summary for today. Other platforms can read this to maintain continuity.', {
+        platform: z.string().describe('Platform name (e.g. "claude", "openclaw")'),
+        summary: z.string().describe('Summary of what was discussed or accomplished'),
+        date: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/)
+            .optional()
+            .describe('Date in YYYY-MM-DD format (defaults to today)'),
+    }, async ({ platform, summary, date }) => {
+        try {
+            const version = await sessions.writeSummary(platform, summary, date);
+            return { content: [{ type: 'text', text: jsonText({ saved: true, platform, version }) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 6. engram_read_sessions
+    server.tool('engram_read_sessions', 'Read recent session summaries. Optionally filter by platform, or exclude a platform to see cross-platform activity.', {
+        platform: z.string().optional().describe('Filter to a specific platform'),
+        exclude_platform: z
+            .string()
+            .optional()
+            .describe('Exclude a platform (for cross-platform reads, e.g. exclude "claude" to see what OpenClaw did)'),
+        limit: z.number().min(1).max(20).optional().default(5).describe('Max sessions to return'),
+    }, async ({ platform, exclude_platform, limit }) => {
+        try {
+            let result;
+            if (exclude_platform) {
+                result = await sessions.readCrossPlatform(exclude_platform, limit);
+            }
+            else if (platform) {
+                const entries = await sessions.listSessions(platform);
+                const recent = entries.slice(0, limit);
+                const paths = recent.map((e) => e.path);
+                if (paths.length === 0) {
+                    return { content: [{ type: 'text', text: '[]' }] };
+                }
+                // Read the actual content — use readSummary for each
+                result = [];
+                for (const entry of recent) {
+                    const content = await sessions.readSummary(entry.platform, entry.date);
+                    if (content) {
+                        result.push({ platform: entry.platform, date: entry.date, content });
+                    }
+                }
+            }
+            else {
+                result = await sessions.readRecent(limit);
+            }
+            return { content: [{ type: 'text', text: jsonText(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=profile-tools.js.map

package/dist/profile-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-tools.js","sourceRoot":"","sources":["../src/profile-tools.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { EngramClient } from '@engramx/client';
+export declare function registerResources(server: McpServer, engram: EngramClient): void;

package/dist/resources.js

@@ -0,0 +1,22 @@
+import { toSerializable } from './utils.js';
+export function registerResources(server, engram) {
+    server.resource('engram-status', 'engram://status', { description: 'Engram canister status — memory file count, operators, cycles, version' }, async (uri) => {
+        try {
+            const status = await engram.status();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(toSerializable(status), null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { contents: [{ uri: uri.href, mimeType: 'text/plain', text: `Error: ${message}` }] };
+        }
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAoB;IACvE,MAAM,CAAC,QAAQ,CACb,eAAe,EACf,iBAAiB,EACjB,EAAE,WAAW,EAAE,wEAAwE,EAAE,EACzF,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server.js

@@ -0,0 +1,52 @@
+// The stdio MCP server (default invocation). Split out of index.ts so the lightweight `connect`
+// subcommand router doesn't statically pull in @engramx/client or require a session key.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { EngramClient, ProfileManager, SessionManager } from '@engramx/client';
+import { registerTools } from './tools.js';
+import { registerProfileTools } from './profile-tools.js';
+import { registerResources } from './resources.js';
+// --- Environment variables (same names as agent-skill.ts) ---
+const canisterId = process.env['ENGRAM_CANISTER_ID'] || process.env['VAULT_CANISTER_ID'];
+if (!canisterId) {
+    console.error('Error: ENGRAM_CANISTER_ID environment variable is required.\n' +
+        'Set it to your engram canister ID (e.g. "xxxxx-xxxxx-xxxxx-xxxxx-xxx").\n' +
+        'To connect a client instead, run: npx @engramx/mcp connect --canister <id>');
+    process.exit(1);
+}
+const sessionKeyPath = process.env['ENGRAM_SESSION_KEY_PATH'] ||
+    process.env['ENGRAMX_SESSION_KEY_PATH'] ||
+    process.env['VAULT_SESSION_KEY_PATH'] ||
+    join(homedir(), '.engramx', 'session.key');
+if (!existsSync(sessionKeyPath)) {
+    console.error(`Error: Session key not found at ${sessionKeyPath}.\n` +
+        'Generate one with: npx @engramx/client pair <invite-code> --engram <canister-id>');
+    process.exit(1);
+}
+const host = process.env['ENGRAM_HOST'] || 'https://ic0.app';
+// --- Client ---
+const engram = new EngramClient({
+    canisterId,
+    sessionKeyPath,
+    host,
+    cacheMaxAge: 60_000,
+});
+// --- MCP Server ---
+const server = new McpServer({
+    name: 'engramx',
+    version: '0.1.0',
+});
+const profile = new ProfileManager(engram);
+const sessions = new SessionManager(engram);
+registerTools(server, engram);
+registerProfileTools(server, profile, sessions);
+registerResources(server, engram);
+// --- Connect via stdio ---
+const transport = new StdioServerTransport();
+await server.connect(transport);
+// Log to stderr — stdout is the MCP protocol channel
+console.error(`engramx MCP server started (canister: ${canisterId}, host: ${host})`);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,yFAAyF;AAEzF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,+DAA+D;AAE/D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACzF,IAAI,CAAC,UAAU,EAAE,CAAC;IAChB,OAAO,CAAC,KAAK,CACX,+DAA+D;QAC7D,2EAA2E;QAC3E,4EAA4E,CAC/E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAE7C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CACX,mCAAmC,cAAc,KAAK;QACpD,kFAAkF,CACrF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,iBAAiB,CAAC;AAE7D,iBAAiB;AAEjB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;IAC9B,UAAU;IACV,cAAc;IACd,IAAI;IACJ,WAAW,EAAE,MAAM;CACpB,CAAC,CAAC;AAEH,qBAAqB;AAErB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AAE5C,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9B,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChD,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElC,4BAA4B;AAE5B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,qDAAqD;AACrD,OAAO,CAAC,KAAK,CAAC,yCAAyC,UAAU,WAAW,IAAI,GAAG,CAAC,CAAC"}

package/dist/tool-schemas.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Canonical schema source for MCP tools — used by both surfaces.
+ *
+ * Stdio MCP imports `TOOL_SCHEMAS` and registers tools at runtime.
+ *
+ * HTTP MCP (canister) gets a generated Motoko file `src/engram/McpTools.mo`
+ * from `scripts/gen-mcp-tools.mjs` reading `tool-schemas.json` (which this
+ * file re-exports). Run as part of `compile-wasm.sh`.
+ *
+ * To add a tool:
+ *   1. Add an entry to `tool-schemas.json` with surfaces ['stdio', 'http'] (or just one).
+ *   2. For stdio: add a handler in `tools.ts` keyed by tool name.
+ *   3. For HTTP MCP: add a `case (#X) { ... }` in `dispatchTool` (main.mo),
+ *      then run `node scripts/gen-mcp-tools.mjs` to refresh the catalog.
+ */
+import { z } from 'zod';
+export type Surface = 'stdio' | 'http';
+export interface JsonSchemaProperty {
+    type: 'string' | 'integer' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    default?: unknown;
+    items?: {
+        type: string;
+    };
+    maxItems?: number;
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        required?: string[];
+        properties: Record<string, JsonSchemaProperty>;
+    };
+    requiredScope?: 'memory.read' | 'memory.append' | 'wallet.read' | 'wallet.spend';
+    surfaces: Surface[];
+}
+export declare const TOOL_SCHEMAS: ToolSchema[];
+/** Convert a JSON Schema property shape to a Zod type for runtime validation. */
+export declare function jsonSchemaPropertyToZod(prop: JsonSchemaProperty, required: boolean): z.ZodTypeAny;
+/** Build a Zod shape (record of property → ZodType) from a tool's inputSchema. */
+export declare function buildZodShape(tool: ToolSchema): Record<string, z.ZodTypeAny>;
+/** Find a tool schema by name. Returns undefined if not found. */
+export declare function findToolSchema(name: string): ToolSchema | undefined;
+/** Tools available on a given surface. */
+export declare function toolsForSurface(surface: Surface): ToolSchema[];

package/dist/tool-schemas.js

@@ -0,0 +1,70 @@
+/**
+ * Canonical schema source for MCP tools — used by both surfaces.
+ *
+ * Stdio MCP imports `TOOL_SCHEMAS` and registers tools at runtime.
+ *
+ * HTTP MCP (canister) gets a generated Motoko file `src/engram/McpTools.mo`
+ * from `scripts/gen-mcp-tools.mjs` reading `tool-schemas.json` (which this
+ * file re-exports). Run as part of `compile-wasm.sh`.
+ *
+ * To add a tool:
+ *   1. Add an entry to `tool-schemas.json` with surfaces ['stdio', 'http'] (or just one).
+ *   2. For stdio: add a handler in `tools.ts` keyed by tool name.
+ *   3. For HTTP MCP: add a `case (#X) { ... }` in `dispatchTool` (main.mo),
+ *      then run `node scripts/gen-mcp-tools.mjs` to refresh the catalog.
+ */
+import { z } from 'zod';
+import schemasJson from './tool-schemas.json' with { type: 'json' };
+export const TOOL_SCHEMAS = schemasJson.tools;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Convert a JSON Schema property shape to a Zod type for runtime validation. */
+export function jsonSchemaPropertyToZod(prop, required) {
+    let zodType;
+    switch (prop.type) {
+        case 'string':
+            zodType = z.string();
+            break;
+        case 'integer':
+        case 'number':
+            zodType = z.number();
+            break;
+        case 'boolean':
+            zodType = z.boolean();
+            break;
+        case 'array':
+            zodType = z.array(prop.items?.type === 'string' ? z.string() : z.any());
+            break;
+        case 'object':
+            zodType = z.record(z.string(), z.any());
+            break;
+        default:
+            zodType = z.any();
+    }
+    if (prop.description)
+        zodType = zodType.describe(prop.description);
+    if (prop.default !== undefined)
+        zodType = zodType.default(prop.default);
+    if (!required)
+        zodType = zodType.optional();
+    return zodType;
+}
+/** Build a Zod shape (record of property → ZodType) from a tool's inputSchema. */
+export function buildZodShape(tool) {
+    const shape = {};
+    const required = new Set(tool.inputSchema.required ?? []);
+    for (const [name, prop] of Object.entries(tool.inputSchema.properties)) {
+        shape[name] = jsonSchemaPropertyToZod(prop, required.has(name));
+    }
+    return shape;
+}
+/** Find a tool schema by name. Returns undefined if not found. */
+export function findToolSchema(name) {
+    return TOOL_SCHEMAS.find((t) => t.name === name);
+}
+/** Tools available on a given surface. */
+export function toolsForSurface(surface) {
+    return TOOL_SCHEMAS.filter((t) => t.surfaces.includes(surface));
+}
+//# sourceMappingURL=tool-schemas.js.map

package/dist/tool-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.js","sourceRoot":"","sources":["../src/tool-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,WAAW,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAwBpE,MAAM,CAAC,MAAM,YAAY,GAAiB,WAAW,CAAC,KAAqB,CAAC;AAE5E,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,IAAwB,EAAE,QAAiB;IACjF,IAAI,OAAqB,CAAC;IAC1B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACxE,MAAM;QACR,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACxC,MAAM;QACR;YACE,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,CAAC,WAAW;QAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAC5B,OAAO,GAAI,OAAsC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,MAAM,KAAK,GAAiC,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/tool-schemas.json

@@ -0,0 +1,136 @@
+{
+    "$comment": "Canonical MCP tool catalog. Single source of truth for stdio MCP and HTTP MCP. Stdio loads at runtime via tool-schemas.ts; HTTP MCP gets a generated Motoko file (src/engram/McpTools.mo) from scripts/gen-mcp-tools.mjs reading this JSON.",
+    "tools": [
+        {
+            "name": "engram_read_memory",
+            "description": "Read a memory file from the engram by path. Returns {path, content, version, lastModifiedAt}.",
+            "inputSchema": {
+                "type": "object",
+                "required": ["path"],
+                "properties": {
+                    "path": {
+                        "type": "string",
+                        "description": "Path within the engram (e.g. identity/preferences.md)"
+                    }
+                }
+            },
+            "requiredScope": "memory.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_append_memory",
+            "description": "Append content to a memory file. Creates the file if it does not exist. Cannot write to owner-only protected paths.",
+            "inputSchema": {
+                "type": "object",
+                "required": ["path", "content"],
+                "properties": {
+                    "path": { "type": "string", "description": "File path" },
+                    "content": { "type": "string", "description": "Content to append" }
+                }
+            },
+            "requiredScope": "memory.append",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_list_memory_files",
+            "description": "List all memory file paths in the engram with version and lastModifiedAt.",
+            "inputSchema": { "type": "object", "properties": {} },
+            "requiredScope": "memory.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_read_memory_batch",
+            "description": "Read multiple memory files in a single call. Returns content for each path or an error.",
+            "inputSchema": {
+                "type": "object",
+                "required": ["paths"],
+                "properties": {
+                    "paths": { "type": "array", "items": { "type": "string" }, "maxItems": 50 }
+                }
+            },
+            "requiredScope": "memory.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_memory_history",
+            "description": "Get version history of a memory file. Returns each prior version with timestamp and modifying principal.",
+            "inputSchema": {
+                "type": "object",
+                "required": ["path"],
+                "properties": { "path": { "type": "string" } }
+            },
+            "requiredScope": "memory.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_read_audit_log",
+            "description": "Read the engram audit log entries.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "fromIndex": { "type": "integer", "default": 0 },
+                    "limit": { "type": "integer", "default": 50 }
+                }
+            },
+            "requiredScope": "memory.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_status",
+            "description": "Get engram operational status: version, file count, audit log size, frozen/paused state.",
+            "inputSchema": { "type": "object", "properties": {} },
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_wallet_balance",
+            "description": "Get the engram canister cycles balance (canister fuel).",
+            "inputSchema": { "type": "object", "properties": {} },
+            "requiredScope": "wallet.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_list_services",
+            "description": "List paid services this engram brokers via ic402.",
+            "inputSchema": { "type": "object", "properties": {} },
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_get_job_result",
+            "description": "Retrieve the result of a previously-submitted ic402 service job by job ID.",
+            "inputSchema": {
+                "type": "object",
+                "required": ["jobId"],
+                "properties": { "jobId": { "type": "string" } }
+            },
+            "requiredScope": "memory.read",
+            "surfaces": ["stdio", "http"]
+        },
+        {
+            "name": "engram_submit_service_request",
+            "description": "Submit a paid request to an ic402 service registered on this engram.",
+            "inputSchema": {
+                "type": "object",
+                "required": ["serviceId", "params"],
+                "properties": {
+                    "serviceId": { "type": "string" },
+                    "params": { "type": "string", "description": "JSON-encoded service-specific parameters" }
+                }
+            },
+            "requiredScope": "wallet.spend",
+            "surfaces": ["stdio"]
+        },
+        {
+            "name": "engram_dispute_job",
+            "description": "Dispute a job result (operator role).",
+            "inputSchema": {
+                "type": "object",
+                "required": ["jobId", "reason"],
+                "properties": {
+                    "jobId": { "type": "string" },
+                    "reason": { "type": "string" }
+                }
+            },
+            "surfaces": ["stdio"]
+        }
+    ]
+}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { EngramClient } from '@engramx/client';
+export declare function registerTools(server: McpServer, engram: EngramClient): void;