@thenavidm/threads-mcp-cli 1.1.0

package/dist/tools/replies.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Replies, conversations, and moderation of both.
+ *
+ * Threads exposes three different reply views and they are not
+ * interchangeable, which is the single most common source of confusion here:
+ *
+ *   /{post-id}/replies       direct replies to one post, one level deep
+ *   /{post-id}/conversation  the whole tree under one post, flattened
+ *   /{user-id}/replies       every reply you have received, across all posts
+ *
+ * The third is the one an agent actually wants when asked "what needs
+ * answering", and it is the one nothing surfaces by default.
+ */
+import { z } from "zod";
+export declare const replyToPost: import("./kit.js").ToolSpec<{
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    account: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    text: z.ZodString;
+    image_url: z.ZodOptional<z.ZodString>;
+    video_url: z.ZodOptional<z.ZodString>;
+    alt_text: z.ZodOptional<z.ZodString>;
+}>;
+export declare const getReplies: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    reverse: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const getConversation: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    reverse: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const getAllReplies: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    since_hours: z.ZodOptional<z.ZodNumber>;
+}>;
+export declare const hideReply: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    reply_id: z.ZodString;
+    hide: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const getPendingReplies: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}>;
+export declare const managePendingReply: import("./kit.js").ToolSpec<{
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    account: z.ZodOptional<z.ZodString>;
+    reply_id: z.ZodString;
+    action: z.ZodEnum<["approve", "ignore"]>;
+}>;
+export declare const REPLY_TOOLS: (import("./kit.js").ToolSpec<{
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    account: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    text: z.ZodString;
+    image_url: z.ZodOptional<z.ZodString>;
+    video_url: z.ZodOptional<z.ZodString>;
+    alt_text: z.ZodOptional<z.ZodString>;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    reverse: z.ZodOptional<z.ZodBoolean>;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    since_hours: z.ZodOptional<z.ZodNumber>;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    reply_id: z.ZodString;
+    hide: z.ZodOptional<z.ZodBoolean>;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}> | import("./kit.js").ToolSpec<{
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    account: z.ZodOptional<z.ZodString>;
+    reply_id: z.ZodString;
+    action: z.ZodEnum<["approve", "ignore"]>;
+}>)[];

package/dist/tools/replies.js

