@steno-ai/mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export { createServer } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+export { createServer } from './server.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import Steno from '@steno-ai/sdk';
+import { createServer } from './server.js';
+async function main() {
+    const apiKey = process.env.STENO_API_KEY;
+    if (!apiKey) {
+        console.error('Error: STENO_API_KEY environment variable is required.\n\n' +
+            'Set it before running:\n' +
+            '  export STENO_API_KEY=sk_steno_...\n\n' +
+            'Or pass it inline:\n' +
+            '  STENO_API_KEY=sk_steno_... npx @steno-ai/mcp');
+        process.exit(1);
+    }
+    const steno = new Steno(apiKey);
+    const server = createServer(steno);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,4DAA4D;YAC1D,0BAA0B;YAC1B,yCAAyC;YACzC,sBAAsB;YACtB,gDAAgD,CACnD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/local-server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Local MCP server — connects directly to Supabase + engine.
+ * No API deployment needed. Just set env vars and go.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { StorageAdapter } from '../../engine/src/adapters/storage.js';
+import type { EmbeddingAdapter } from '../../engine/src/adapters/embedding.js';
+import type { LLMAdapter } from '../../engine/src/adapters/llm.js';
+export interface LocalServerConfig {
+    storage: StorageAdapter;
+    embedding: EmbeddingAdapter;
+    cheapLLM: LLMAdapter;
+    tenantId: string;
+    scope: 'user' | 'agent' | 'session' | 'hive';
+    scopeId: string;
+    embeddingModel: string;
+    embeddingDim: number;
+}
+export declare function createLocalServer(config: LocalServerConfig): McpServer;
+//# sourceMappingURL=local-server.d.ts.map

package/dist/local-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../src/local-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAqQtE"}

package/dist/local-server.js

@@ -0,0 +1,226 @@
+/**
+ * Local MCP server — connects directly to Supabase + engine.
+ * No API deployment needed. Just set env vars and go.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+export function createLocalServer(config) {
+    const server = new McpServer({
+        name: 'steno-local',
+        version: '0.1.0',
+    });
+    // Lazy import to avoid loading heavy modules at startup
+    let _search = null;
+    let _pipeline = null;
+    async function getSearch() {
+        if (!_search) {
+            const mod = await import('../../engine/src/retrieval/search.js');
+            _search = mod.search;
+        }
+        return _search;
+    }
+    async function getPipeline() {
+        if (!_pipeline) {
+            const mod = await import('../../engine/src/extraction/pipeline.js');
+            _pipeline = mod.runExtractionPipeline;
+        }
+        return _pipeline;
+    }
+    // ─── REMEMBER ───
+    server.tool('steno_remember', 'Store information in long-term memory. Use this to remember facts, preferences, decisions, or anything worth recalling later.', {
+        content: z.string().optional().describe('What to remember'),
+        text: z.string().optional().describe('What to remember (alias for content)'),
+    }, async (args) => {
+        const memoryText = args.content || args.text;
+        if (!memoryText) {
+            return { content: [{ type: 'text', text: 'Error: provide content or text' }] };
+        }
+        // FAST PATH: For short, already-clean facts (< 200 chars, single sentence),
+        // skip the LLM extraction pipeline and store directly. ~200ms vs ~5000ms.
+        const isSingleFact = memoryText.length < 200 && !memoryText.includes('\n') && memoryText.split('.').length <= 2;
+        if (isSingleFact) {
+            const factId = crypto.randomUUID();
+            const embedding = await config.embedding.embed(memoryText);
+            // Ensure "User" entity exists and link fact to it
+            let userEntityId;
+            try {
+                const existing = await config.storage.findEntityByCanonicalName(config.tenantId, 'user', 'person');
+                if (existing) {
+                    userEntityId = existing.id;
+                }
+                else {
+                    userEntityId = crypto.randomUUID();
+                    await config.storage.createEntity({
+                        id: userEntityId, tenantId: config.tenantId, name: 'User',
+                        entityType: 'person', canonicalName: 'user', properties: {},
+                        embedding: await config.embedding.embed('User'),
+                        embeddingModel: config.embeddingModel, embeddingDim: config.embeddingDim,
+                    });
+                }
+            }
+            catch { }
+            const linkToUser = async (fid) => {
+                if (userEntityId) {
+                    try {
+                        await config.storage.linkFactEntity(fid, userEntityId, 'mentioned');
+                    }
+                    catch { }
+                }
+            };
+            // Quick dedup check — see if very similar fact exists
+            const matches = await config.storage.vectorSearch({
+                embedding,
+                tenantId: config.tenantId,
+                scope: config.scope,
+                scopeId: config.scopeId,
+                limit: 1,
+                minSimilarity: 0.85,
+                validOnly: true,
+            });
+            if (matches.length > 0) {
+                // Similar fact exists — create new version (Git-style append-only, never invalidate)
+                const oldFact = matches[0].fact;
+                await config.storage.createFact({
+                    id: factId,
+                    lineageId: oldFact.lineageId ?? crypto.randomUUID(),
+                    tenantId: config.tenantId,
+                    scope: config.scope,
+                    scopeId: config.scopeId,
+                    content: memoryText,
+                    embeddingModel: config.embeddingModel,
+                    embeddingDim: config.embeddingDim,
+                    embedding,
+                    importance: 0.7,
+                    confidence: 1.0,
+                    operation: 'update',
+                    sourceType: 'api',
+                    modality: 'text',
+                    tags: ['direct'],
+                    metadata: {},
+                    contradictionStatus: 'none',
+                });
+                await linkToUser(factId);
+                return {
+                    content: [{ type: 'text', text: `Updated memory (new version created)` }],
+                };
+            }
+            // No similar fact — create new
+            await config.storage.createFact({
+                id: factId,
+                lineageId: crypto.randomUUID(),
+                tenantId: config.tenantId,
+                scope: config.scope,
+                scopeId: config.scopeId,
+                content: memoryText,
+                embeddingModel: config.embeddingModel,
+                embeddingDim: config.embeddingDim,
+                embedding,
+                importance: 0.7,
+                confidence: 1.0,
+                operation: 'create',
+                sourceType: 'api',
+                modality: 'text',
+                tags: ['direct'],
+                metadata: {},
+                contradictionStatus: 'none',
+            });
+            await linkToUser(factId);
+            return {
+                content: [{ type: 'text', text: `Remembered` }],
+            };
+        }
+        // FULL PATH: For longer text, multi-sentence content, conversations.
+        // Runs LLM extraction + graph building + dedup. ~3-8 seconds.
+        const runPipeline = await getPipeline();
+        const result = await runPipeline({
+            storage: config.storage,
+            embedding: config.embedding,
+            cheapLLM: config.cheapLLM,
+            embeddingModel: config.embeddingModel,
+            embeddingDim: config.embeddingDim,
+            extractionTier: 'auto',
+        }, {
+            tenantId: config.tenantId,
+            scope: config.scope,
+            scopeId: config.scopeId,
+            inputType: 'raw_text',
+            data: memoryText,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Remembered (${result.factsCreated} facts, ${result.entitiesCreated} entities, ${result.edgesCreated} edges)`,
+                },
+            ],
+        };
+    });
+    // ─── RECALL ───
+    server.tool('steno_recall', 'Search long-term memory for relevant information. Use this when you need context about the user, their preferences, past decisions, or any previously stored knowledge.', {
+        query: z.string().describe('What to search for in memory'),
+        limit: z.number().optional().describe('Max results (default 10)'),
+    }, async ({ query, limit }) => {
+        const searchFn = await getSearch();
+        const results = await searchFn({ storage: config.storage, embedding: config.embedding }, {
+            query,
+            tenantId: config.tenantId,
+            scope: config.scope,
+            scopeId: config.scopeId,
+            limit: limit ?? 10,
+        });
+        if (results.results.length === 0) {
+            return { content: [{ type: 'text', text: 'No memories found.' }] };
+        }
+        const text = results.results
+            .map((r, i) => {
+            const signals = Object.entries(r.signals)
+                .filter(([, v]) => v > 0)
+                .map(([k, v]) => `${k.replace('Score', '')}=${v.toFixed(2)}`)
+                .join(', ');
+            return `${i + 1}. [${r.score.toFixed(2)}] ${r.fact.content}${signals ? `  (${signals})` : ''}`;
+        })
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Found ${results.results.length} memories (${results.durationMs}ms):\n\n${text}`,
+                },
+            ],
+        };
+    });
+    // ─── FEEDBACK ───
+    server.tool('steno_feedback', 'Rate whether a recalled memory was useful. Helps improve future recall quality.', {
+        fact_id: z.string().describe('Memory/fact ID to rate'),
+        useful: z.boolean().describe('Was this memory useful?'),
+    }, async ({ fact_id, useful }) => {
+        await config.storage.createMemoryAccess({
+            tenantId: config.tenantId,
+            factId: fact_id,
+            query: '',
+            searchRank: 0,
+            feedbackType: useful ? 'explicit_positive' : 'explicit_negative',
+            responseTimeMs: 0,
+        });
+        return {
+            content: [
+                { type: 'text', text: `Feedback recorded: ${useful ? 'positive' : 'negative'}` },
+            ],
+        };
+    });
+    // ─── STATS ───
+    server.tool('steno_stats', 'Get memory statistics — how many facts, entities, and edges are stored.', {}, async () => {
+        const facts = await config.storage.getFactsByScope(config.tenantId, config.scope, config.scopeId, { limit: 1 });
+        const entities = await config.storage.getEntitiesForTenant(config.tenantId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Memory stats:\n  Facts: ${facts.hasMore ? '100+' : facts.data.length}\n  Entities: ${entities.length}`,
+                },
+            ],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=local-server.js.map

package/dist/local-server.js.map

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

package/dist/local.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=local.d.ts.map

package/dist/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":""}

package/dist/local.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * Local Steno MCP server for Claude Code.
+ *
+ * Connects directly to Supabase — no API deployment needed.
+ *
+ * Required env vars:
+ *   SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY
+ *   OPENAI_API_KEY
+ *   PERPLEXITY_API_KEY (optional — falls back to OpenAI embeddings)
+ *
+ * Optional:
+ *   STENO_TENANT_ID (default: auto-created)
+ *   STENO_SCOPE_ID  (default: "default")
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createLocalServer } from './local-server.js';
+async function main() {
+    // Validate required env vars
+    const supabaseUrl = process.env.SUPABASE_URL;
+    const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+    const openaiKey = process.env.OPENAI_API_KEY;
+    if (!supabaseUrl || !supabaseKey) {
+        console.error('Error: SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY are required.\n');
+        process.exit(1);
+    }
+    if (!openaiKey) {
+        console.error('Error: OPENAI_API_KEY is required.\n');
+        process.exit(1);
+    }
+    // Dynamic imports to avoid loading everything at module level
+    const { createSupabaseClient, SupabaseStorageAdapter } = await import('../../supabase-adapter/src/index.js');
+    const { OpenAILLMAdapter } = await import('../../openai-adapter/src/index.js');
+    // Set up adapters
+    const supabase = createSupabaseClient({ url: supabaseUrl, serviceRoleKey: supabaseKey });
+    const storage = new SupabaseStorageAdapter(supabase);
+    const cheapLLM = new OpenAILLMAdapter({ apiKey: openaiKey, model: 'gpt-4.1-mini' });
+    // Embedding: prefer Perplexity (cheaper, 2000 dims) else OpenAI (3072 dims)
+    let embedding;
+    let embeddingModel;
+    let embeddingDim;
+    if (process.env.PERPLEXITY_API_KEY) {
+        const { PerplexityEmbeddingAdapter } = await import('../../engine/src/adapters/perplexity-embedding.js');
+        embedding = new PerplexityEmbeddingAdapter({
+            apiKey: process.env.PERPLEXITY_API_KEY,
+            model: 'pplx-embed-v1-4b',
+            dimensions: 2000,
+        });
+        embeddingModel = 'pplx-embed-v1-4b';
+        embeddingDim = 2000;
+    }
+    else {
+        const { OpenAIEmbeddingAdapter } = await import('../../openai-adapter/src/index.js');
+        embedding = new OpenAIEmbeddingAdapter({
+            apiKey: openaiKey,
+            model: 'text-embedding-3-large',
+            dimensions: 3072,
+        });
+        embeddingModel = 'text-embedding-3-large';
+        embeddingDim = 3072;
+    }
+    // Tenant setup
+    const tenantId = process.env.STENO_TENANT_ID || '00000000-0000-0000-0000-000000000001';
+    const scopeId = process.env.STENO_SCOPE_ID || 'default';
+    try {
+        await storage.createTenant({
+            id: tenantId,
+            name: 'Local MCP',
+            slug: `local-mcp-${Date.now()}`,
+            plan: 'enterprise',
+        });
+    }
+    catch {
+        // Tenant already exists
+    }
+    // Create and start MCP server
+    const server = createLocalServer({
+        storage,
+        embedding,
+        cheapLLM,
+        tenantId,
+        scope: 'user',
+        scopeId,
+        embeddingModel,
+        embeddingDim,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=local.js.map

package/dist/local.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Steno from '@steno-ai/sdk';
+export declare function createServer(steno: Steno): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AAwBvC,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CA+HpD"}

package/dist/server.js

@@ -0,0 +1,95 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+export function createServer(steno) {
+    const server = new McpServer({
+        name: 'steno',
+        version: '0.1.0',
+    });
+    server.tool('steno_remember', 'Remember information about a user or topic for future reference', {
+        user_id: z.string().describe('User identifier'),
+        content: z.string().describe('What to remember'),
+    }, async ({ user_id, content }) => {
+        const result = await steno.add(user_id, content);
+        return {
+            content: [
+                { type: 'text', text: `Remembered. Extraction ID: ${result.extractionId}` },
+            ],
+        };
+    });
+    server.tool('steno_recall', 'Recall relevant memories about a user or topic', {
+        user_id: z.string().describe('User identifier'),
+        query: z.string().describe('What to recall'),
+        limit: z.number().optional().describe('Max results (default 5)'),
+    }, async ({ user_id, query, limit }) => {
+        const results = await steno.search(user_id, query, limit ?? 5);
+        if (results.results.length === 0) {
+            return { content: [{ type: 'text', text: 'No memories found.' }] };
+        }
+        const text = results.results
+            .map((r) => {
+            const dateParts = [];
+            if (r.eventDate)
+                dateParts.push(`event: ${new Date(r.eventDate).toISOString().slice(0, 10)}`);
+            if (r.documentDate)
+                dateParts.push(`doc: ${new Date(r.documentDate).toISOString().slice(0, 10)}`);
+            const dateStr = dateParts.length > 0 ? `, ${dateParts.join(', ')}` : '';
+            let line = `[Memory] ${r.content} (score: ${r.score.toFixed(2)}${dateStr})`;
+            if (r.sourceChunk) {
+                line += `\n[Source Context] ${r.sourceChunk}`;
+            }
+            line += '\n---';
+            return line;
+        })
+            .join('\n');
+        return {
+            content: [{ type: 'text', text }],
+        };
+    });
+    server.tool('steno_feedback', 'Rate whether a recalled memory was useful', {
+        fact_id: z.string().describe('Memory ID to rate'),
+        useful: z.boolean().describe('Was this memory useful?'),
+    }, async ({ fact_id, useful }) => {
+        await steno.feedback(fact_id, useful);
+        return {
+            content: [
+                { type: 'text', text: `Feedback recorded: ${useful ? 'positive' : 'negative'}` },
+            ],
+        };
+    });
+    // TODO: Replace raw HTTP calls with steno.profile() / steno.graph.getRelated()
+    // once the SDK is updated with profile and graph support.
+    server.tool('steno_profile', 'Get a structured profile of everything known about a user', {
+        user_id: z.string().describe('User identifier'),
+    }, async ({ user_id }) => {
+        // TODO: Replace with `await steno.profile(user_id)` once SDK supports it
+        const profile = await steno.memory.http.request('GET', `/v1/profile/${encodeURIComponent(user_id)}`);
+        let text = `Profile for ${user_id}:\n\nStatic facts:\n`;
+        text +=
+            (profile.static || []).map((f) => `  - [${f.category}] ${f.content}`).join('\n') ||
+                '  (none)';
+        text += '\n\nDynamic facts:\n';
+        text += (profile.dynamic || []).map((f) => `  - ${f.content}`).join('\n') || '  (none)';
+        return {
+            content: [{ type: 'text', text }],
+        };
+    });
+    server.tool('steno_graph', 'Explore entity relationships in the knowledge graph', {
+        entity_id: z.string().describe('Entity ID to explore'),
+        depth: z.number().optional().describe('Graph traversal depth (default 2)'),
+    }, async ({ entity_id, depth }) => {
+        // TODO: Replace with `await steno.graph.getRelated(entity_id, depth ?? 2)` once SDK supports it
+        const result = await steno.memory.http.request('GET', `/v1/graph/${encodeURIComponent(entity_id)}?depth=${depth ?? 2}`);
+        const entities = result.entities || [];
+        const edges = result.edges || [];
+        let text = `Graph for entity ${entity_id}:\n`;
+        text += `Entities: ${entities.length}\n`;
+        text += entities.map((e) => `  - ${e.name} (${e.entityType})`).join('\n');
+        text += `\nRelationships: ${edges.length}\n`;
+        text += edges.map((e) => `  - ${e.relation}`).join('\n');
+        return {
+            content: [{ type: 'text', text }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@steno-ai/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Claude Code, Claude Desktop, and other MCP clients",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SankrityaT/steno-ai.git",
+    "directory": "packages/mcp-server"
+  },
+  "type": "module",
+  "bin": { "steno-mcp": "./dist/index.js" },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "src", "README.md"],
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1",
+    "@steno-ai/sdk": "workspace:*",
+    "zod": "^3.25"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.7",
+    "vitest": "^3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+export { createServer } from './server.js';
+
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import Steno from '@steno-ai/sdk';
+import { createServer } from './server.js';
+
+async function main(): Promise<void> {
+  const apiKey = process.env.STENO_API_KEY;
+  if (!apiKey) {
+    console.error(
+      'Error: STENO_API_KEY environment variable is required.\n\n' +
+        'Set it before running:\n' +
+        '  export STENO_API_KEY=sk_steno_...\n\n' +
+        'Or pass it inline:\n' +
+        '  STENO_API_KEY=sk_steno_... npx @steno-ai/mcp',
+    );
+    process.exit(1);
+  }
+
+  const steno = new Steno(apiKey);
+  const server = createServer(steno);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/src/local-server.ts

@@ -0,0 +1,381 @@
+/**
+ * Local MCP server — connects directly to Supabase + engine.
+ * No API deployment needed. Just set env vars and go.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { StorageAdapter } from '../../engine/src/adapters/storage.js';
+import type { EmbeddingAdapter } from '../../engine/src/adapters/embedding.js';
+import type { LLMAdapter } from '../../engine/src/adapters/llm.js';
+
+export interface LocalServerConfig {
+  storage: StorageAdapter;
+  embedding: EmbeddingAdapter;
+  cheapLLM: LLMAdapter;
+  tenantId: string;
+  scope: 'user' | 'agent' | 'session' | 'hive';
+  scopeId: string;
+  embeddingModel: string;
+  embeddingDim: number;
+  domainEntityTypes?: import('../../engine/src/config.js').DomainEntityType[];
+}
+
+// ---------------------------------------------------------------------------
+// Session buffer types
+// ---------------------------------------------------------------------------
+interface SessionBuffer {
+  sessionId: string;
+  messages: string[];
+  lastActivity: Date;
+  flushTimer: ReturnType<typeof setTimeout> | null;
+}
+
+const FLUSH_DELAY_MS = 30_000; // 30 seconds of inactivity triggers flush
+const MAX_BUFFER_SIZE = 5;     // flush after 5 messages
+
+// In-memory embedding cache — survives across tool calls within the same MCP session
+let _embeddingCache: Map<string, { embedding: number[]; ts: number }> | null = null;
+function getEmbeddingCache() {
+  if (!_embeddingCache) _embeddingCache = new Map();
+  return _embeddingCache;
+}
+
+/** Simple cache adapter that wraps a Map for embedding caching */
+const embeddingCacheAdapter = {
+  async get<T>(key: string): Promise<T | null> {
+    const cache = getEmbeddingCache();
+    const entry = cache.get(key);
+    if (!entry) return null;
+    // TTL: 10 minutes
+    if (Date.now() - entry.ts > 600_000) {
+      cache.delete(key);
+      return null;
+    }
+    return entry.embedding as unknown as T;
+  },
+  async set<T>(key: string, value: T): Promise<void> {
+    const cache = getEmbeddingCache();
+    cache.set(key, { embedding: value as unknown as number[], ts: Date.now() });
+    // Evict old entries if cache grows too large (>500 entries)
+    if (cache.size > 500) {
+      const oldest = [...cache.entries()].sort((a, b) => a[1].ts - b[1].ts).slice(0, 100);
+      for (const [k] of oldest) cache.delete(k);
+    }
+  },
+  async del(key: string): Promise<void> { getEmbeddingCache().delete(key); },
+  async incr(): Promise<number> { return 0; },
+  async expire(): Promise<void> {},
+  async ping(): Promise<boolean> { return true; },
+};
+
+export function createLocalServer(config: LocalServerConfig): McpServer {
+  const server = new McpServer({
+    name: 'steno-local',
+    version: '0.1.0',
+    instructions: `You have access to the user's persistent long-term memory via Steno.
+
+CRITICAL RULES:
+1. ALWAYS call steno_recall BEFORE answering ANY question about the user, their life, work, projects, people they know, preferences, past events, companies, or decisions. Do this BEFORE using web search or "Relevant chats".
+2. When the user shares personal information, experiences, opinions, or decisions, call steno_remember to store it.
+3. Never say "I don't have information about that" without first checking steno_recall.
+4. Steno memory persists across ALL conversations — it knows things from past sessions that your conversation history does not.`,
+  });
+
+  // Lazy import to avoid loading heavy modules at startup
+  let _search: typeof import('../../engine/src/retrieval/search.js').search | null = null;
+  let _pipeline: typeof import('../../engine/src/extraction/pipeline.js').runExtractionPipeline | null = null;
+  let _getOrCreateActiveSession: typeof import('../../engine/src/sessions/manager.js').getOrCreateActiveSession | null = null;
+
+  async function getSearch() {
+    if (!_search) {
+      const mod = await import('../../engine/src/retrieval/search.js');
+      _search = mod.search;
+    }
+    return _search;
+  }
+
+  async function getPipeline() {
+    if (!_pipeline) {
+      const mod = await import('../../engine/src/extraction/pipeline.js');
+      _pipeline = mod.runExtractionPipeline;
+    }
+    return _pipeline;
+  }
+
+  async function getSessionManager() {
+    if (!_getOrCreateActiveSession) {
+      const mod = await import('../../engine/src/sessions/manager.js');
+      _getOrCreateActiveSession = mod.getOrCreateActiveSession;
+    }
+    return _getOrCreateActiveSession;
+  }
+
+  // ---------------------------------------------------------------------------
+  // Session buffer — accumulate messages, flush periodically
+  // ---------------------------------------------------------------------------
+  const sessionBuffers = new Map<string, SessionBuffer>();
+
+  /** Build a buffer key from scope parameters */
+  function bufferKey(): string {
+    return `${config.tenantId}:${config.scope}:${config.scopeId}`;
+  }
+
+  /** Flush the session buffer: run extraction pipeline on all accumulated messages */
+  async function flushBuffer(key: string): Promise<void> {
+    const buf = sessionBuffers.get(key);
+    if (!buf || buf.messages.length === 0) return;
+
+    // Grab and clear the buffer immediately so new messages start a fresh batch
+    const messages = [...buf.messages];
+    const sessionId = buf.sessionId;
+    buf.messages = [];
+    if (buf.flushTimer) {
+      clearTimeout(buf.flushTimer);
+      buf.flushTimer = null;
+    }
+
+    const fullText = messages.join('\n---\n');
+
+    console.error(`[steno] Flushing session buffer: ${messages.length} messages, sessionId=${sessionId}`);
+
+    try {
+      const runPipeline = await getPipeline();
+      const result = await runPipeline(
+        {
+          storage: config.storage,
+          embedding: config.embedding,
+          cheapLLM: config.cheapLLM,
+          embeddingModel: config.embeddingModel,
+          embeddingDim: config.embeddingDim,
+          extractionTier: 'auto',
+          domainEntityTypes: config.domainEntityTypes,
+        },
+        {
+          tenantId: config.tenantId,
+          scope: config.scope,
+          scopeId: config.scopeId,
+          sessionId,
+          inputType: 'raw_text',
+          data: fullText,
+        },
+      );
+      console.error(`[steno] Session flush done: ${result.factsCreated} facts, ${result.entitiesCreated} entities, ${result.edgesCreated} edges`);
+    } catch (err: any) {
+      console.error('[steno] Session flush pipeline error:', err?.message ?? err);
+    }
+  }
+
+  /** Schedule a flush after the inactivity delay, or flush immediately if buffer is full */
+  function scheduleFlush(key: string): void {
+    const buf = sessionBuffers.get(key);
+    if (!buf) return;
+
+    // Clear any existing timer
+    if (buf.flushTimer) {
+      clearTimeout(buf.flushTimer);
+      buf.flushTimer = null;
+    }
+
+    // Flush immediately if buffer is full
+    if (buf.messages.length >= MAX_BUFFER_SIZE) {
+      void flushBuffer(key);
+      return;
+    }
+
+    // Otherwise schedule a delayed flush
+    buf.flushTimer = setTimeout(() => {
+      void flushBuffer(key);
+    }, FLUSH_DELAY_MS);
+  }
+
+  // ─── REMEMBER ───
+  server.tool(
+    'steno_remember',
+    'Store important information in the user\'s persistent long-term memory. ALWAYS use this to save facts, preferences, decisions, experiences, people, companies, events, or anything the user shares that they might want recalled later. This memory persists across ALL conversations and devices.',
+    {
+      content: z.string().optional().describe('What to remember'),
+      text: z.string().optional().describe('What to remember (alias for content)'),
+    },
+    async (args) => {
+      const memoryText = args.content || args.text;
+      if (!memoryText) {
+        return { content: [{ type: 'text' as const, text: 'Error: provide content or text' }] };
+      }
+
+      // ── Session-based buffering ──
+      // Accumulate messages within a session. Extraction runs when the buffer
+      // is full (MAX_BUFFER_SIZE) or after an inactivity timeout (FLUSH_DELAY_MS).
+      const key = bufferKey();
+      let buf = sessionBuffers.get(key);
+
+      if (!buf) {
+        // Start or resume a session
+        let sessionId: string;
+        try {
+          const getOrCreate = await getSessionManager();
+          // SessionScope excludes 'session', but config.scope might be 'session'.
+          // Treat 'session' scope as 'user' for session tracking purposes.
+          const sessionScope = config.scope === 'session' ? 'user' : config.scope;
+          const session = await getOrCreate(config.storage, config.tenantId, sessionScope as any, config.scopeId);
+          sessionId = session.id;
+        } catch (err: any) {
+          console.error('[steno] Failed to create session, using ephemeral ID:', err?.message ?? err);
+          sessionId = crypto.randomUUID();
+        }
+
+        buf = {
+          sessionId,
+          messages: [],
+          lastActivity: new Date(),
+          flushTimer: null,
+        };
+        sessionBuffers.set(key, buf);
+      }
+
+      // Buffer the message
+      buf.messages.push(memoryText);
+      buf.lastActivity = new Date();
+
+      // ALL messages go through the full pipeline via session buffer (no fast path).
+      // Full pipeline gives us: LLM extraction, entity/edge creation,
+      // contextual embeddings, temporal grounding, dedup — everything.
+      // Returns immediately — extraction happens in the background when flushed.
+      scheduleFlush(key);
+
+      const pending = buf.messages.length;
+      return {
+        content: [{ type: 'text' as const, text: `Buffered (${pending}/${MAX_BUFFER_SIZE} messages in session). Extraction runs on flush.` }],
+      };
+    },
+  );
+
+  // ─── FLUSH ───
+  server.tool(
+    'steno_flush',
+    'Force extraction of all buffered session messages. Use before searching if you just stored information and need it immediately available.',
+    {},
+    async () => {
+      const key = bufferKey();
+      const buf = sessionBuffers.get(key);
+      if (!buf || buf.messages.length === 0) {
+        return { content: [{ type: 'text' as const, text: 'No buffered messages to flush.' }] };
+      }
+      const count = buf.messages.length;
+      await flushBuffer(key);
+      return {
+        content: [{ type: 'text' as const, text: `Flushed ${count} buffered messages. Extraction complete.` }],
+      };
+    },
+  );
+
+  // ─── RECALL ───
+  server.tool(
+    'steno_recall',
+    'ALWAYS search this memory before answering questions about the user, their life, work, projects, preferences, people they know, companies, events, or anything personal. This contains the user\'s persistent memory across all conversations. Search here FIRST before using web search or saying you don\'t know.',
+    {
+      query: z.string().describe('What to search for in memory'),
+      limit: z.number().optional().describe('Max results (default 10)'),
+    },
+    async ({ query, limit }) => {
+      // Auto-flush any pending buffered messages before searching
+      const key = bufferKey();
+      const buf = sessionBuffers.get(key);
+      if (buf && buf.messages.length > 0) {
+        await flushBuffer(key);
+      }
+
+      const searchFn = await getSearch();
+      const results = await searchFn(
+        { storage: config.storage, embedding: config.embedding, cache: embeddingCacheAdapter as any },
+        {
+          query,
+          tenantId: config.tenantId,
+          scope: config.scope,
+          scopeId: config.scopeId,
+          limit: limit ?? 10,
+        },
+      );
+
+      if (results.results.length === 0) {
+        return { content: [{ type: 'text' as const, text: 'No memories found.' }] };
+      }
+
+      const text = results.results
+        .map((r) => {
+          const dateParts: string[] = [];
+          if (r.fact.eventDate) dateParts.push(`event: ${new Date(r.fact.eventDate).toISOString().slice(0, 10)}`);
+          if (r.fact.documentDate) dateParts.push(`doc: ${new Date(r.fact.documentDate).toISOString().slice(0, 10)}`);
+          const dateStr = dateParts.length > 0 ? `, ${dateParts.join(', ')}` : '';
+          const signals = Object.entries(r.signals)
+            .filter(([, v]) => v > 0)
+            .map(([k, v]) => `${k.replace('Score', '')}=${(v as number).toFixed(2)}`)
+            .join(', ');
+          let line = `[Memory] ${r.fact.content} (score: ${r.score.toFixed(2)}${dateStr}${signals ? `, ${signals}` : ''})`;
+          if (r.fact.sourceChunk) {
+            line += `\n[Source Context] ${r.fact.sourceChunk}`;
+          }
+          line += '\n---';
+          return line;
+        })
+        .join('\n');
+
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: `Found ${results.results.length} memories (${results.durationMs}ms):\n\n${text}`,
+          },
+        ],
+      };
+    },
+  );
+
+  // ─── FEEDBACK ───
+  server.tool(
+    'steno_feedback',
+    'Rate whether a recalled memory was useful. Helps improve future recall quality.',
+    {
+      fact_id: z.string().describe('Memory/fact ID to rate'),
+      useful: z.boolean().describe('Was this memory useful?'),
+    },
+    async ({ fact_id, useful }) => {
+      await config.storage.createMemoryAccess({
+        tenantId: config.tenantId,
+        factId: fact_id,
+        query: '',
+        searchRank: 0,
+        feedbackType: useful ? 'explicit_positive' : 'explicit_negative',
+        responseTimeMs: 0,
+      });
+      return {
+        content: [
+          { type: 'text' as const, text: `Feedback recorded: ${useful ? 'positive' : 'negative'}` },
+        ],
+      };
+    },
+  );
+
+  // ─── STATS ───
+  server.tool(
+    'steno_stats',
+    'Get memory statistics — how many facts, entities, and edges are stored.',
+    {},
+    async () => {
+      const facts = await config.storage.getFactsByScope(
+        config.tenantId, config.scope, config.scopeId, { limit: 1 },
+      );
+      const entities = await config.storage.getEntitiesForTenant(config.tenantId, { limit: 1 });
+
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: `Memory stats:\n  Facts: ${facts.hasMore ? '100+' : facts.data.length}\n  Entities: ${entities.hasMore ? '100+' : entities.data.length}`,
+          },
+        ],
+      };
+    },
+  );
+
+  return server;
+}

