@engramx/mcp 0.1.0

package/dist/tools.js

@@ -0,0 +1,313 @@
+import { z } from 'zod';
+import { toSerializable } from './utils.js';
+function jsonText(value) {
+    return JSON.stringify(toSerializable(value), null, 2);
+}
+const MAX_PATH_LENGTH = 1024;
+const E8S_PER_ICP = 100_000_000;
+function validatePath(p) {
+    if (!p || p.length === 0)
+        return 'Path cannot be empty';
+    if (p.length > MAX_PATH_LENGTH)
+        return 'Path exceeds maximum length';
+    if (p.includes('\0'))
+        return 'Path contains null byte';
+    if (p.includes('..'))
+        return 'Path traversal sequences not allowed';
+    return null;
+}
+export function registerTools(server, engram) {
+    // 1. engram_read_memory
+    server.tool('engram_read_memory', 'Read a memory file from the engram (e.g. "MEMORY.md", "memory/2026-02-11.md"). Returns content, version, and last modified timestamp.', { path: z.string().describe('File path in the engram') }, async ({ path }) => {
+        const pathErr = validatePath(path);
+        if (pathErr)
+            return { content: [{ type: 'text', text: pathErr }], isError: true };
+        try {
+            const file = await engram.readMemory(path);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: jsonText({
+                            path: file.path,
+                            content: file.content,
+                            version: file.version,
+                            lastModifiedAt: file.lastModifiedAt,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // (engram_write_memory removed: writeMemory is owner-only by design — operators
+    // are append-only. Owner uses the dashboard at engramx.ai or the canister IDL
+    // directly via Internet Identity.)
+    // 2. engram_append_memory
+    server.tool('engram_append_memory', 'Append content to a memory file. Creates the file if it does not exist. Cannot modify owner-protected paths.', {
+        path: z.string().describe('File path'),
+        content: z.string().describe('Content to append'),
+    }, async ({ path, content }) => {
+        const pathErr = validatePath(path);
+        if (pathErr)
+            return { content: [{ type: 'text', text: pathErr }], isError: true };
+        try {
+            const version = await engram.appendMemory(path, content);
+            return {
+                content: [{ type: 'text', text: jsonText({ path, version }) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 3. engram_list_memory_files
+    server.tool('engram_list_memory_files', 'List all memory files stored in the engram. Returns path, version, and last modified timestamp for each file.', async () => {
+        try {
+            const files = await engram.listMemoryFiles();
+            return {
+                content: [{ type: 'text', text: jsonText(files) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 5. engram_read_memory_batch
+    server.tool('engram_read_memory_batch', 'Read multiple memory files in a single call. More efficient than multiple engram_read_memory calls.', 
+    // Cap matches the canister's MAX_BATCH_READ_PATHS (50) and tool-schemas.json maxItems —
+    // a larger batch would pass zod here only to be rejected wholesale canister-side.
+    { paths: z.array(z.string()).max(50).describe('Array of file paths to read (max 50)') }, async ({ paths }) => {
+        try {
+            for (const p of paths) {
+                const pathErr = validatePath(p);
+                if (pathErr)
+                    return {
+                        content: [{ type: 'text', text: `Invalid path "${p}": ${pathErr}` }],
+                        isError: true,
+                    };
+            }
+            const results = await engram.readMemoryBatch(paths);
+            const serialized = results.map(([path, fileOrError]) => {
+                if (fileOrError instanceof Error) {
+                    return { path, error: fileOrError.message };
+                }
+                return {
+                    path,
+                    content: fileOrError.content,
+                    version: fileOrError.version,
+                    lastModifiedAt: fileOrError.lastModifiedAt,
+                };
+            });
+            return {
+                content: [{ type: 'text', text: jsonText(serialized) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 6. engram_memory_history
+    server.tool('engram_memory_history', 'Get the version history of a memory file, showing all modifications with timestamps and operation types.', { path: z.string().describe('File path') }, async ({ path }) => {
+        const pathErr = validatePath(path);
+        if (pathErr)
+            return { content: [{ type: 'text', text: pathErr }], isError: true };
+        try {
+            const history = await engram.getMemoryHistory(path);
+            return {
+                content: [{ type: 'text', text: jsonText(history) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 7. engram_wallet_balance
+    server.tool('engram_wallet_balance', 'Check the engram canister cycles balance (canister fuel).', async () => {
+        try {
+            const cycles = await engram.walletBalance();
+            // Match HTTP MCP shape: {cyclesBalance: <number-or-string>}
+            // BigInt serialized via jsonText becomes a string representation.
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: jsonText({ cyclesBalance: cycles }),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // NOTE: there is intentionally no `engram_transfer` tool. Operators are
+    // append-only and have zero owner-level fund control; the only money-moving
+    // canister method is the owner-only `ownerWithdraw`, which is never exposed on
+    // the operator MCP surface. (Removed: it called a non-existent
+    // `operatorTransfer` method and advertised a `wallet.spend` capability that
+    // contradicts the operator invariant.)
+    // 9. engram_status
+    server.tool('engram_status', 'Get engram canister health and status: memory file count, operator count, cycles balance, version, and more.', async () => {
+        try {
+            const status = await engram.status();
+            return {
+                content: [{ type: 'text', text: jsonText(status) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // engram_read_audit_log
+    server.tool('engram_read_audit_log', 'Read the engram audit log. Returns timestamped entries of all operations performed on the engram.', {
+        fromIndex: z.number().optional().describe('Starting index (default: 0)'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .optional()
+            .default(100)
+            .describe('Max entries to return (default: 100)'),
+    }, async ({ fromIndex, limit }) => {
+        try {
+            const entries = await engram.readAuditLog(fromIndex ?? 0, limit);
+            return {
+                content: [{ type: 'text', text: jsonText(entries) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // === ic402 Service Marketplace ===
+    server.tool('engram_list_services', 'List available paid services registered on this engram.', {}, async () => {
+        try {
+            const services = await engram.listServices();
+            return { content: [{ type: 'text', text: jsonText(services) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool('engram_submit_service_request', 'Submit a paid service request. Returns a job ID for polling.', {
+        serviceId: z.string().describe('ID of the service to request'),
+        params: z.string().describe('Request parameters (will be UTF-8 encoded)'),
+    }, async ({ serviceId, params }) => {
+        try {
+            // Auto-pay: builds the x402 payment (ICRC-2 approve + retry) so a paid request
+            // actually settles. The plain submitServiceRequest sends no sig and can never complete.
+            const result = await engram.submitServiceRequestWithPayment(serviceId, new TextEncoder().encode(params));
+            return { content: [{ type: 'text', text: jsonText(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool('engram_get_job_result', 'Poll a service job until it reaches a terminal status. Returns the full job object.', {
+        jobId: z.string().describe('Job ID to poll'),
+        maxAttempts: z.number().optional().describe('Max polling attempts (default 30)'),
+    }, async ({ jobId, maxAttempts }) => {
+        try {
+            const job = await engram.pollJobResult(jobId, maxAttempts ?? 30);
+            return { content: [{ type: 'text', text: jsonText(job) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool('engram_dispute_job', 'Dispute a completed job (for BuyerConfirm verification method).', {
+        jobId: z.string().describe('Job ID to dispute'),
+        reason: z.string().describe('Reason for the dispute'),
+    }, async ({ jobId, reason }) => {
+        try {
+            await engram.disputeJob(jobId, reason);
+            return { content: [{ type: 'text', text: `Disputed job ${jobId}` }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool('engram_confirm_job', 'Confirm a completed job result (for BuyerConfirm verification), releasing payment to the operator.', {
+        jobId: z.string().describe('Job ID to confirm'),
+    }, async ({ jobId }) => {
+        try {
+            await engram.confirmJob(jobId);
+            return { content: [{ type: 'text', text: `Confirmed job ${jobId}` }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // (engram_sign_typed_data removed: signTypedData is owner-only — cryptographic
+    // signing as the agent's ERC-8004 identity is a value-bearing operation that
+    // operators must not be able to perform. Owner uses dashboard or canister IDL.)
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Convert BigInt values in an object to strings for JSON serialization.
+ * Uses string representation to avoid precision loss for values > 2^53.
+ */
+export declare function toSerializable(value: unknown): unknown;

package/dist/utils.js

@@ -0,0 +1,30 @@
+/**
+ * Convert BigInt values in an object to strings for JSON serialization.
+ * Uses string representation to avoid precision loss for values > 2^53.
+ */
+export function toSerializable(value) {
+    if (value === null || value === undefined)
+        return value;
+    // Always stringify BigInt: stable type per field for the model + no precision loss.
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (typeof value === 'object' &&
+        'toText' in value &&
+        typeof value['toText'] === 'function') {
+        return value.toText();
+    }
+    if (value instanceof Uint8Array)
+        return Array.from(value);
+    if (Array.isArray(value))
+        return value.map(toSerializable);
+    if (typeof value === 'object') {
+        const obj = {};
+        for (const [k, v] of Object.entries(value)) {
+            obj[k] = toSerializable(v);
+        }
+        return obj;
+    }
+    return value;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,oFAAoF;IACpF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAAiC,CAAC,QAAQ,CAAC,KAAK,UAAU,EAClE,CAAC;QACD,OAAQ,KAAkC,CAAC,MAAM,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@engramx/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for EngramX — persistent, decentralized agent memory",
+  "license": "MIT",
+  "author": "EngramX <developer@engramx.ai>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vhew/engramx",
+    "directory": "integrations/mcp"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "engramx-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@icp-sdk/core": "^5.4.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3",
+    "@engramx/client": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run"
+  }
+}