@@ -0,0 +1,218 @@
+/**
+ * Replies, conversations, and moderation of both.
+ *
+ * Threads exposes three different reply views and they are not
+ * interchangeable, which is the single most common source of confusion here:
+ *
+ *   /{post-id}/replies       direct replies to one post, one level deep
+ *   /{post-id}/conversation  the whole tree under one post, flattened
+ *   /{user-id}/replies       every reply you have received, across all posts
+ *
+ * The third is the one an agent actually wants when asked "what needs
+ * answering", and it is the one nothing surfaces by default.
+ */
+import { z } from "zod";
+import { accountArg, clamp, confirmArg, defineTool, pageArgs, snippet } from "./kit.js";
+import { REPLY_FIELDS } from "../api/client.js";
+import { cursorOf, dataOf, renderList } from "../format/posts.js";
+import { requireMediaId } from "../api/identity.js";
+import { publish } from "../content/containers.js";
+export const replyToPost = defineTool({
+    name: "reply_to",
+    title: "Reply to a post",
+    description: "Publish a reply to a Threads post, yours or anyone's. Public the moment it runs and counted against the 1,000-reply daily quota, so it needs confirm: true.",
+    schema: {
+        id: z.string().describe("Numeric id of the post being replied to."),
+        text: z.string().describe("The reply. 500 characters."),
+        image_url: z.string().optional().describe("Optional public HTTPS image URL."),
+        video_url: z.string().optional().describe("Optional public HTTPS video URL."),
+        alt_text: z.string().optional(),
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `reply to Threads post ${args.id}: "${snippet(args.text)}"`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        return publish(ctx.client, account, {
+            text: args.text,
+            image_url: args.image_url,
+            video_url: args.video_url,
+            alt_text: args.alt_text,
+            reply_to_id: requireMediaId(args.id),
+        });
+    },
+});
+export const getReplies = defineTool({
+    name: "get_replies",
+    title: "Read direct replies to a post",
+    description: "The direct replies to one post, one level deep. For the whole tree underneath it, including replies to replies, use get_conversation.",
+    schema: {
+        id: z.string().describe("Numeric id of the post."),
+        reverse: z.boolean().optional().describe("Oldest first. Defaults to newest first."),
+        ...pageArgs,
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.id);
+        const response = (await ctx.client.call(account, `/${id}/replies`, {
+            params: {
+                fields: REPLY_FIELDS,
+                limit: clamp(args.limit, 25),
+                after: args.cursor,
+                reverse: args.reverse === true ? "true" : undefined,
+            },
+        }));
+        return renderList(dataOf(response), {
+            source: "replies",
+            cursor: cursorOf(response),
+            meta: { post_id: id },
+        }, "reply");
+    },
+});
+export const getConversation = defineTool({
+    name: "get_conversation",
+    title: "Read a whole conversation",
+    description: "Every reply under one of your posts, including replies to replies, flattened into one list with each reply naming its parent. Only works on posts you own. This is what to read before deciding what deserves an answer.",
+    schema: {
+        id: z.string().describe("Numeric id of one of your posts."),
+        reverse: z.boolean().optional(),
+        ...pageArgs,
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.id);
+        const response = (await ctx.client.call(account, `/${id}/conversation`, {
+            params: {
+                fields: REPLY_FIELDS,
+                limit: clamp(args.limit, 50),
+                after: args.cursor,
+                reverse: args.reverse === true ? "true" : undefined,
+            },
+        }));
+        return renderList(dataOf(response), {
+            source: "conversation",
+            cursor: cursorOf(response),
+            meta: { root_post_id: id },
+        }, "reply");
+    },
+});
+export const getAllReplies = defineTool({
+    name: "get_all_replies",
+    title: "Read every reply across all your posts",
+    description: "Every reply you have received, newest first, across every post. This is the inbox view: use it to find what needs answering without walking each post one at a time.",
+    schema: {
+        since_hours: z
+            .number()
+            .optional()
+            .describe("Only replies from the last N hours. Filtered after fetching, so pair it with a larger limit."),
+        ...pageArgs,
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const userId = await ctx.client.userId(account);
+        const response = (await ctx.client.call(account, `/${userId}/replies`, {
+            params: { fields: REPLY_FIELDS, limit: clamp(args.limit, 25), after: args.cursor },
+        }));
+        let replies = dataOf(response);
+        if (args.since_hours) {
+            const cutoff = Date.now() - args.since_hours * 3_600_000;
+            replies = replies.filter((r) => {
+                const at = new Date(String(r.timestamp)).getTime();
+                return Number.isNaN(at) || at >= cutoff;
+            });
+        }
+        return renderList(replies, {
+            source: "replies",
+            cursor: cursorOf(response),
+            meta: { scope: "all_posts", ...(args.since_hours ? { since_hours: args.since_hours } : {}) },
+        }, "reply");
+    },
+});
+export const hideReply = defineTool({
+    name: "hide_reply",
+    title: "Hide or unhide a reply",
+    description: "Hide a reply on one of your posts, or unhide one you hid. Hiding a top-level reply cascades to everything nested under it. Reversible in one call, so this does not need a confirmation.",
+    schema: {
+        reply_id: z.string().describe("Numeric id of the reply."),
+        hide: z.boolean().optional().describe("True to hide, false to unhide. Defaults to true."),
+        ...accountArg,
+    },
+    risk: "write",
+    idempotent: true,
+    summary: (args) => `${args.hide === false ? "unhide" : "hide"} Threads reply ${args.reply_id}`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.reply_id);
+        const hide = args.hide !== false;
+        await ctx.client.call(account, `/${id}/manage_reply`, {
+            method: "POST",
+            params: { hide: hide ? "true" : "false" },
+        });
+        return {
+            reply_id: id,
+            hidden: hide,
+            note: hide ? "Nested replies under this one are hidden too." : undefined,
+        };
+    },
+});
+export const getPendingReplies = defineTool({
+    name: "get_pending_replies",
+    title: "Read the reply approval queue",
+    description: "Replies waiting for approval on posts published with enable_reply_approvals. They are invisible to everyone until approved. Empty unless reply approvals were switched on for the post.",
+    schema: { ...pageArgs, ...accountArg },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const userId = await ctx.client.userId(account);
+        const response = (await ctx.client.call(account, `/${userId}/pending_replies`, {
+            params: {
+                fields: `${REPLY_FIELDS},reply_approval_status`,
+                limit: clamp(args.limit, 25),
+                after: args.cursor,
+            },
+        }));
+        return renderList(dataOf(response), {
+            source: "pending_replies",
+            cursor: cursorOf(response),
+        }, "reply");
+    },
+});
+export const managePendingReply = defineTool({
+    name: "manage_pending_reply",
+    title: "Approve or ignore a pending reply",
+    description: "Approve a reply waiting in the approval queue, making it public, or ignore it so it stays hidden. Approving is public, so it needs confirm: true.",
+    schema: {
+        reply_id: z.string().describe("Numeric id of the pending reply."),
+        action: z.enum(["approve", "ignore"]).describe("approve makes it public; ignore leaves it hidden."),
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `${args.action} pending Threads reply ${args.reply_id}`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.reply_id);
+        await ctx.client.call(account, `/${id}/manage_pending_reply`, {
+            method: "POST",
+            params: { approve: args.action === "approve" ? "true" : "false" },
+        });
+        return { reply_id: id, action: args.action, public: args.action === "approve" };
+    },
+});
+export const REPLY_TOOLS = [
+    replyToPost,
+    getReplies,
+    getConversation,
+    getAllReplies,
+    hideReply,
+    getPendingReplies,
+    managePendingReply,
+];
+//# sourceMappingURL=replies.js.map