package/src/local.ts

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * Local Steno MCP server for Claude Code.
+ *
+ * Connects directly to Supabase — no API deployment needed.
+ *
+ * Required env vars:
+ *   SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY
+ *   OPENAI_API_KEY
+ *   PERPLEXITY_API_KEY (optional — falls back to OpenAI embeddings)
+ *
+ * Optional:
+ *   STENO_TENANT_ID (default: auto-created)
+ *   STENO_SCOPE_ID  (default: "default")
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createLocalServer } from './local-server.js';
+
+async function main(): Promise<void> {
+  // Validate required env vars
+  const supabaseUrl = process.env.SUPABASE_URL;
+  const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+  const openaiKey = process.env.OPENAI_API_KEY;
+
+  if (!supabaseUrl || !supabaseKey) {
+    console.error('Error: SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY are required.\n');
+    process.exit(1);
+  }
+  if (!openaiKey) {
+    console.error('Error: OPENAI_API_KEY is required.\n');
+    process.exit(1);
+  }
+
+  // Dynamic imports to avoid loading everything at module level
+  const { createSupabaseClient, SupabaseStorageAdapter } = await import(
+    '../../supabase-adapter/src/index.js'
+  );
+  const { OpenAILLMAdapter } = await import('../../openai-adapter/src/index.js');
+
+  // Set up adapters
+  const supabase = createSupabaseClient({ url: supabaseUrl, serviceRoleKey: supabaseKey });
+  const storage = new SupabaseStorageAdapter(supabase);
+  const cheapLLM = new OpenAILLMAdapter({ apiKey: openaiKey, model: 'gpt-5.4-mini' });
+
+  // Embedding: prefer Perplexity (cheaper, 2000 dims) else OpenAI (3072 dims)
+  let embedding: any;
+  let embeddingModel: string;
+  let embeddingDim: number;
+
+  if (process.env.PERPLEXITY_API_KEY) {
+    const { PerplexityEmbeddingAdapter } = await import(
+      '../../engine/src/adapters/perplexity-embedding.js'
+    );
+    embedding = new PerplexityEmbeddingAdapter({
+      apiKey: process.env.PERPLEXITY_API_KEY,
+      model: 'pplx-embed-v1-4b',
+      dimensions: 2000,
+    });
+    embeddingModel = 'pplx-embed-v1-4b';
+    embeddingDim = 2000;
+  } else {
+    const { OpenAIEmbeddingAdapter } = await import('../../openai-adapter/src/index.js');
+    embedding = new OpenAIEmbeddingAdapter({
+      apiKey: openaiKey,
+      model: 'text-embedding-3-large',
+      dimensions: 3072,
+    });
+    embeddingModel = 'text-embedding-3-large';
+    embeddingDim = 3072;
+  }
+
+  // Tenant setup
+  const tenantId = process.env.STENO_TENANT_ID || '00000000-0000-0000-0000-000000000001';
+  const scopeId = process.env.STENO_SCOPE_ID || 'default';
+
+  try {
+    await storage.createTenant({
+      id: tenantId,
+      name: 'Local MCP',
+      slug: `local-mcp-${Date.now()}`,
+      plan: 'enterprise',
+    });
+  } catch {
+    // Tenant already exists
+  }
+
+  // Create and start MCP server
+  const server = createLocalServer({
+    storage,
+    embedding,
+    cheapLLM,
+    tenantId,
+    scope: 'user',
+    scopeId,
+    embeddingModel,
+    embeddingDim,
+    domainEntityTypes: [
+      {
+        name: 'vehicle',
+        description: 'A car, truck, motorcycle, or other vehicle owned, wanted, or discussed by the user',
+        fields: [
+          { name: 'make', type: 'string' as const, description: 'Manufacturer (Mercedes, BMW, Toyota, etc.)', required: false },
+          { name: 'model', type: 'string' as const, description: 'Model name (E350, M3, Camry, etc.)', required: false },
+          { name: 'year', type: 'string' as const, description: 'Model year', required: false },
+          { name: 'ownership', type: 'string' as const, description: 'owned, wanted, previously_owned, test_driven', required: false },
+        ],
+      },
+      {
+        name: 'startup',
+        description: 'A startup company discussed in context of jobs, investments, partnerships, or competition',
+        fields: [
+          { name: 'stage', type: 'string' as const, description: 'pre-seed, seed, series-a, series-b, growth, public', required: false },
+          { name: 'relationship', type: 'string' as const, description: 'competitor, partner, prospect, employer, rejected', required: false },
+          { name: 'funding', type: 'string' as const, description: 'Known funding amount or status', required: false },
+        ],
+      },
+      {
+        name: 'project',
+        description: 'A software project, product, or side project the user is building or has built',
+        fields: [
+          { name: 'status', type: 'string' as const, description: 'active, paused, completed, abandoned', required: false },
+          { name: 'tech_stack', type: 'string' as const, description: 'Primary technologies used', required: false },
+          { name: 'user_role', type: 'string' as const, description: 'founder, lead, contributor, user', required: false },
+        ],
+      },
+    ],
+  });
+
+  // Handle EPIPE gracefully — Claude Desktop may disconnect mid-response
+  process.stdout.on('error', (err: NodeJS.ErrnoException) => {
+    if (err.code === 'EPIPE') return; // Client disconnected, ignore
+    console.error('[steno] stdout error:', err);
+  });
+  process.stdin.on('error', (err: NodeJS.ErrnoException) => {
+    if (err.code === 'EPIPE') return;
+    console.error('[steno] stdin error:', err);
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/src/server.ts

@@ -0,0 +1,153 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type Steno from '@steno-ai/sdk';
+import { z } from 'zod';
+
+// TODO: Remove these helper types once the SDK exports profile/graph types
+interface ProfileFact {
+  category?: string;
+  content: string;
+}
+interface ProfileResponse {
+  static?: ProfileFact[];
+  dynamic?: ProfileFact[];
+}
+interface GraphEntity {
+  name: string;
+  entityType: string;
+}
+interface GraphEdge {
+  relation: string;
+}
+interface GraphResponse {
+  entities?: GraphEntity[];
+  edges?: GraphEdge[];
+}
+
+export function createServer(steno: Steno): McpServer {
+  const server = new McpServer({
+    name: 'steno',
+    version: '0.1.0',
+  });
+
+  server.tool(
+    'steno_remember',
+    'Remember information about a user or topic for future reference',
+    {
+      user_id: z.string().describe('User identifier'),
+      content: z.string().describe('What to remember'),
+    },
+    async ({ user_id, content }) => {
+      const result = await steno.add(user_id, content);
+      return {
+        content: [
+          { type: 'text' as const, text: `Remembered. Extraction ID: ${result.extractionId}` },
+        ],
+      };
+    },
+  );
+
+  server.tool(
+    'steno_recall',
+    'Recall relevant memories about a user or topic',
+    {
+      user_id: z.string().describe('User identifier'),
+      query: z.string().describe('What to recall'),
+      limit: z.number().optional().describe('Max results (default 5)'),
+    },
+    async ({ user_id, query, limit }) => {
+      const results = await steno.search(user_id, query, limit ?? 5);
+      if (results.results.length === 0) {
+        return { content: [{ type: 'text' as const, text: 'No memories found.' }] };
+      }
+      const text = results.results
+        .map((r: any) => {
+          const dateParts: string[] = [];
+          if (r.eventDate) dateParts.push(`event: ${new Date(r.eventDate).toISOString().slice(0, 10)}`);
+          if (r.documentDate) dateParts.push(`doc: ${new Date(r.documentDate).toISOString().slice(0, 10)}`);
+          const dateStr = dateParts.length > 0 ? `, ${dateParts.join(', ')}` : '';
+          let line = `[Memory] ${r.content} (score: ${r.score.toFixed(2)}${dateStr})`;
+          if (r.sourceChunk) {
+            line += `\n[Source Context] ${r.sourceChunk}`;
+          }
+          line += '\n---';
+          return line;
+        })
+        .join('\n');
+      return {
+        content: [{ type: 'text' as const, text }],
+      };
+    },
+  );
+
+  server.tool(
+    'steno_feedback',
+    'Rate whether a recalled memory was useful',
+    {
+      fact_id: z.string().describe('Memory ID to rate'),
+      useful: z.boolean().describe('Was this memory useful?'),
+    },
+    async ({ fact_id, useful }) => {
+      await steno.feedback(fact_id, useful);
+      return {
+        content: [
+          { type: 'text' as const, text: `Feedback recorded: ${useful ? 'positive' : 'negative'}` },
+        ],
+      };
+    },
+  );
+
+  // TODO: Replace raw HTTP calls with steno.profile() / steno.graph.getRelated()
+  // once the SDK is updated with profile and graph support.
+
+  server.tool(
+    'steno_profile',
+    'Get a structured profile of everything known about a user',
+    {
+      user_id: z.string().describe('User identifier'),
+    },
+    async ({ user_id }) => {
+      // TODO: Replace with `await steno.profile(user_id)` once SDK supports it
+      const profile = await (steno as any).memory.http.request(
+        'GET',
+        `/v1/profile/${encodeURIComponent(user_id)}`,
+      ) as ProfileResponse;
+      let text = `Profile for ${user_id}:\n\nStatic facts:\n`;
+      text +=
+        (profile.static || []).map((f: ProfileFact) => `  - [${f.category}] ${f.content}`).join('\n') ||
+        '  (none)';
+      text += '\n\nDynamic facts:\n';
+      text += (profile.dynamic || []).map((f: ProfileFact) => `  - ${f.content}`).join('\n') || '  (none)';
+      return {
+        content: [{ type: 'text' as const, text }],
+      };
+    },
+  );
+
+  server.tool(
+    'steno_graph',
+    'Explore entity relationships in the knowledge graph',
+    {
+      entity_id: z.string().describe('Entity ID to explore'),
+      depth: z.number().optional().describe('Graph traversal depth (default 2)'),
+    },
+    async ({ entity_id, depth }) => {
+      // TODO: Replace with `await steno.graph.getRelated(entity_id, depth ?? 2)` once SDK supports it
+      const result = await (steno as any).memory.http.request(
+        'GET',
+        `/v1/graph/${encodeURIComponent(entity_id)}?depth=${depth ?? 2}`,
+      ) as GraphResponse;
+      const entities = result.entities || [];
+      const edges = result.edges || [];
+      let text = `Graph for entity ${entity_id}:\n`;
+      text += `Entities: ${entities.length}\n`;
+      text += entities.map((e: GraphEntity) => `  - ${e.name} (${e.entityType})`).join('\n');
+      text += `\nRelationships: ${edges.length}\n`;
+      text += edges.map((e: GraphEdge) => `  - ${e.relation}`).join('\n');
+      return {
+        content: [{ type: 'text' as const, text }],
+      };
+    },
+  );
+
+  return server;
+}