social-mcp 1.0.1

package/dist/tools/telegram-tools/pin-message.js

@@ -0,0 +1,41 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { TelegramService } from "../../services/telegram-service.js";
+const pinMessageParams = z.object({
+    chatId: z
+        .union([z.string(), z.number()])
+        .describe("The chat ID or channel username"),
+    messageId: z.number().describe("ID of the message to pin"),
+    disableNotification: z.boolean().optional().describe("Pin message silently"),
+});
+export const pinMessageTool = {
+    name: "PIN_MESSAGE",
+    description: "Pin a message in a Telegram chat or channel",
+    parameters: pinMessageParams,
+    execute: async (params) => {
+        const telegramService = new TelegramService();
+        try {
+            const success = await telegramService.pinMessage(params.chatId, params.messageId);
+            if (success) {
+                return dedent `
+					Message pinned successfully!
+
+					Chat ID: ${params.chatId}
+					Message ID: ${params.messageId}
+					Silent: ${params.disableNotification ? "Yes" : "No"}
+				`;
+            }
+            return "Failed to pin message";
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("BOT_TOKEN")) {
+                    return "Error: Telegram bot token is not configured. Please set the TELEGRAM_BOT_TOKEN environment variable.";
+                }
+                return `Error pinning message: ${error.message}`;
+            }
+            return "An unknown error occurred while pinning the message";
+        }
+    },
+};
+//# sourceMappingURL=pin-message.js.map

package/dist/tools/telegram-tools/pin-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-message.js","sourceRoot":"","sources":["../../../src/tools/telegram-tools/pin-message.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC/B,QAAQ,CAAC,iCAAiC,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC1D,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CAC5E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,6CAA6C;IAC1D,UAAU,EAAE,gBAAgB;IAC5B,OAAO,EAAE,KAAK,EAAE,MAAwB,EAAE,EAAE;QAC3C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE9C,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,UAAU,CAC/C,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,CAChB,CAAC;YAEF,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,MAAM,CAAA;;;gBAGD,MAAM,CAAC,MAAM;mBACV,MAAM,CAAC,SAAS;eACpB,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;KACnD,CAAC;YACH,CAAC;YACD,OAAO,uBAAuB,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBACzC,OAAO,sGAAsG,CAAC;gBAC/G,CAAC;gBACD,OAAO,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC;YAClD,CAAC;YACD,OAAO,qDAAqD,CAAC;QAC9D,CAAC;IACF,CAAC;CACQ,CAAC"}

package/dist/tools/telegram-tools/send-message.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+declare const sendMessageParams: z.ZodObject<{
+    chatId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    text: z.ZodString;
+}, z.core.$strip>;
+type SendMessageParams = z.infer<typeof sendMessageParams>;
+export declare const sendMessageTool: {
+    readonly name: "SEND_MESSAGE";
+    readonly description: "Send a message to a Telegram chat or channel";
+    readonly parameters: z.ZodObject<{
+        chatId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    readonly execute: (params: SendMessageParams) => Promise<string>;
+};
+export {};

package/dist/tools/telegram-tools/send-message.js

@@ -0,0 +1,38 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { TelegramService } from "../../services/telegram-service.js";
+const sendMessageParams = z.object({
+    chatId: z
+        .union([z.string(), z.number()])
+        .describe("The chat ID or channel username (e.g., @channelname or -1001234567890)"),
+    text: z.string().min(1).describe("The message text to send"),
+});
+export const sendMessageTool = {
+    name: "SEND_MESSAGE",
+    description: "Send a message to a Telegram chat or channel",
+    parameters: sendMessageParams,
+    execute: async (params) => {
+        const telegramService = new TelegramService();
+        try {
+            const messageInfo = await telegramService.sendMessage(params.chatId, params.text);
+            return dedent `
+				Message sent successfully!
+
+				Message ID: ${messageInfo.messageId}
+				Chat ID: ${messageInfo.chatId}
+				Sent at: ${new Date(messageInfo.date * 1000).toISOString()}
+				Text: ${messageInfo.text || "N/A"}
+			`;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("BOT_TOKEN")) {
+                    return "Error: Telegram bot token is not configured. Please set the TELEGRAM_BOT_TOKEN environment variable.";
+                }
+                return `Error sending message: ${error.message}`;
+            }
+            return "An unknown error occurred while sending the message";
+        }
+    },
+};
+//# sourceMappingURL=send-message.js.map