package/dist/tools/replies.js.map

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

package/dist/transport/http.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HTTP transport, for running the server somewhere always on.
+ *
+ * Streamable HTTP, stateless: every request builds its own transport and tears
+ * it down. No session map means no session leak, which matters more here than
+ * the reconnect support a stateful server would buy.
+ *
+ * There is a second reason to run this way for Threads specifically. A token
+ * only stays alive if something refreshes it inside its 60-day window, and an
+ * MCP server launched over stdio only exists while a client has it open. A
+ * long-running HTTP instance refreshes on its own and never lets the window
+ * close.
+ *
+ * Bound to 127.0.0.1 by default. A Threads token can post as you, so a server
+ * that binds 0.0.0.0 without being asked is a mistake waiting to be made once;
+ * THREADS_HTTP_HOST is there for people who mean it.
+ */
+import type { BuiltServer } from "../server.js";
+export type HttpOptions = {
+    port: number;
+    host: string;
+    /** When set, every request must send `Authorization: Bearer <token>`. */
+    token?: string;
+};
+export declare function httpOptionsFromEnv(argv?: string[]): HttpOptions;
+export declare function startHttpServer(built: BuiltServer, options: HttpOptions): Promise<{
+    close: () => Promise<void>;
+}>;

package/dist/transport/http.js

