@unclick/mcp-server 0.2.4 → 0.3.0

package/dist/runway-tool.js

@@ -0,0 +1,110 @@
+// Runway ML API integration for the UnClick MCP server.
+// Uses the Runway REST API via fetch - no external dependencies.
+// Users must supply an API key from app.runwayml.com/account/api-keys.
+const RW_API_BASE = "https://api.dev.runwayml.com/v1";
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at app.runwayml.com/account/api-keys.");
+    return key;
+}
+// ─── API helpers ──────────────────────────────────────────────────────────────
+async function rwGet(apiKey, path) {
+    const res = await fetch(`${RW_API_BASE}${path}`, {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            "X-Runway-Version": "2024-11-06",
+        },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`Runway error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+async function rwPost(apiKey, path, body) {
+    const res = await fetch(`${RW_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            "X-Runway-Version": "2024-11-06",
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`Runway error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function runway_generate_video(args) {
+    const apiKey = requireKey(args);
+    const promptText = String(args.prompt ?? "").trim();
+    const imageUrl = args.image_url ? String(args.image_url).trim() : undefined;
+    if (!promptText && !imageUrl) {
+        throw new Error("Either prompt (text description) or image_url is required.");
+    }
+    const model = String(args.model ?? "gen3a_turbo");
+    const duration = Number(args.duration ?? 5);
+    const ratio = String(args.ratio ?? "1280:768");
+    // Runway supports image_to_video (with promptImage) or text_to_video
+    const body = {
+        model,
+        ratio,
+        duration,
+    };
+    if (imageUrl) {
+        body.promptImage = imageUrl;
+        if (promptText)
+            body.promptText = promptText;
+    }
+    else {
+        body.promptText = promptText;
+    }
+    if (args.seed !== undefined)
+        body.seed = Number(args.seed);
+    const result = await rwPost(apiKey, "/image_to_video", body);
+    return {
+        task_id: result.id ?? null,
+        status: result.status ?? "submitted",
+        model,
+        note: "Use runway_get_task with the task_id to poll for completion.",
+        raw: result,
+    };
+}
+export async function runway_get_task(args) {
+    const apiKey = requireKey(args);
+    const taskId = String(args.task_id ?? "").trim();
+    if (!taskId)
+        throw new Error("task_id is required.");
+    const result = await rwGet(apiKey, `/tasks/${encodeURIComponent(taskId)}`);
+    const output = result.output;
+    return {
+        task_id: taskId,
+        status: result.status ?? null,
+        progress: result.progress ?? null,
+        video_url: Array.isArray(output) && output.length > 0 ? output[0] : null,
+        outputs: output ?? [],
+        failure: result.failure ?? null,
+        failure_code: result.failureCode ?? null,
+        created_at: result.createdAt ?? null,
+        raw: result,
+    };
+}
+export async function runway_list_models(args) {
+    const apiKey = requireKey(args);
+    const data = await rwGet(apiKey, "/models");
+    const models = data.data ?? data.models ?? [];
+    return {
+        count: Array.isArray(models) ? models.length : 0,
+        models,
+        note: "Common models: gen3a_turbo (fast), gen3a (quality). Use model name in runway_generate_video.",
+    };
+}
+//# sourceMappingURL=runway-tool.js.map

package/dist/runway-tool.js.map

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

package/dist/segment-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function segment_track_event(args: Record<string, unknown>): Promise<unknown>;
+export declare function segment_identify_user(args: Record<string, unknown>): Promise<unknown>;
+export declare function segment_list_sources(args: Record<string, unknown>): Promise<unknown>;
+export declare function segment_list_destinations(args: Record<string, unknown>): Promise<unknown>;
+export declare function segment_get_source(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=segment-tool.d.ts.map

package/dist/segment-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-tool.d.ts","sourceRoot":"","sources":["../src/segment-tool.ts"],"names":[],"mappings":"AA8DA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBzF;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB3F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1F;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAU/F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CASxF"}

package/dist/segment-tool.js

@@ -0,0 +1,129 @@
+// Segment Customer Data Platform API.
+// Docs: https://segment.com/docs/connections/sources/catalog/libraries/server/http-api/
+//       https://docs.segmentapis.com/
+// Auth: write_key (Basic auth, base64 encoded) for tracking; api_token (Bearer) for management
+// Base: https://api.segment.io/v1 (tracking) / https://api.segmentapis.com (management)
+const SEGMENT_TRACK_BASE = "https://api.segment.io/v1";
+const SEGMENT_MGMT_BASE = "https://api.segmentapis.com";
+function requireWriteKey(args) {
+    const key = String(args.write_key ?? args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("write_key is required. Get one from your Segment source settings.");
+    return key;
+}
+function requireApiToken(args) {
+    const token = String(args.api_token ?? args.api_key ?? "").trim();
+    if (!token)
+        throw new Error("api_token is required. Get one from app.segment.com/goto-my-workspace/settings/access-management.");
+    return token;
+}
+async function segmentTrackPost(writeKey, path, body) {
+    const encoded = Buffer.from(`${writeKey}:`).toString("base64");
+    const res = await fetch(`${SEGMENT_TRACK_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Basic ${encoded}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Segment tracking error (${res.status}): ${text || res.statusText}`);
+    }
+    return res.json();
+}
+async function segmentMgmtGet(apiToken, path, query) {
+    const url = new URL(`${SEGMENT_MGMT_BASE}${path}`);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== "")
+                url.searchParams.set(k, v);
+        }
+    }
+    const res = await fetch(url.toString(), {
+        headers: {
+            Authorization: `Bearer ${apiToken}`,
+            "Content-Type": "application/json",
+        },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const err = data.errors?.[0];
+        const msg = err?.message ?? `HTTP ${res.status}`;
+        throw new Error(`Segment management error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function segment_track_event(args) {
+    const writeKey = requireWriteKey(args);
+    const event = String(args.event ?? "").trim();
+    const userId = String(args.user_id ?? "").trim();
+    const anonymousId = String(args.anonymous_id ?? "").trim();
+    if (!event)
+        throw new Error("event is required.");
+    if (!userId && !anonymousId)
+        throw new Error("user_id or anonymous_id is required.");
+    const body = {
+        event,
+        timestamp: args.timestamp ?? new Date().toISOString(),
+    };
+    if (userId)
+        body.userId = userId;
+    if (anonymousId)
+        body.anonymousId = anonymousId;
+    if (args.properties && typeof args.properties === "object")
+        body.properties = args.properties;
+    if (args.context && typeof args.context === "object")
+        body.context = args.context;
+    const data = await segmentTrackPost(writeKey, "/track", body);
+    return { success: true, raw: data };
+}
+export async function segment_identify_user(args) {
+    const writeKey = requireWriteKey(args);
+    const userId = String(args.user_id ?? "").trim();
+    const anonymousId = String(args.anonymous_id ?? "").trim();
+    if (!userId && !anonymousId)
+        throw new Error("user_id or anonymous_id is required.");
+    const body = {
+        timestamp: args.timestamp ?? new Date().toISOString(),
+    };
+    if (userId)
+        body.userId = userId;
+    if (anonymousId)
+        body.anonymousId = anonymousId;
+    if (args.traits && typeof args.traits === "object")
+        body.traits = args.traits;
+    if (args.context && typeof args.context === "object")
+        body.context = args.context;
+    const data = await segmentTrackPost(writeKey, "/identify", body);
+    return { success: true, raw: data };
+}
+export async function segment_list_sources(args) {
+    const apiToken = requireApiToken(args);
+    const workspaceId = String(args.workspace_id ?? "").trim();
+    if (!workspaceId)
+        throw new Error("workspace_id is required.");
+    const data = await segmentMgmtGet(apiToken, `/workspaces/${workspaceId}/sources`);
+    const sources = data.data?.sources ?? [];
+    return { count: sources.length, sources };
+}
+export async function segment_list_destinations(args) {
+    const apiToken = requireApiToken(args);
+    const sourceId = String(args.source_id ?? "").trim();
+    if (!sourceId)
+        throw new Error("source_id is required.");
+    const data = await segmentMgmtGet(apiToken, `/sources/${sourceId}/destinations`);
+    const destinations = data.data?.destinations ?? [];
+    return { count: destinations.length, destinations };
+}
+export async function segment_get_source(args) {
+    const apiToken = requireApiToken(args);
+    const sourceId = String(args.source_id ?? "").trim();
+    if (!sourceId)
+        throw new Error("source_id is required.");
+    const data = await segmentMgmtGet(apiToken, `/sources/${sourceId}`);
+    return data.data?.source ?? data;
+}
+//# sourceMappingURL=segment-tool.js.map

package/dist/segment-tool.js.map

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

package/dist/sendgrid-tool.d.ts

@@ -0,0 +1,7 @@
+export declare function sendgridSendEmail(args: Record<string, unknown>): Promise<unknown>;
+export declare function sendgridListTemplates(args: Record<string, unknown>): Promise<unknown>;
+export declare function sendgridGetTemplate(args: Record<string, unknown>): Promise<unknown>;
+export declare function sendgridListContacts(args: Record<string, unknown>): Promise<unknown>;
+export declare function sendgridAddContact(args: Record<string, unknown>): Promise<unknown>;
+export declare function sendgridGetStats(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=sendgrid-tool.d.ts.map

package/dist/sendgrid-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgrid-tool.d.ts","sourceRoot":"","sources":["../src/sendgrid-tool.ts"],"names":[],"mappings":"AAmDA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBvF;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK3F;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAKzF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAcxF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtF"}

package/dist/sendgrid-tool.js

@@ -0,0 +1,124 @@
+// SendGrid v3 API integration for the UnClick MCP server.
+// Uses the SendGrid REST API via fetch - no external dependencies.
+// Users must supply an API key from app.sendgrid.com.
+const SG_BASE = "https://api.sendgrid.com/v3";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at app.sendgrid.com/settings/api-keys.");
+    return key;
+}
+async function sgGet(apiKey, path, params) {
+    const url = new URL(`${SG_BASE}${path}`);
+    if (params)
+        Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    const res = await fetch(url.toString(), {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (res.status === 204)
+        return {};
+    const data = await res.json();
+    if (!res.ok) {
+        const errs = data.errors;
+        const msg = errs?.[0]?.message ?? `HTTP ${res.status}`;
+        throw new Error(`SendGrid error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+async function sgPost(apiKey, path, body) {
+    const res = await fetch(`${SG_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (res.status === 202 || res.status === 204)
+        return { success: true, status: res.status };
+    const data = await res.json();
+    if (!res.ok) {
+        const errs = data.errors;
+        const msg = errs?.[0]?.message ?? `HTTP ${res.status}`;
+        throw new Error(`SendGrid error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function sendgridSendEmail(args) {
+    const apiKey = requireKey(args);
+    const to = String(args.to ?? "").trim();
+    const from = String(args.from ?? "").trim();
+    const subject = String(args.subject ?? "").trim();
+    if (!to)
+        throw new Error("to is required (recipient email address).");
+    if (!from)
+        throw new Error("from is required (sender email address).");
+    if (!subject)
+        throw new Error("subject is required.");
+    if (!args.text && !args.html)
+        throw new Error("Either text or html content is required.");
+    const content = [];
+    if (args.text)
+        content.push({ type: "text/plain", value: String(args.text) });
+    if (args.html)
+        content.push({ type: "text/html", value: String(args.html) });
+    const body = {
+        personalizations: [{ to: [{ email: to, name: args.to_name ? String(args.to_name) : undefined }] }],
+        from: { email: from, name: args.from_name ? String(args.from_name) : undefined },
+        subject,
+        content,
+    };
+    if (args.template_id)
+        body.template_id = String(args.template_id);
+    if (args.reply_to)
+        body.reply_to = { email: String(args.reply_to) };
+    return sgPost(apiKey, "/mail/send", body);
+}
+export async function sendgridListTemplates(args) {
+    const apiKey = requireKey(args);
+    const params = { generations: "dynamic" };
+    if (args.page_size)
+        params.page_size = String(Math.min(200, Math.max(1, Number(args.page_size))));
+    return sgGet(apiKey, "/templates", params);
+}
+export async function sendgridGetTemplate(args) {
+    const apiKey = requireKey(args);
+    const id = String(args.template_id ?? "").trim();
+    if (!id)
+        throw new Error("template_id is required.");
+    return sgGet(apiKey, `/templates/${encodeURIComponent(id)}`);
+}
+export async function sendgridListContacts(args) {
+    const apiKey = requireKey(args);
+    return sgGet(apiKey, "/marketing/contacts");
+}
+export async function sendgridAddContact(args) {
+    const apiKey = requireKey(args);
+    const email = String(args.email ?? "").trim();
+    if (!email)
+        throw new Error("email is required.");
+    const contact = { email };
+    if (args.first_name)
+        contact.first_name = String(args.first_name);
+    if (args.last_name)
+        contact.last_name = String(args.last_name);
+    if (args.phone_number)
+        contact.phone_number = String(args.phone_number);
+    const body = { contacts: [contact] };
+    if (args.list_ids)
+        body.list_ids = args.list_ids;
+    return sgPost(apiKey, "/marketing/contacts", body);
+}
+export async function sendgridGetStats(args) {
+    const apiKey = requireKey(args);
+    const startDate = String(args.start_date ?? new Date(Date.now() - 7 * 86400000).toISOString().split("T")[0]);
+    const params = { start_date: startDate };
+    if (args.end_date)
+        params.end_date = String(args.end_date);
+    if (args.aggregated_by)
+        params.aggregated_by = String(args.aggregated_by);
+    return sgGet(apiKey, "/stats", params);
+}
+//# sourceMappingURL=sendgrid-tool.js.map

package/dist/sendgrid-tool.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA4fnE,wBAAgB,YAAY,IAAI,MAAM,CA6MrC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA8lBnE,wBAAgB,YAAY,IAAI,MAAM,CAqPrC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}

package/dist/server.js

@@ -4,6 +4,8 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 import { CATALOG, TOOL_MAP, ENDPOINT_MAP } from "./catalog.js";
 import { createClient } from "./client.js";
 import { ADDITIONAL_HANDLERS } from "./tool-wiring.js";
+import { LOCAL_CATALOG_HANDLERS } from "./local-catalog-handlers.js";
+import { MEMORY_HANDLERS } from "./memory/handlers.js";
 // ─── Search helper ──────────────────────────────────────────────────────────
 function searchTools(query, category) {
     const q = query.toLowerCase();
@@ -104,6 +106,97 @@ const META_TOOLS = [
             required: ["endpoint_id", "params"],
         },
     },
+    // ── UnClick Memory (persistent cross-session memory) ─────────────────────
+    // These 5 tools implement the session-start / session-end protocol agents
+    // should follow. The other 12 memory operations are available via unclick_call
+    // with endpoint_id like "memory.add_fact", "memory.search_memory", etc.
+    {
+        name: "get_startup_context",
+        description: "Load persistent UnClick Memory at session start. Returns business context (standing rules), " +
+            "recent session summaries, and hot facts. Call this FIRST in every new session to understand " +
+            "the user's ongoing projects, preferences, and open loops. Works zero-config locally, or with " +
+            "Supabase for cross-machine sync.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                num_sessions: {
+                    type: "number",
+                    description: "Number of recent session summaries to load (1-20, default 5)",
+                    default: 5,
+                },
+            },
+        },
+    },
+    {
+        name: "write_session_summary",
+        description: "Write a session summary at the end of a session. Critical for cross-session continuity. " +
+            "Call this BEFORE the session ends (when the user says goodbye, or context is running low). " +
+            "Include key decisions, open loops, and topics discussed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Unique session identifier (timestamp or UUID)" },
+                summary: { type: "string", description: "Narrative of what happened - decisions, work completed, problems solved" },
+                topics: { type: "array", items: { type: "string" }, description: "Topic tags for searchability" },
+                open_loops: { type: "array", items: { type: "string" }, description: "Unfinished tasks or questions to carry forward" },
+                decisions: { type: "array", items: { type: "string" }, description: "Key decisions made during the session" },
+                platform: { type: "string", description: "Platform this session ran on", default: "claude-code" },
+                duration_minutes: { type: "number", description: "Approximate session duration" },
+            },
+            required: ["session_id", "summary"],
+        },
+    },
+    {
+        name: "add_fact",
+        description: "Add a new atomic fact to UnClick Memory. One fact = one statement. " +
+            "Use when the user states a preference, makes a decision, or shares important info. " +
+            "Good: 'Team prefers Tailwind over CSS modules'. Bad: 'We talked about styling'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fact: { type: "string", description: "The fact - a single atomic statement" },
+                category: {
+                    type: "string",
+                    description: "Category: preference, decision, technical, contact, project, general",
+                    default: "general",
+                },
+                confidence: { type: "number", minimum: 0, maximum: 1, default: 0.9 },
+                source_session_id: { type: "string", description: "Session ID where this fact was learned" },
+            },
+            required: ["fact"],
+        },
+    },
+    {
+        name: "search_memory",
+        description: "Full-text search across UnClick Memory conversation logs. Use when you need to recall " +
+            "something specific from a previous session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                max_results: { type: "number", minimum: 1, maximum: 50, default: 10 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "set_business_context",
+        description: "Add or update a standing rule in UnClick Memory (Layer 1). Business context is ALWAYS loaded " +
+            "at session start. Use for standing rules, client info, and preferences that are always relevant.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    description: "Category: identity, preference, client, workflow, technical, standing_rule",
+                },
+                key: { type: "string", description: "Unique key within category (e.g. 'timezone', 'preferred_stack')" },
+                value: { type: "string", description: "The value to store (plain text or JSON string)" },
+                priority: { type: "number", description: "Priority for loading order (higher = loaded first)" },
+            },
+            required: ["category", "key", "value"],
+        },
+    },
 ];
 const DIRECT_TOOLS = [
     {
@@ -467,6 +560,13 @@ export function createServer() {
         const { name, arguments: rawArgs } = request.params;
         const args = (rawArgs ?? {});
         try {
+            // ── UnClick Memory (direct tools + memory.* endpoints) ───────
+            if (MEMORY_HANDLERS[name]) {
+                const result = await MEMORY_HANDLERS[name](args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                };
+            }
             // ── Meta tools ──────────────────────────────────────────────
             if (name === "unclick_search") {
                 const results = searchTools(String(args.query ?? ""), args.category);
@@ -556,6 +656,25 @@ export function createServer() {
             if (name === "unclick_call") {
                 const endpointId = String(args.endpoint_id ?? "");
                 const params = (args.params ?? {});
+                // Memory endpoints: "memory.add_fact", "memory.store_code", etc.
+                if (endpointId.startsWith("memory.")) {
+                    const op = endpointId.slice("memory.".length);
+                    const memHandler = MEMORY_HANDLERS[op];
+                    if (memHandler) {
+                        const result = await memHandler(params);
+                        return {
+                            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                        };
+                    }
+                }
+                // Check local handlers first (avoids remote API dependency)
+                const localHandler = LOCAL_CATALOG_HANDLERS[endpointId];
+                if (localHandler) {
+                    const result = await localHandler(params);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    };
+                }
                 const entry = ENDPOINT_MAP.get(endpointId);
                 if (!entry) {
                     return {
@@ -568,6 +687,16 @@ export function createServer() {
                         isError: true,
                     };
                 }
+                // Try ADDITIONAL_HANDLERS via dot-to-underscore key conversion ("foo.bar" -> "foo_bar")
+                const handlerKey = endpointId.replace(/\./g, "_");
+                const additionalHandler = ADDITIONAL_HANDLERS[handlerKey];
+                if (additionalHandler) {
+                    const result = await additionalHandler(params);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                // Fall back to remote API for endpoints without local implementations
                 const client = createClient();
                 const result = await client.call(entry.endpoint.method, entry.endpoint.path, params);
                 return {