package/dist/tools/telegram-tools/send-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.js","sourceRoot":"","sources":["../../../src/tools/telegram-tools/send-message.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC/B,QAAQ,CACR,wEAAwE,CACxE;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC5D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8CAA8C;IAC3D,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,EAAE;QAC5C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE9C,IAAI,CAAC;YACJ,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,WAAW,CACpD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,IAAI,CACX,CAAC;YAEF,OAAO,MAAM,CAAA;;;kBAGE,WAAW,CAAC,SAAS;eACxB,WAAW,CAAC,MAAM;eAClB,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;YAClD,WAAW,CAAC,IAAI,IAAI,KAAK;IACjC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBACzC,OAAO,sGAAsG,CAAC;gBAC/G,CAAC;gBACD,OAAO,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC;YAClD,CAAC;YACD,OAAO,qDAAqD,CAAC;QAC9D,CAAC;IACF,CAAC;CACQ,CAAC"}

package/dist/tools/twitter-tools/get-user-info.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+declare const getUserInfoParams: z.ZodObject<{
+    username: z.ZodString;
+}, z.core.$strip>;
+type GetUserInfoParams = z.infer<typeof getUserInfoParams>;
+export declare const getUserInfoTool: {
+    readonly name: "GET_USER_INFO";
+    readonly description: "Gets information about a Twitter user";
+    readonly parameters: z.ZodObject<{
+        username: z.ZodString;
+    }, z.core.$strip>;
+    readonly execute: (params: GetUserInfoParams) => Promise<string>;
+};
+export {};

package/dist/tools/twitter-tools/get-user-info.js

@@ -0,0 +1,38 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { TwitterService } from "../../services/twitter-service.js";
+const getUserInfoParams = z.object({
+    username: z.string().min(1).describe("The Twitter username to get information for"),
+});
+export const getUserInfoTool = {
+    name: "GET_USER_INFO",
+    description: "Gets information about a Twitter user",
+    parameters: getUserInfoParams,
+    execute: async (params) => {
+        const twitterService = new TwitterService();
+        try {
+            const user = await twitterService.getUserInfo(params.username);
+            return dedent `
+        User information retrieved successfully!
+
+        ID: ${user.id}
+        Name: ${user.name}
+        Username: ${user.username}
+        Description: ${user.description}
+        Followers: ${user.public_metrics?.followers_count}
+        Following: ${user.public_metrics?.following_count}
+        Tweets: ${user.public_metrics?.tweet_count}
+      `;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("Twitter API credentials")) {
+                    return "Error: Twitter API credentials are not configured. Please set the TWITTER_APP_KEY, TWITTER_APP_SECRET, TWITTER_ACCESS_TOKEN, and TWITTER_ACCESS_SECRET environment variables.";
+                }
+                return `Error getting user info: ${error.message}`;
+            }
+            return "An unknown error occurred while getting user info";
+        }
+    },
+};
+//# sourceMappingURL=get-user-info.js.map

package/dist/tools/twitter-tools/get-user-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-info.js","sourceRoot":"","sources":["../../../src/tools/twitter-tools/get-user-info.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CACpF,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,uCAAuC;IACpD,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,EAAE;QAC3C,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAE/D,OAAO,MAAM,CAAA;;;cAGL,IAAI,CAAC,EAAE;gBACL,IAAI,CAAC,IAAI;oBACL,IAAI,CAAC,QAAQ;uBACV,IAAI,CAAC,WAAW;qBAClB,IAAI,CAAC,cAAc,EAAE,eAAe;qBACpC,IAAI,CAAC,cAAc,EAAE,eAAe;kBACvC,IAAI,CAAC,cAAc,EAAE,WAAW;OAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBACtD,OAAO,+KAA+K,CAAC;gBACzL,CAAC;gBACD,OAAO,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,mDAAmD,CAAC;QAC7D,CAAC;IACH,CAAC;CACO,CAAC"}