@@ -0,0 +1,103 @@
+/**
+ * HTTP transport, for running the server somewhere always on.
+ *
+ * Streamable HTTP, stateless: every request builds its own transport and tears
+ * it down. No session map means no session leak, which matters more here than
+ * the reconnect support a stateful server would buy.
+ *
+ * There is a second reason to run this way for Threads specifically. A token
+ * only stays alive if something refreshes it inside its 60-day window, and an
+ * MCP server launched over stdio only exists while a client has it open. A
+ * long-running HTTP instance refreshes on its own and never lets the window
+ * close.
+ *
+ * Bound to 127.0.0.1 by default. A Threads token can post as you, so a server
+ * that binds 0.0.0.0 without being asked is a mistake waiting to be made once;
+ * THREADS_HTTP_HOST is there for people who mean it.
+ */
+import { createServer } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { daysRemaining } from "../auth/tokens.js";
+export function httpOptionsFromEnv(argv = []) {
+    const flag = argv.find((a) => a.startsWith("--port="));
+    const port = Number(flag?.split("=")[1] ?? process.env.THREADS_HTTP_PORT ?? 8787);
+    return {
+        port: Number.isFinite(port) && port > 0 ? port : 8787,
+        host: process.env.THREADS_HTTP_HOST || "127.0.0.1",
+        token: process.env.THREADS_HTTP_TOKEN || undefined,
+    };
+}
+async function readBody(req) {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(chunk);
+    const raw = Buffer.concat(chunks).toString("utf8");
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Constant-time-ish comparison, so the token cannot be guessed byte by byte. */
+function tokenMatches(expected, provided) {
+    if (expected.length !== provided.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < expected.length; i++)
+        diff |= expected.charCodeAt(i) ^ provided.charCodeAt(i);
+    return diff === 0;
+}
+async function handle(built, options, req, res) {
+    // Health needs no auth: it reports counts, never content.
+    if (req.method === "GET" && (req.url === "/health" || req.url === "/healthz")) {
+        res.writeHead(200, { "content-type": "application/json" });
+        res.end(JSON.stringify({
+            status: "ok",
+            tools: built.toolCount,
+            accounts: built.config.accounts.length,
+            read_only: built.config.readOnly,
+            tokens: built.config.accounts.map((a) => ({
+                username: a.username ?? null,
+                days_left: daysRemaining(a) ?? null,
+            })),
+        }));
+        return;
+    }
+    if (options.token) {
+        const header = req.headers.authorization ?? "";
+        const provided = header.startsWith("Bearer ") ? header.slice(7) : "";
+        if (!provided || !tokenMatches(options.token, provided)) {
+            res.writeHead(401, { "content-type": "application/json" });
+            res.end(JSON.stringify({ error: "unauthorized" }));
+            return;
+        }
+    }
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    res.on("close", () => void transport.close());
+    await built.server.connect(transport);
+    await transport.handleRequest(req, res, await readBody(req));
+}
+export async function startHttpServer(built, options) {
+    const http = createServer((req, res) => {
+        void handle(built, options, req, res).catch((error) => {
+            if (!res.headersSent)
+                res.writeHead(500, { "content-type": "application/json" });
+            res.end(JSON.stringify({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: error?.message ?? "internal error" },
+                id: null,
+            }));
+        });
+    });
+    await new Promise((resolve) => http.listen(options.port, options.host, resolve));
+    process.stderr.write(`[threads-mcp] HTTP on http://${options.host}:${options.port} (${built.toolCount} tools, ${built.config.accounts.length} account(s))${options.token ? "" : "\n[threads-mcp] No THREADS_HTTP_TOKEN set: this endpoint is unauthenticated."}\n`);
+    return {
+        close: () => new Promise((resolve) => {
+            http.close(() => resolve());
+        }),
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@thenavidm/threads-mcp-cli",
+  "version": "1.1.0",
+  "description": "Threads MCP server and CLI for Claude Code and AI agents. 30 tools for posting, chained threads, carousels, replies and reply approvals, insights, keyword search and profile discovery.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "threads-mcp": "dist/index.js",
+    "threads-cli": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "build:mcpb": "bash desktop-extension/build.sh"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "license": "MIT",
+  "author": "Navid Moazzez (https://navid.me)",
+  "homepage": "https://navid.me",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thenavidm/threads-mcp-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thenavidm/threads-mcp-cli/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "threads",
+    "threads-api",
+    "meta",
+    "mcp-server",
+    "claude",
+    "claude-code",
+    "ai-agents",
+    "llm-tools"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "SKILL.md",
+    "LICENSE"
+  ],
+  "contributors": [
+    "Navid Moazzez (https://navid.me)"
+  ]
+}