take-blip-mcp 0.1.0

package/dist/tools/index.js

@@ -0,0 +1,32 @@
+import { registerContactTools } from "./contacts.js";
+import { registerBucketTools } from "./buckets.js";
+import { registerBroadcastTools } from "./broadcast.js";
+import { registerScheduleTools } from "./schedules.js";
+import { registerAiTools } from "./ai.js";
+import { registerMessageTools } from "./messages.js";
+import { registerCommandTool } from "./command.js";
+import { registerContextTools } from "./context.js";
+import { registerThreadTools } from "./threads.js";
+import { registerFlowTools } from "./flow.js";
+import { registerEventTools } from "./events.js";
+import { registerFlowMapTools } from "./flow-tools.js";
+export function registerAllTools(ctx) {
+    // Contacts & storage
+    registerContactTools(ctx);
+    registerBucketTools(ctx);
+    // Conversation & journey debugging
+    registerThreadTools(ctx);
+    registerContextTools(ctx);
+    registerFlowTools(ctx);
+    registerEventTools(ctx);
+    // Flow mapping / multi-flow
+    registerFlowMapTools(ctx);
+    // Reach & automation
+    registerBroadcastTools(ctx);
+    registerScheduleTools(ctx);
+    registerAiTools(ctx);
+    registerMessageTools(ctx);
+    // Generic escape hatch
+    registerCommandTool(ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIvD,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,qBAAqB;IACrB,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,mCAAmC;IACnC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvB,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,4BAA4B;IAC5B,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,qBAAqB;IACrB,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5B,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3B,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,uBAAuB;IACvB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/tools/messages.d.ts

@@ -0,0 +1,3 @@
+import { type ToolContext } from "./shared.js";
+export declare function registerMessageTools(ctx: ToolContext): void;
+//# sourceMappingURL=messages.d.ts.map

package/dist/tools/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAgC3D"}

package/dist/tools/messages.js

@@ -0,0 +1,31 @@
+/** Message-sending tool (WRITE / SIDE EFFECT). */
+import { z } from "zod";
+import { attempt, jsonResult, readOnlyNotice } from "./shared.js";
+export function registerMessageTools(ctx) {
+    const { server, client, config } = ctx;
+    server.registerTool("blip_send_message", {
+        title: "Send a message to a real recipient",
+        description: "WRITE / SIDE EFFECT: sends a message that REACHES A REAL USER on a real channel " +
+            "(e.g. 5511999999999@wa.gw.msging.net). Use with care. Requires BLIP_ALLOW_WRITES=true.",
+        inputSchema: {
+            to: z
+                .string()
+                .min(1)
+                .describe("Recipient identity, e.g. 5511999999999@wa.gw.msging.net."),
+            content: z
+                .union([z.string(), z.record(z.string(), z.unknown())])
+                .describe("Message content: a string for text/plain, or an object for rich types."),
+            type: z
+                .string()
+                .default("text/plain")
+                .describe("Content MIME type. Defaults to text/plain."),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
+    }, async (args) => attempt(ctx, async () => {
+        if (!config.allowWrites)
+            return readOnlyNotice(`send a ${args.type} message to ${args.to}`);
+        const res = await client.sendMessage({ to: args.to, content: args.content, type: args.type });
+        return jsonResult(res);
+    }));
+}
+//# sourceMappingURL=messages.js.map

package/dist/tools/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,oBAAoB,CAAC,GAAgB;IACnD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEvC,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,kFAAkF;YAClF,wFAAwF;QAC1F,WAAW,EAAE;YACX,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,0DAA0D,CAAC;YACvE,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;iBACtD,QAAQ,CAAC,wEAAwE,CAAC;YACrF,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,OAAO,CAAC,YAAY,CAAC;iBACrB,QAAQ,CAAC,4CAA4C,CAAC;SAC1D;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;KACxG,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,cAAc,CAAC,UAAU,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5F,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/schedules.d.ts

@@ -0,0 +1,3 @@
+import { type ToolContext } from "./shared.js";
+export declare function registerScheduleTools(ctx: ToolContext): void;
+//# sourceMappingURL=schedules.d.ts.map

package/dist/tools/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/tools/schedules.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIpF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAuB5D"}

package/dist/tools/schedules.js

@@ -0,0 +1,25 @@
+/**
+ * Scheduler tools (EXPERIMENTAL, read-only).
+ * Target postmaster: postmaster@scheduler.msging.net
+ */
+import { z } from "zod";
+import { attempt, buildListQuery, jsonResult } from "./shared.js";
+const SCHEDULER = "postmaster@scheduler.msging.net";
+export function registerScheduleTools(ctx) {
+    const { server, client } = ctx;
+    server.registerTool("blip_list_schedules", {
+        title: "List scheduled messages (experimental)",
+        description: "EXPERIMENTAL. List scheduled messages/commands. Read-only. " +
+            "If it fails for your account, use blip_command against the scheduler postmaster.",
+        inputSchema: {
+            skip: z.number().int().min(0).default(0).describe("Pagination offset."),
+            take: z.number().int().min(1).max(100).default(20).describe("Items to return (1-100)."),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (args) => attempt(ctx, async () => {
+        const uri = `/schedules?${buildListQuery(args.skip, args.take)}`;
+        const res = await client.sendCommand({ method: "get", to: SCHEDULER, uri });
+        return jsonResult(res.resource ?? res);
+    }));
+}
+//# sourceMappingURL=schedules.js.map

package/dist/tools/schedules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../src/tools/schedules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAEpF,MAAM,SAAS,GAAG,iCAAiC,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,GAAgB;IACpD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE/B,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,wCAAwC;QAC/C,WAAW,EACT,6DAA6D;YAC7D,kFAAkF;QACpF,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACxF;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACtB,MAAM,GAAG,GAAG,cAAc,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5E,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IACzC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/shared.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared helpers and types for tool modules.
+ *
+ * Conventions:
+ *   - Every tool handler runs inside {@link attempt}, which converts thrown
+ *     errors into a redacted `isError` result (no secret ever escapes).
+ *   - Read tools set `annotations.readOnlyHint`.
+ *   - Write tools check {@link ToolContext.config}.allowWrites and, when off,
+ *     return {@link readOnlyNotice} WITHOUT touching the network.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BlipClient } from "../blip-client.js";
+import type { BlipConfig, FlowCredential } from "../config.js";
+import type { Logger } from "../logger.js";
+export interface ToolContext {
+    server: McpServer;
+    /** Client for the default flow. */
+    client: BlipClient;
+    /** Get (cached) a client for a named flow; default flow when omitted. */
+    getClient: (flowName?: string) => BlipClient;
+    config: BlipConfig;
+    flows: FlowCredential[];
+    flowsDir: string;
+    logger: Logger;
+    /** Secrets to scrub from any text returned to the model. */
+    secrets: string[];
+}
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+export declare function textResult(text: string): ToolResult;
+export declare function jsonResult(data: unknown): ToolResult;
+/** Friendly, non-error notice returned when a write is blocked by the guardrail. */
+export declare function readOnlyNotice(attemptedAction: string): ToolResult;
+export declare function errorResult(err: unknown, secrets: string[]): ToolResult;
+/**
+ * Run a tool body, catching any error and returning a safe, redacted result.
+ * Keeping `args` out of this wrapper preserves the SDK's type inference.
+ */
+export declare function attempt(ctx: ToolContext, body: () => Promise<ToolResult>): Promise<ToolResult>;
+/** Build a Blip OData-style query string with literal $skip/$take/$filter keys. */
+export declare function buildListQuery(skip: number, take: number, filter?: string): string;
+/** Encode a bucket id for a URL path while keeping ':' literal (namespace:key). */
+export declare function encodeBucketId(id: string): string;
+/**
+ * Generate likely phoneNumber formats to search a Blip CRM, which stores them
+ * inconsistently (+55…, 55…, or local DDD+number). Ordered most-likely-first.
+ */
+export declare function phoneCandidates(phone: string): string[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,yEAAyE;IACzE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAGpD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAYlE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAMvE;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAOpG;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASvD"}

package/dist/tools/shared.js

@@ -0,0 +1,67 @@
+import { redactSecrets } from "../errors.js";
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function jsonResult(data) {
+    const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    return textResult(text);
+}
+/** Friendly, non-error notice returned when a write is blocked by the guardrail. */
+export function readOnlyNotice(attemptedAction) {
+    return textResult([
+        "READ-ONLY MODE is ON, so this action was NOT executed.",
+        "",
+        `Attempted: ${attemptedAction}`,
+        "",
+        "This tool has real side effects (it can message actual users or change",
+        "stored data). To enable it, set BLIP_ALLOW_WRITES=true and restart the",
+        "MCP server.",
+    ].join("\n"));
+}
+export function errorResult(err, secrets) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: "text", text: `ERROR: ${redactSecrets(message, secrets)}` }],
+        isError: true,
+    };
+}
+/**
+ * Run a tool body, catching any error and returning a safe, redacted result.
+ * Keeping `args` out of this wrapper preserves the SDK's type inference.
+ */
+export async function attempt(ctx, body) {
+    try {
+        return await body();
+    }
+    catch (err) {
+        ctx.logger.error(`tool error: ${err instanceof Error ? err.message : String(err)}`);
+        return errorResult(err, ctx.secrets);
+    }
+}
+/** Build a Blip OData-style query string with literal $skip/$take/$filter keys. */
+export function buildListQuery(skip, take, filter) {
+    const parts = [`$skip=${skip}`, `$take=${take}`];
+    if (filter)
+        parts.push(`$filter=${encodeURIComponent(filter)}`);
+    return parts.join("&");
+}
+/** Encode a bucket id for a URL path while keeping ':' literal (namespace:key). */
+export function encodeBucketId(id) {
+    return encodeURIComponent(id).replace(/%3A/gi, ":");
+}
+/**
+ * Generate likely phoneNumber formats to search a Blip CRM, which stores them
+ * inconsistently (+55…, 55…, or local DDD+number). Ordered most-likely-first.
+ */
+export function phoneCandidates(phone) {
+    const digits = phone.replace(/\D/g, "");
+    const list = [];
+    if (digits.startsWith("55")) {
+        list.push(`+${digits}`, digits, digits.slice(2), `+${digits.slice(2)}`);
+    }
+    else {
+        list.push(digits, `+55${digits}`, `55${digits}`, `+${digits}`);
+    }
+    return [...new Set(list)].filter((v) => v.replace(/\D/g, "").length >= 8);
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

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

package/dist/tools/threads.d.ts

@@ -0,0 +1,3 @@
+import { type ToolContext } from "./shared.js";
+export declare function registerThreadTools(ctx: ToolContext): void;
+//# sourceMappingURL=threads.d.ts.map

package/dist/tools/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/tools/threads.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA4C1D"}

package/dist/tools/threads.js

@@ -0,0 +1,39 @@
+/**
+ * Conversation history (threads) tools. Read-only.
+ * Sent to the bot's own node (no `to`).
+ */
+import { z } from "zod";
+import { attempt, buildListQuery, jsonResult } from "./shared.js";
+export function registerThreadTools(ctx) {
+    const { server, client } = ctx;
+    server.registerTool("blip_list_threads", {
+        title: "List recent conversations",
+        description: "List recent conversation threads (one per contact). Read-only.",
+        inputSchema: {
+            skip: z.number().int().min(0).default(0).describe("Pagination offset."),
+            take: z.number().int().min(1).max(100).default(20).describe("Threads to return (1-100)."),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (args) => attempt(ctx, async () => {
+        const res = await client.sendCommand({
+            method: "get",
+            uri: `/threads?${buildListQuery(args.skip, args.take)}`,
+        });
+        return jsonResult(res.resource ?? res);
+    }));
+    server.registerTool("blip_get_thread", {
+        title: "Get a contact's conversation",
+        description: "Get the message history exchanged with a contact (what the user said and what the bot " +
+            "replied), most recent first. Read-only.",
+        inputSchema: {
+            identity: z.string().min(1).describe("Contact identity, e.g. 5511999999999@wa.gw.msging.net."),
+            take: z.number().int().min(1).max(100).default(20).describe("Messages to return (1-100)."),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (args) => attempt(ctx, async () => {
+        const uri = `/threads/${encodeURIComponent(args.identity)}?$take=${args.take}`;
+        const res = await client.sendCommand({ method: "get", uri });
+        return jsonResult(res.resource ?? res);
+    }));
+}
+//# sourceMappingURL=threads.js.map

package/dist/tools/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../src/tools/threads.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAClD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE/B,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SAC1F;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACtB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;YACnC,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,YAAY,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;SACxD,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IACzC,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,wFAAwF;YACxF,yCAAyC;QAC3C,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YAC9F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;SAC3F;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACtB,MAAM,GAAG,GAAG,YAAY,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7D,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IACzC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "take-blip-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Take Blip platform (contacts, buckets, broadcast lists, schedules, AI knowledge base) over the Blip HTTP/Command API. stdio transport.",
+  "license": "MIT",
+  "author": "Michaeltsg",
+  "type": "module",
+  "bin": {
+    "blip-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Michaeltsg/mcp-blip.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Michaeltsg/mcp-blip/issues"
+  },
+  "homepage": "https://github.com/Michaeltsg/mcp-blip#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "self-test": "node dist/index.js --self-test",
+    "map-flow": "node scripts/map-flow.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "take-blip",
+    "blip",
+    "chatbot",
+    "msging",
+    "lime"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}