package/dist/tools/twitter-tools/search-tweets.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+declare const searchTweetsParams: z.ZodObject<{
+    query: z.ZodString;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type SearchTweetsParams = z.infer<typeof searchTweetsParams>;
+export declare const searchTweetsTool: {
+    readonly name: "SEARCH_TWEETS";
+    readonly description: "Searches for recent tweets matching a query";
+    readonly parameters: z.ZodObject<{
+        query: z.ZodString;
+        maxResults: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly execute: (params: SearchTweetsParams) => Promise<string>;
+};
+export {};

package/dist/tools/twitter-tools/search-tweets.js

@@ -0,0 +1,51 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { TwitterService } from "../../services/twitter-service.js";
+const searchTweetsParams = z.object({
+    query: z.string().min(1).describe("The search query to use"),
+    maxResults: z
+        .number()
+        .int()
+        .min(10)
+        .max(100)
+        .default(10)
+        .describe("Maximum number of tweets to return (10-100)"),
+});
+export const searchTweetsTool = {
+    name: "SEARCH_TWEETS",
+    description: "Searches for recent tweets matching a query",
+    parameters: searchTweetsParams,
+    execute: async (params) => {
+        const twitterService = new TwitterService();
+        try {
+            const paginator = await twitterService.searchTweets(params.query, params.maxResults);
+            // .tweets returns TweetV2[], .meta returns the search metadata
+            const tweets = paginator.tweets;
+            const meta = paginator.meta;
+            if (!tweets || tweets.length === 0) {
+                return "No tweets found for the given query.";
+            }
+            const tweetList = tweets
+                .map((tweet) => dedent `
+				Tweet ID: ${tweet.id}
+				Text: ${tweet.text}
+			`)
+                .join("\n\n");
+            return dedent `
+				Tweets retrieved successfully! (${meta?.result_count ?? tweets.length} results)
+
+				${tweetList}
+			`;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("Twitter API credentials")) {
+                    return "Error: Twitter API credentials are not configured. Please set the TWITTER_APP_KEY, TWITTER_APP_SECRET, TWITTER_ACCESS_TOKEN, and TWITTER_ACCESS_SECRET environment variables.";
+                }
+                return `Error searching tweets: ${error.message}`;
+            }
+            return "An unknown error occurred while searching tweets";
+        }
+    },
+};
+//# sourceMappingURL=search-tweets.js.map

package/dist/tools/twitter-tools/search-tweets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tweets.js","sourceRoot":"","sources":["../../../src/tools/twitter-tools/search-tweets.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC5D,UAAU,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,6CAA6C,CAAC;CACzD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,6CAA6C;IAC1D,UAAU,EAAE,kBAAkB;IAC9B,OAAO,EAAE,KAAK,EAAE,MAA0B,EAAE,EAAE;QAC7C,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QAE5C,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,CAClD,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,UAAU,CACjB,CAAC;YAEF,+DAA+D;YAC/D,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAChC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;YAE5B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,sCAAsC,CAAC;YAC/C,CAAC;YAED,MAAM,SAAS,GAAG,MAAM;iBACtB,GAAG,CACH,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAA;gBACN,KAAK,CAAC,EAAE;YACZ,KAAK,CAAC,IAAI;IAClB,CACC;iBACA,IAAI,CAAC,MAAM,CAAC,CAAC;YAEf,OAAO,MAAM,CAAA;sCACsB,IAAI,EAAE,YAAY,IAAI,MAAM,CAAC,MAAM;;MAEnE,SAAS;IACX,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBACvD,OAAO,+KAA+K,CAAC;gBACxL,CAAC;gBACD,OAAO,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC;YACnD,CAAC;YACD,OAAO,kDAAkD,CAAC;QAC3D,CAAC;IACF,CAAC;CACQ,CAAC"}

package/dist/tools/twitter-tools/send-tweet.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+declare const sendTweetParams: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+type SendTweetParams = z.infer<typeof sendTweetParams>;
+export declare const sendTweetTool: {
+    readonly name: "SEND_TWEET";
+    readonly description: "Sends a tweet";
+    readonly parameters: z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>;
+    readonly execute: (params: SendTweetParams) => Promise<string>;
+};
+export {};

package/dist/tools/twitter-tools/send-tweet.js

@@ -0,0 +1,33 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { TwitterService } from "../../services/twitter-service.js";
+const sendTweetParams = z.object({
+    text: z.string().min(1).max(280).describe("The text of the tweet to send"),
+});
+export const sendTweetTool = {
+    name: "SEND_TWEET",
+    description: "Sends a tweet",
+    parameters: sendTweetParams,
+    execute: async (params) => {
+        const twitterService = new TwitterService();
+        try {
+            const tweet = await twitterService.sendTweet(params.text);
+            return dedent `
+        Tweet sent successfully!
+
+        Tweet ID: ${tweet.id}
+        Text: ${tweet.text}
+      `;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("Twitter API credentials")) {
+                    return "Error: Twitter API credentials are not configured. Please set the TWITTER_APP_KEY, TWITTER_APP_SECRET, TWITTER_ACCESS_TOKEN, and TWITTER_ACCESS_SECRET environment variables.";
+                }
+                return `Error sending tweet: ${error.message}`;
+            }
+            return "An unknown error occurred while sending the tweet";
+        }
+    },
+};
+//# sourceMappingURL=send-tweet.js.map

