social-mcp 1.0.1

package/README.md

@@ -0,0 +1,165 @@
+# social-mcp
+
+An MCP (Model Context Protocol) server that lets AI assistants post and interact across social media platforms.
+
+## Supported Platforms
+
+| Platform  | Tools |
+|-----------|-------|
+| Telegram  | Send message, get channel info, forward message, pin message, get channel members |
+| Twitter/X | Send tweet, get user info, search tweets |
+| Discord   | Send message |
+| WhatsApp  | Send message, get messages |
+| Facebook  | Create post |
+| Instagram | Create post |
+| Slack     | Send message |
+
+## Quick Start
+
+Run directly with `npx` — no install required:
+
+```bash
+npx social-mcp
+```
+
+Or install globally:
+
+```bash
+npm install -g social-mcp
+social-mcp
+```
+
+## MCP Client Configuration
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "social-mcp": {
+      "command": "npx",
+      "args": ["social-mcp"],
+      "env": {
+        "TELEGRAM_BOT_TOKEN": "your_token",
+        "TWITTER_APP_KEY": "your_key",
+        "TWITTER_APP_SECRET": "your_secret",
+        "TWITTER_ACCESS_TOKEN": "your_token",
+        "TWITTER_ACCESS_SECRET": "your_secret",
+        "DISCORD_BOT_TOKEN": "your_token",
+        "WHATSAPP_ACCESS_TOKEN": "your_token",
+        "WHATSAPP_PHONE_NUMBER_ID": "your_id",
+        "FACEBOOK_ACCESS_TOKEN": "your_token",
+        "INSTAGRAM_ACCESS_TOKEN": "your_token",
+        "SLACK_BOT_TOKEN": "your_token"
+      }
+    }
+  }
+}
+```
+
+### Cursor / VS Code (via MCP extension)
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "social-mcp": {
+        "command": "npx",
+        "args": ["social-mcp"],
+        "env": { "...": "same env vars as above" }
+      }
+    }
+  }
+}
+```
+
+Only include env vars for the platforms you actually use — unused platforms are simply ignored.
+
+## Environment Variables
+
+Copy `example.env` to `.env` and fill in the credentials for the platforms you want to use.
+
+### Telegram
+| Variable | Description |
+|----------|-------------|
+| `TELEGRAM_BOT_TOKEN` | Bot token from [@BotFather](https://t.me/BotFather) |
+
+### Twitter / X
+| Variable | Description |
+|----------|-------------|
+| `TWITTER_APP_KEY` | API key from the [Twitter Developer Portal](https://developer.twitter.com) |
+| `TWITTER_APP_SECRET` | API secret |
+| `TWITTER_ACCESS_TOKEN` | Access token (OAuth 1.0a, Read & Write) |
+| `TWITTER_ACCESS_SECRET` | Access token secret |
+
+### Discord
+| Variable | Description |
+|----------|-------------|
+| `DISCORD_BOT_TOKEN` | Bot token from the [Discord Developer Portal](https://discord.com/developers/applications) — bot must have Send Messages permission |
+
+### WhatsApp Business
+| Variable | Description |
+|----------|-------------|
+| `WHATSAPP_ACCESS_TOKEN` | Access token from Meta for Developers |
+| `WHATSAPP_PHONE_NUMBER_ID` | Phone Number ID from WhatsApp API Setup |
+
+### Facebook
+| Variable | Description |
+|----------|-------------|
+| `FACEBOOK_ACCESS_TOKEN` | Page Access Token from Meta Graph API Explorer |
+
+### Instagram
+| Variable | Description |
+|----------|-------------|
+| `INSTAGRAM_ACCESS_TOKEN` | Token with `instagram_content_publish` scope |
+
+### Slack
+| Variable | Description |
+|----------|-------------|
+| `SLACK_BOT_TOKEN` | Bot token from [api.slack.com](https://api.slack.com/apps) — requires `chat:write` scope |
+
+## Available Tools
+
+### Telegram
+- **SEND_MESSAGE** — Send a message to a chat or channel (`chatId`, `text`)
+- **GET_CHANNEL_INFO** — Get channel metadata (`channelId`)
+- **FORWARD_MESSAGE** — Forward a message between chats (`fromChatId`, `toChatId`, `messageId`)
+- **PIN_MESSAGE** — Pin a message in a chat (`chatId`, `messageId`)
+- **GET_CHANNEL_MEMBERS** — List channel administrators (`channelId`, `limit`)
+
+### Twitter / X
+- **SEND_TWEET** — Post a tweet (`text`, max 280 chars)
+- **GET_USER_INFO** — Get a user's profile and metrics (`username`)
+- **SEARCH_TWEETS** — Search recent tweets (`query`, `maxResults`)
+
+### Discord
+- **SEND_DISCORD_MESSAGE** — Send a message to a channel (`channelId`, `content`)
+
+### WhatsApp
+- **SEND_WHATSAPP_MESSAGE** — Send a message to a phone number in E.164 format (`to`, `text`)
+- **GET_WHATSAPP_MESSAGES** — Retrieve recent messages (`limit`)
+
+### Facebook
+- **CREATE_FACEBOOK_POST** — Create a post on a Facebook page (`pageId`, `message`)
+
+### Instagram
+- **CREATE_INSTAGRAM_POST** — Publish an image post (`userId`, `imageUrl`, `message`)
+
+### Slack
+- **SEND_SLACK_MESSAGE** — Send a message to a channel (`channelId`, `text`)
+
+## Development
+
+```bash
+pnpm install
+pnpm run build     # compile TypeScript
+pnpm run watch     # watch mode
+pnpm run lint      # lint with Biome
+pnpm run format    # format with Biome
+```
+
+## License
+
+ISC

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const APP_NAME = "SocialMCPServer";
+export declare const APP_VERSION = "1.1.1";

package/dist/constants.js

@@ -0,0 +1,4 @@
+// src/constants.ts
+export const APP_NAME = "SocialMCPServer";
+export const APP_VERSION = "1.1.1";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,mBAAmB;AAEnB,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { FastMCP } from "fastmcp";
+import { forwardMessageTool } from "./tools/telegram-tools/forward-message.js";
+import { getChannelInfoTool } from "./tools/telegram-tools/get-channel-info.js";
+import { getChannelMembersTool } from "./tools/telegram-tools/get-channel-members.js";
+import { pinMessageTool } from "./tools/telegram-tools/pin-message.js";
+import { sendMessageTool } from "./tools/telegram-tools/send-message.js";
+import { getUserInfoTool } from "./tools/twitter-tools/get-user-info.js";
+import { searchTweetsTool } from "./tools/twitter-tools/search-tweets.js";
+import { sendTweetTool } from "./tools/twitter-tools/send-tweet.js";
+// Discord tools
+import { sendMessageTool as discordSendMessageTool } from "./tools/discord-tools/send-message.js";
+// WhatsApp tools
+import { sendMessageTool as whatsappSendMessageTool } from "./tools/whatsapp-tools/send-message.js";
+import { getMessagesTool as whatsappGetMessagesTool } from "./tools/whatsapp-tools/get-messages.js";
+// Facebook tools
+import { createPostTool as facebookCreatePostTool } from "./tools/facebook-tools/create-post.js";
+// Instagram tools
+import { createPostTool as instagramCreatePostTool } from "./tools/instagram-tools/create-post.js";
+// Slack tools
+import { sendMessageTool as slackSendMessageTool } from "./tools/slack-tools/send-message.js";
+async function main() {
+    const server = new FastMCP({
+        name: "Social MCP Server",
+        version: "1.1.1",
+    });
+    // Add Telegram tools
+    server.addTool(sendMessageTool);
+    server.addTool(getChannelInfoTool);
+    server.addTool(forwardMessageTool);
+    server.addTool(pinMessageTool);
+    server.addTool(getChannelMembersTool);
+    // Add Twitter tools
+    server.addTool(sendTweetTool);
+    server.addTool(getUserInfoTool);
+    server.addTool(searchTweetsTool);
+    // Add Discord tools
+    server.addTool(discordSendMessageTool);
+    // Add WhatsApp tools
+    server.addTool(whatsappSendMessageTool);
+    server.addTool(whatsappGetMessagesTool);
+    // Add Facebook tools
+    server.addTool(facebookCreatePostTool);
+    // Add Instagram tools
+    server.addTool(instagramCreatePostTool);
+    // Add Slack tools
+    server.addTool(slackSendMessageTool);
+    try {
+        await server.start({
+            transportType: "stdio",
+        });
+    }
+    catch (error) {
+        console.error("Failed to start Social MCP Server:", error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error("Unexpected error in Social MCP Server:", error);
+    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":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,gBAAgB;AAChB,OAAO,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAElG,iBAAiB;AACjB,OAAO,EAAE,eAAe,IAAI,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,eAAe,IAAI,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEpG,iBAAiB;AACjB,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEjG,kBAAkB;AAClB,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEnG,cAAc;AACd,OAAO,EAAE,eAAe,IAAI,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,KAAK,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;QAC1B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KAChB,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEtC,oBAAoB;IACpB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9B,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjC,oBAAoB;IACpB,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEvC,qBAAqB;IACrB,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACxC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAExC,qBAAqB;IACrB,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEvC,sBAAsB;IACtB,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAExC,kBAAkB;IAClB,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAErC,IAAI,CAAC;QACJ,MAAM,MAAM,CAAC,KAAK,CAAC;YAClB,aAAa,EAAE,OAAO;SACtB,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,19 @@
+export declare const config: {
+    discord: {
+        baseUrl: string;
+        botToken: string;
+    };
+    whatsapp: {
+        baseUrl: string;
+        accessToken: string;
+        phoneNumberId: string;
+    };
+    facebook: {
+        baseUrl: string;
+        accessToken: string;
+    };
+    instagram: {
+        baseUrl: string;
+        accessToken: string;
+    };
+};

package/dist/lib/config.js

@@ -0,0 +1,20 @@
+export const config = {
+    discord: {
+        baseUrl: "https://discord.com/api/v10",
+        botToken: process.env.DISCORD_BOT_TOKEN || "",
+    },
+    whatsapp: {
+        baseUrl: "https://graph.facebook.com/v21.0",
+        accessToken: process.env.WHATSAPP_ACCESS_TOKEN || "",
+        phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID || "",
+    },
+    facebook: {
+        baseUrl: "https://graph.facebook.com/v21.0",
+        accessToken: process.env.FACEBOOK_ACCESS_TOKEN || "",
+    },
+    instagram: {
+        baseUrl: "https://graph.facebook.com/v21.0",
+        accessToken: process.env.INSTAGRAM_ACCESS_TOKEN || "",
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE;QACP,OAAO,EAAE,6BAA6B;QACtC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;KAC9C;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;QACpD,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE;KAC1D;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;KACrD;IACD,SAAS,EAAE;QACT,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE;KACtD;CACF,CAAC"}

package/dist/lib/http.d.ts

@@ -0,0 +1,7 @@
+import type { z } from "zod";
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly data?: unknown | undefined;
+    constructor(status: number, message: string, data?: unknown | undefined);
+}
+export declare function fetchJson<T>(url: string, options?: RequestInit, schema?: z.ZodType<T>): Promise<T>;

package/dist/lib/http.js

@@ -0,0 +1,27 @@
+export class HttpError extends Error {
+    status;
+    data;
+    constructor(status, message, data) {
+        super(message);
+        this.status = status;
+        this.data = data;
+        this.name = "HttpError";
+    }
+}
+export async function fetchJson(url, options, schema) {
+    const response = await fetch(url, options);
+    if (!response.ok) {
+        throw new HttpError(response.status, `HTTP error ${response.status}: ${response.statusText}`, await response.text().catch(() => undefined));
+    }
+    const data = await response.json();
+    if (schema) {
+        try {
+            return schema.parse(data);
+        }
+        catch (error) {
+            throw new Error(`Invalid response data: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return data;
+}
+//# sourceMappingURL=http.js.map

package/dist/lib/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAElB;IAEA;IAHjB,YACiB,MAAc,EAC9B,OAAe,EACC,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QAEd,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACzB,CAAC;CACD;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,GAAW,EACX,OAAqB,EACrB,MAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE3C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,SAAS,CAClB,QAAQ,CAAC,MAAM,EACf,cAAc,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EACvD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAC5C,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,IAAI,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC;YACJ,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACd,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClF,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,IAAS,CAAC;AAClB,CAAC"}

package/dist/run_tools_discord.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Discord Tools Test Runner
+ *
+ * Tests all Discord MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:discord
+ *   -- or after build --
+ *   node dist/run_tools_discord.js
+ *
+ * Required env vars:
+ *   DISCORD_BOT_TOKEN - Your Discord bot token
+ *
+ * Optional env vars (for testing):
+ *   TEST_DISCORD_CHANNEL_ID - The channel ID to send test messages to
+ */
+import "dotenv/config";

package/dist/run_tools_discord.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Discord Tools Test Runner
+ *
+ * Tests all Discord MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:discord
+ *   -- or after build --
+ *   node dist/run_tools_discord.js
+ *
+ * Required env vars:
+ *   DISCORD_BOT_TOKEN - Your Discord bot token
+ *
+ * Optional env vars (for testing):
+ *   TEST_DISCORD_CHANNEL_ID - The channel ID to send test messages to
+ */
+import "dotenv/config";
+import { sendMessageTool } from "./tools/discord-tools/send-message.js";
+const CHANNEL_ID = process.env.TEST_DISCORD_CHANNEL_ID ?? "";
+function printSeparator(title) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`  ${title}`);
+    console.log("─".repeat(60));
+}
+async function runDiscordTests() {
+    console.log("🚀 Discord Tools Test Runner");
+    console.log(`   DISCORD_BOT_TOKEN: ${process.env.DISCORD_BOT_TOKEN ? "✅ Set" : "❌ Missing"}`);
+    console.log(`   Channel ID: ${CHANNEL_ID || "(not set — tests will be skipped)"}`);
+    // ── 1. SEND_DISCORD_MESSAGE ─────────────────────────────────
+    printSeparator("1. SEND_DISCORD_MESSAGE");
+    if (CHANNEL_ID) {
+        const result = await sendMessageTool.execute({
+            channelId: CHANNEL_ID,
+            content: "👋 Hello from social-mcp! This is a test message.",
+        });
+        console.log(result);
+    }
+    else {
+        console.log("⚠️  Skipped: set TEST_DISCORD_CHANNEL_ID in .env to run this test.");
+    }
+    console.log("\n✅ Discord test runner complete.");
+}
+runDiscordTests().catch((err) => {
+    console.error("❌ Discord test runner failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=run_tools_discord.js.map

package/dist/run_tools_discord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_tools_discord.js","sourceRoot":"","sources":["../src/run_tools_discord.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC;AAE7D,SAAS,cAAc,CAAC,KAAa;IACpC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CACV,yBAAyB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAChF,CAAC;IACF,OAAO,CAAC,GAAG,CACV,kBAAkB,UAAU,IAAI,mCAAmC,EAAE,CACrE,CAAC;IAEF,+DAA+D;IAC/D,cAAc,CAAC,yBAAyB,CAAC,CAAC;IAC1C,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC;YAC5C,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,mDAAmD;SAC5D,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,GAAG,CACV,oEAAoE,CACpE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAClD,CAAC;AAED,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/run_tools_facebook.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Facebook Tools Test Runner
+ *
+ * Tests all Facebook MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:facebook
+ *   -- or after build --
+ *   node dist/run_tools_facebook.js
+ *
+ * Required env vars:
+ *   FACEBOOK_ACCESS_TOKEN - Facebook Page access token (long-lived)
+ *
+ * Optional env vars (for testing):
+ *   TEST_FACEBOOK_PAGE_ID - The Facebook Page ID to post to
+ */
+import "dotenv/config";

package/dist/run_tools_facebook.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Facebook Tools Test Runner
+ *
+ * Tests all Facebook MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:facebook
+ *   -- or after build --
+ *   node dist/run_tools_facebook.js
+ *
+ * Required env vars:
+ *   FACEBOOK_ACCESS_TOKEN - Facebook Page access token (long-lived)
+ *
+ * Optional env vars (for testing):
+ *   TEST_FACEBOOK_PAGE_ID - The Facebook Page ID to post to
+ */
+import "dotenv/config";
+import { createPostTool } from "./tools/facebook-tools/create-post.js";
+const PAGE_ID = process.env.TEST_FACEBOOK_PAGE_ID ?? "";
+function printSeparator(title) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`  ${title}`);
+    console.log("─".repeat(60));
+}
+async function runFacebookTests() {
+    console.log("🚀 Facebook Tools Test Runner");
+    console.log(`   FACEBOOK_ACCESS_TOKEN: ${process.env.FACEBOOK_ACCESS_TOKEN ? "✅ Set" : "❌ Missing"}`);
+    console.log(`   Page ID: ${PAGE_ID || "(not set — test will be skipped)"}`);
+    // ── 1. CREATE_FACEBOOK_POST ─────────────────────────────────
+    printSeparator("1. CREATE_FACEBOOK_POST");
+    if (PAGE_ID) {
+        const result = await createPostTool.execute({
+            pageId: PAGE_ID,
+            message: "👋 Hello from social-mcp! This is a test post. #mcp #test",
+        });
+        console.log(result);
+    }
+    else {
+        console.log("⚠️  Skipped: set TEST_FACEBOOK_PAGE_ID in .env to run this test.");
+    }
+    console.log("\n✅ Facebook test runner complete.");
+}
+runFacebookTests().catch((err) => {
+    console.error("❌ Facebook test runner failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=run_tools_facebook.js.map

package/dist/run_tools_facebook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_tools_facebook.js","sourceRoot":"","sources":["../src/run_tools_facebook.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;AAExD,SAAS,cAAc,CAAC,KAAa;IACpC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CACV,6BAA6B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CACxF,CAAC;IACF,OAAO,CAAC,GAAG,CACV,eAAe,OAAO,IAAI,kCAAkC,EAAE,CAC9D,CAAC;IAEF,+DAA+D;IAC/D,cAAc,CAAC,yBAAyB,CAAC,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;YAC3C,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,2DAA2D;SACpE,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,GAAG,CACV,kEAAkE,CAClE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AACnD,CAAC;AAED,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAChC,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/run_tools_instagram.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Instagram Tools Test Runner
+ *
+ * Tests all Instagram MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:instagram
+ *   -- or after build --
+ *   node dist/run_tools_instagram.js
+ *
+ * Required env vars:
+ *   INSTAGRAM_ACCESS_TOKEN - Instagram Graph API access token
+ *
+ * Optional env vars (for testing):
+ *   TEST_INSTAGRAM_USER_ID  - Your Instagram Business/Creator account user ID
+ *   TEST_INSTAGRAM_IMAGE_URL - Publicly accessible URL of an image to post
+ */
+import "dotenv/config";

package/dist/run_tools_instagram.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * Instagram Tools Test Runner
+ *
+ * Tests all Instagram MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:instagram
+ *   -- or after build --
+ *   node dist/run_tools_instagram.js
+ *
+ * Required env vars:
+ *   INSTAGRAM_ACCESS_TOKEN - Instagram Graph API access token
+ *
+ * Optional env vars (for testing):
+ *   TEST_INSTAGRAM_USER_ID  - Your Instagram Business/Creator account user ID
+ *   TEST_INSTAGRAM_IMAGE_URL - Publicly accessible URL of an image to post
+ */
+import "dotenv/config";
+import { createPostTool } from "./tools/instagram-tools/create-post.js";
+const USER_ID = process.env.TEST_INSTAGRAM_USER_ID ?? "";
+const IMAGE_URL = process.env.TEST_INSTAGRAM_IMAGE_URL ??
+    "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=1080";
+function printSeparator(title) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`  ${title}`);
+    console.log("─".repeat(60));
+}
+async function runInstagramTests() {
+    console.log("🚀 Instagram Tools Test Runner");
+    console.log(`   INSTAGRAM_ACCESS_TOKEN: ${process.env.INSTAGRAM_ACCESS_TOKEN ? "✅ Set" : "❌ Missing"}`);
+    console.log(`   User ID:   ${USER_ID || "(not set — test will be skipped)"}`);
+    console.log(`   Image URL: ${IMAGE_URL}`);
+    // ── 1. CREATE_INSTAGRAM_POST ────────────────────────────────
+    printSeparator("1. CREATE_INSTAGRAM_POST");
+    if (USER_ID) {
+        const result = await createPostTool.execute({
+            userId: USER_ID,
+            imageUrl: IMAGE_URL,
+            message: "📸 Test post from social-mcp! #mcp #test",
+        });
+        console.log(result);
+    }
+    else {
+        console.log("⚠️  Skipped: set TEST_INSTAGRAM_USER_ID in .env to run this test.");
+    }
+    console.log("\n✅ Instagram test runner complete.");
+}
+runInstagramTests().catch((err) => {
+    console.error("❌ Instagram test runner failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=run_tools_instagram.js.map

package/dist/run_tools_instagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_tools_instagram.js","sourceRoot":"","sources":["../src/run_tools_instagram.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC;AACzD,MAAM,SAAS,GACd,OAAO,CAAC,GAAG,CAAC,wBAAwB;IACpC,qEAAqE,CAAC;AAEvE,SAAS,cAAc,CAAC,KAAa;IACpC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CACV,8BAA8B,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAC1F,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,IAAI,kCAAkC,EAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;IAE1C,+DAA+D;IAC/D,cAAc,CAAC,0BAA0B,CAAC,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;YAC3C,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,0CAA0C;SACnD,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,GAAG,CACV,mEAAmE,CACnE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AACpD,CAAC;AAED,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/run_tools_slack.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Slack Tools Test Runner
+ *
+ * Tests all Slack MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:slack
+ *   -- or after build --
+ *   node dist/run_tools_slack.js
+ *
+ * Required env vars:
+ *   SLACK_BOT_TOKEN - Your Slack bot OAuth token (xoxb-...)
+ *
+ * Optional env vars (for testing):
+ *   TEST_SLACK_CHANNEL_ID - Slack channel ID (e.g. C1234567890) or name (#general)
+ */
+import "dotenv/config";

package/dist/run_tools_slack.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Slack Tools Test Runner
+ *
+ * Tests all Slack MCP tools against the real API.
+ * Set environment variables in .env before running.
+ *
+ * Usage:
+ *   pnpm run:slack
+ *   -- or after build --
+ *   node dist/run_tools_slack.js
+ *
+ * Required env vars:
+ *   SLACK_BOT_TOKEN - Your Slack bot OAuth token (xoxb-...)
+ *
+ * Optional env vars (for testing):
+ *   TEST_SLACK_CHANNEL_ID - Slack channel ID (e.g. C1234567890) or name (#general)
+ */
+import "dotenv/config";
+import { sendMessageTool } from "./tools/slack-tools/send-message.js";
+const CHANNEL_ID = process.env.TEST_SLACK_CHANNEL_ID ?? "";
+function printSeparator(title) {
+    console.log(`\n${"─".repeat(60)}`);
+    console.log(`  ${title}`);
+    console.log("─".repeat(60));
+}
+async function runSlackTests() {
+    console.log("🚀 Slack Tools Test Runner");
+    console.log(`   SLACK_BOT_TOKEN: ${process.env.SLACK_BOT_TOKEN ? "✅ Set" : "❌ Missing"}`);
+    console.log(`   Channel ID: ${CHANNEL_ID || "(not set — test will be skipped)"}`);
+    // ── 1. SEND_SLACK_MESSAGE ───────────────────────────────────
+    printSeparator("1. SEND_SLACK_MESSAGE");
+    if (CHANNEL_ID) {
+        const result = await sendMessageTool.execute({
+            channelId: CHANNEL_ID,
+            text: "👋 Hello from social-mcp! This is a test message. :robot_face:",
+        });
+        console.log(result);
+    }
+    else {
+        console.log("⚠️  Skipped: set TEST_SLACK_CHANNEL_ID in .env to run this test.");
+    }
+    console.log("\n✅ Slack test runner complete.");
+}
+runSlackTests().catch((err) => {
+    console.error("❌ Slack test runner failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=run_tools_slack.js.map

package/dist/run_tools_slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_tools_slack.js","sourceRoot":"","sources":["../src/run_tools_slack.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEtE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;AAE3D,SAAS,cAAc,CAAC,KAAa;IACpC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CACV,uBAAuB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAC5E,CAAC;IACF,OAAO,CAAC,GAAG,CACV,kBAAkB,UAAU,IAAI,kCAAkC,EAAE,CACpE,CAAC;IAEF,+DAA+D;IAC/D,cAAc,CAAC,uBAAuB,CAAC,CAAC;IACxC,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC;YAC5C,SAAS,EAAE,UAAU;YACrB,IAAI,EAAE,gEAAgE;SACtE,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,GAAG,CACV,kEAAkE,CAClE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAChD,CAAC;AAED,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}