social-mcp 2.1.0 → 2.3.0

package/dist/tools/twitch-tools/get-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user.js","sourceRoot":"","sources":["../../../src/tools/twitch-tools/get-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEnF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IACxG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACjG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CAC7G,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,8FAA8F;IAC3G,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;QAC5B,IAAI,CAAC;YACJ,MAAM,OAAO,GACZ,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,YAAY;gBAC3B,CAAC,CAAC,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;gBAC3E,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAEvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI;gBAAE,OAAO,uBAAuB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;YAE/E,OAAO;gBACN,gBAAgB,IAAI,CAAC,YAAY,MAAM,IAAI,CAAC,KAAK,GAAG;gBACpD,EAAE;gBACF,OAAO,IAAI,CAAC,EAAE,EAAE;gBAChB,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,gBAAgB,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxF,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,gBAAgB;gBAAE,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;YACxE,OAAO,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;QAClG,CAAC;IACF,CAAC;CACQ,CAAC"}

package/dist/tools/twitch-tools/search-channels.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+declare const params: z.ZodObject<{
+    query: z.ZodString;
+    liveOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    first: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Params = z.infer<typeof params>;
+export declare const searchChannelsTool: {
+    readonly name: "TWITCH_SEARCH_CHANNELS";
+    readonly description: "Search Twitch channels by name. Optionally filter to live-only channels.";
+    readonly parameters: z.ZodObject<{
+        query: z.ZodString;
+        liveOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        first: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        clientId: z.ZodOptional<z.ZodString>;
+        clientSecret: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly execute: (p: Params) => Promise<string>;
+};
+export {};

package/dist/tools/twitch-tools/search-channels.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { CredentialsError } from "../../lib/errors.js";
+import { TwitchService, getTwitchService } from "../../services/twitch-service.js";
+const params = z.object({
+    query: z.string().min(1).describe("Search term (channel name or partial match)"),
+    liveOnly: z.boolean().optional().default(false).describe("Only return channels that are currently live"),
+    first: z.number().int().min(1).max(100).optional().default(10).describe("Number of results (default: 10, max: 100)"),
+    clientId: z.string().optional().describe("Twitch client ID (overrides TWITCH_CLIENT_ID env var)"),
+    clientSecret: z.string().optional().describe("Twitch client secret (overrides TWITCH_CLIENT_SECRET env var)"),
+});
+export const searchChannelsTool = {
+    name: "TWITCH_SEARCH_CHANNELS",
+    description: "Search Twitch channels by name. Optionally filter to live-only channels.",
+    parameters: params,
+    execute: async (p) => {
+        try {
+            const service = p.clientId && p.clientSecret
+                ? new TwitchService({ clientId: p.clientId, clientSecret: p.clientSecret })
+                : getTwitchService();
+            const result = await service.searchChannels(p.query, p.liveOnly ?? false, p.first ?? 10);
+            if (!result.data.length)
+                return `No channels found for "${p.query}".`;
+            return [
+                `Twitch Channel Search: "${p.query}" (${result.data.length} results)`,
+                ``,
+                ...result.data.map((c, i) => [
+                    `${i + 1}. ${c.display_name} (@${c.broadcaster_login}) ${c.is_live ? "[LIVE]" : ""}`,
+                    ...(c.title ? [`   Title: ${c.title}`] : []),
+                    ...(c.game_name ? [`   Category: ${c.game_name}`] : []),
+                    ...(c.tags?.length ? [`   Tags: ${c.tags.join(", ")}`] : []),
+                ].join("\n")),
+            ].join("\n");
+        }
+        catch (error) {
+            if (error instanceof CredentialsError)
+                return `Error: ${error.message}`;
+            return `Error searching Twitch channels: ${error instanceof Error ? error.message : "Unknown error"}`;
+        }
+    },
+};
+//# sourceMappingURL=search-channels.js.map

package/dist/tools/twitch-tools/search-channels.js.map

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

package/dist/tools/twitch-tools/send-chat-message.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+declare const params: z.ZodObject<{
+    broadcasterId: z.ZodString;
+    senderId: z.ZodString;
+    message: z.ZodString;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodString>;
+    accessToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Params = z.infer<typeof params>;
+export declare const sendChatMessageTool: {
+    readonly name: "TWITCH_SEND_CHAT_MESSAGE";
+    readonly description: "Send a message to a Twitch chat channel. Requires a user OAuth token with the 'chat:edit' scope (set TWITCH_ACCESS_TOKEN).";
+    readonly parameters: z.ZodObject<{
+        broadcasterId: z.ZodString;
+        senderId: z.ZodString;
+        message: z.ZodString;
+        clientId: z.ZodOptional<z.ZodString>;
+        clientSecret: z.ZodOptional<z.ZodString>;
+        accessToken: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly execute: (p: Params) => Promise<string>;
+};
+export {};

package/dist/tools/twitch-tools/send-chat-message.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { CredentialsError } from "../../lib/errors.js";
+import { TwitchService, getTwitchService } from "../../services/twitch-service.js";
+const params = z.object({
+    broadcasterId: z.string().describe("Channel ID to send the message to (get via TWITCH_GET_USER)"),
+    senderId: z.string().describe("User ID of the bot/user sending the message (must match the access token owner)"),
+    message: z.string().min(1).max(500).describe("Chat message content (max 500 characters)"),
+    clientId: z.string().optional().describe("Twitch client ID (overrides TWITCH_CLIENT_ID env var)"),
+    clientSecret: z.string().optional().describe("Twitch client secret (overrides TWITCH_CLIENT_SECRET env var)"),
+    accessToken: z.string().optional().describe("User OAuth token with chat:edit scope (overrides TWITCH_ACCESS_TOKEN env var)"),
+});
+export const sendChatMessageTool = {
+    name: "TWITCH_SEND_CHAT_MESSAGE",
+    description: "Send a message to a Twitch chat channel. Requires a user OAuth token with the 'chat:edit' scope (set TWITCH_ACCESS_TOKEN).",
+    parameters: params,
+    execute: async (p) => {
+        try {
+            const service = p.clientId && p.clientSecret
+                ? new TwitchService({ clientId: p.clientId, clientSecret: p.clientSecret, accessToken: p.accessToken })
+                : getTwitchService();
+            const result = await service.sendChatMessage(p.broadcasterId, p.senderId, p.message);
+            const sent = result.data[0];
+            if (!sent?.is_sent) {
+                return `Message was not sent. Response: ${JSON.stringify(result)}`;
+            }
+            return [
+                `Chat message sent to Twitch channel!`,
+                `Message ID: ${sent.message_id}`,
+                `Content: ${p.message}`,
+            ].join("\n");
+        }
+        catch (error) {
+            if (error instanceof CredentialsError)
+                return `Error: ${error.message}`;
+            return `Error sending Twitch chat message: ${error instanceof Error ? error.message : "Unknown error"}`;
+        }
+    },
+};
+//# sourceMappingURL=send-chat-message.js.map

package/dist/tools/twitch-tools/send-chat-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-chat-message.js","sourceRoot":"","sources":["../../../src/tools/twitch-tools/send-chat-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEnF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACjG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iFAAiF,CAAC;IAChH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACzF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACjG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC7G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;CAC5H,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACV,4HAA4H;IAC7H,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;QAC5B,IAAI,CAAC;YACJ,MAAM,OAAO,GACZ,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,YAAY;gBAC3B,CAAC,CAAC,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBACvG,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAEvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACrF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE5B,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;gBACpB,OAAO,mCAAmC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,CAAC;YAED,OAAO;gBACN,sCAAsC;gBACtC,eAAe,IAAI,CAAC,UAAU,EAAE;gBAChC,YAAY,CAAC,CAAC,OAAO,EAAE;aACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,gBAAgB;gBAAE,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;YACxE,OAAO,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;QACzG,CAAC;IACF,CAAC;CACQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "social-mcp",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "MCP server for posting and interacting across social media platforms: Twitter, Instagram, Facebook, WhatsApp, Discord, Telegram, Slack, LinkedIn, Reddit, Threads, TikTok, Pinterest, Medium, and Email (SMTP/SendGrid/Mailgun)",
   "main": "dist/index.js",
   "type": "module",