package/dist/tools/twitter-tools/send-tweet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-tweet.js","sourceRoot":"","sources":["../../../src/tools/twitter-tools/send-tweet.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC3E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,eAAe;IAC3B,OAAO,EAAE,KAAK,EAAE,MAAuB,EAAE,EAAE;QACzC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE1D,OAAO,MAAM,CAAA;;;oBAGC,KAAK,CAAC,EAAE;gBACZ,KAAK,CAAC,IAAI;OACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBACtD,OAAO,+KAA+K,CAAC;gBACzL,CAAC;gBACD,OAAO,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC;YACjD,CAAC;YACD,OAAO,mDAAmD,CAAC;QAC7D,CAAC;IACH,CAAC;CACO,CAAC"}

package/dist/tools/whatsapp-tools/get-messages.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+declare const getMessagesParams: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+type GetMessagesParams = z.infer<typeof getMessagesParams>;
+export declare const getMessagesTool: {
+    readonly name: "GET_WHATSAPP_MESSAGES";
+    readonly description: "Retrieve recent WhatsApp messages";
+    readonly parameters: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>;
+    readonly execute: (params: GetMessagesParams) => Promise<string>;
+};
+export {};

package/dist/tools/whatsapp-tools/get-messages.js

@@ -0,0 +1,54 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { WhatsappService } from "../../services/whatsapp-service.js";
+// Define a schema for a single WhatsApp message
+const whatsappMessageDetailSchema = z.object({
+    id: z.string().describe("The unique ID of the message"),
+    from: z.string().describe("The sender's phone number"),
+    text: z.object({ body: z.string() }).optional().describe("The message text content"),
+    // Add other relevant fields if available from the API, e.g., timestamp, type, etc.
+});
+// Define a schema for the list of messages
+const getMessagesResponseSchema = z.object({
+    data: z.array(whatsappMessageDetailSchema),
+});
+const getMessagesParams = z.object({
+    limit: z.number().optional().default(10).describe("Maximum number of messages to retrieve"),
+});
+export const getMessagesTool = {
+    name: "GET_WHATSAPP_MESSAGES",
+    description: "Retrieve recent WhatsApp messages",
+    parameters: getMessagesParams,
+    execute: async (params) => {
+        const whatsappService = new WhatsappService();
+        try {
+            // Assuming WhatsappService has a method like getMessages that takes a limit.
+            // The actual implementation might differ based on WhatsApp API capabilities.
+            const messages = await whatsappService.getMessages(params.limit);
+            if (!messages || messages.data.length === 0) {
+                return "No recent WhatsApp messages found.";
+            }
+            const messageList = messages.data.map((message, index) => dedent `
+        ${index + 1}. Message ID: ${message.id}
+           From: ${message.from}
+           Text: ${message.text?.body || "N/A"}
+      `).join("\n\n");
+            return dedent `
+        Recent WhatsApp Messages (retrieved ${messages.data.length}):
+
+        ${messageList}
+      `;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("WHATSAPP_ACCESS_TOKEN")) {
+                    return "Error: WhatsApp access token is not configured. Please set the WHATSAPP_ACCESS_TOKEN environment variable.";
+                }
+                // Handle potential errors from the getMessages method itself
+                return `Error retrieving WhatsApp messages: ${error.message}`;
+            }
+            return "An unknown error occurred while retrieving WhatsApp messages";
+        }
+    },
+};
+//# sourceMappingURL=get-messages.js.map

package/dist/tools/whatsapp-tools/get-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-messages.js","sourceRoot":"","sources":["../../../src/tools/whatsapp-tools/get-messages.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,gDAAgD;AAChD,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACpF,mFAAmF;CACpF,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CAC5F,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,mCAAmC;IAChD,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,EAAE;QAC3C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,6EAA6E;YAC7E,6EAA6E;YAC7E,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEjE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5C,OAAO,oCAAoC,CAAC;YAC9C,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAoD,EAAE,KAAa,EAAE,EAAE,CAAC,MAAM,CAAA;UACjH,KAAK,GAAG,CAAC,iBAAiB,OAAO,CAAC,EAAE;mBAC3B,OAAO,CAAC,IAAI;mBACZ,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,KAAK;OACvC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO,MAAM,CAAA;8CAC2B,QAAQ,CAAC,IAAI,CAAC,MAAM;;UAExD,WAAW;OACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;oBACpD,OAAO,4GAA4G,CAAC;gBACtH,CAAC;gBACD,6DAA6D;gBAC7D,OAAO,uCAAuC,KAAK,CAAC,OAAO,EAAE,CAAC;YAChE,CAAC;YACD,OAAO,8DAA8D,CAAC;QACxE,CAAC;IACH,CAAC;CACO,CAAC"}

package/dist/tools/whatsapp-tools/send-message.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+declare const sendMessageParams: z.ZodObject<{
+    to: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>;
+type SendMessageParams = z.infer<typeof sendMessageParams>;
+export declare const sendMessageTool: {
+    readonly name: "SEND_WHATSAPP_MESSAGE";
+    readonly description: "Send a message to a WhatsApp user";
+    readonly parameters: z.ZodObject<{
+        to: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    readonly execute: (params: SendMessageParams) => Promise<string>;
+};
+export {};

package/dist/tools/whatsapp-tools/send-message.js

@@ -0,0 +1,34 @@
+import dedent from "dedent";
+import { z } from "zod";
+import { WhatsappService } from "../../services/whatsapp-service.js";
+const sendMessageParams = z.object({
+    to: z.string().describe("The recipient's phone number"),
+    text: z.string().min(1).describe("The message text to send"),
+});
+export const sendMessageTool = {
+    name: "SEND_WHATSAPP_MESSAGE",
+    description: "Send a message to a WhatsApp user",
+    parameters: sendMessageParams,
+    execute: async (params) => {
+        const whatsappService = new WhatsappService();
+        try {
+            const message = await whatsappService.sendMessage(params.to, params.text);
+            return dedent `
+        Message sent successfully via WhatsApp!
+
+        Message ID: ${message.messages[0].id}
+        Recipient: ${message.contacts[0].input}
+      `;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes("WHATSAPP_ACCESS_TOKEN")) {
+                    return "Error: WhatsApp access token is not configured. Please set the WHATSAPP_ACCESS_TOKEN environment variable.";
+                }
+                return `Error sending message: ${error.message}`;
+            }
+            return "An unknown error occurred while sending the message";
+        }
+    },
+};
+//# sourceMappingURL=send-message.js.map

package/dist/tools/whatsapp-tools/send-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.js","sourceRoot":"","sources":["../../../src/tools/whatsapp-tools/send-message.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC7D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,mCAAmC;IAChD,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,EAAE;QAC3C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAE1E,OAAO,MAAM,CAAA;;;sBAGG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;qBACvB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK;OACvC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;oBACpD,OAAO,4GAA4G,CAAC;gBACtH,CAAC;gBACD,OAAO,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC;YACnD,CAAC;YACD,OAAO,qDAAqD,CAAC;QAC/D,CAAC;IACH,CAAC;CACO,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export interface UserContext {
+    userId?: string;
+    sessionId?: string;
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+// src/types.ts
+export {};
+// Add more shared types for your tools, services, and libraries
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAe;;AAQf,gEAAgE"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "social-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for posting and interacting across social media platforms: Twitter, Instagram, Facebook, WhatsApp, Discord, Telegram, and Slack",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "social-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nxGnosis/social-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nxGnosis/social-mcp/issues"
+  },
+  "homepage": "https://github.com/nxGnosis/social-mcp#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "social-media",
+    "twitter",
+    "instagram",
+    "facebook",
+    "whatsapp",
+    "discord",
+    "telegram",
+    "slack",
+    "ai",
+    "llm",
+    "automation"
+  ],
+  "author": "Lanre Sanni",
+  "license": "ISC",
+  "dependencies": {
+    "@slack/web-api": "^7.14.1",
+    "dedent": "^1.7.1",
+    "dotenv": "^17.3.1",
+    "fastmcp": "^3.33.0",
+    "telegraf": "^4.16.3",
+    "twitter-api-v2": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "*",
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^22.15.19",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.2",
+    "shx": "^0.3.4",
+    "typescript": "^5.8.3",
+    "ts-node": "^10.9.2"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc && shx chmod +x dist/index.js",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "release": "pnpm run build && changeset publish",
+    "format": "biome format . --write",
+    "lint": "biome check ."
+  }
+}