outx-mcp-server 1.0.0

package/dist/tools/watchlists.js

@@ -0,0 +1,177 @@
+import { z } from "zod";
+const fetchFreqEnum = z
+    .enum(["1", "3", "6", "12", "24", "48", "72"])
+    .describe("How often to scan for new posts (hours)");
+export function registerWatchlistTools(server, client) {
+    // ── Keyword Watchlists ──────────────────────────────────
+    server.tool("create_keyword_watchlist", "Create a watchlist that monitors LinkedIn posts matching keywords. Posts appear after the first scan cycle.", {
+        keywords: z
+            .array(z.string())
+            .min(1)
+            .describe("Keywords to track (e.g. ['AI startup funding', 'series A'])"),
+        required_keywords: z
+            .array(z.string())
+            .optional()
+            .describe("Posts MUST contain at least one of these words"),
+        exclude_keywords: z
+            .array(z.string())
+            .optional()
+            .describe("Exclude posts containing any of these words"),
+        name: z.string().optional().describe("Watchlist name"),
+        description: z.string().optional(),
+        labels: z.array(z.string()).optional().describe("Custom labels for categorization"),
+        fetchFreqInHours: fetchFreqEnum.optional(),
+    }, async (params) => {
+        const body = {
+            keywords: params.keywords.map((kw) => {
+                const obj = { keyword: kw };
+                if (params.required_keywords)
+                    obj.required_keywords = params.required_keywords;
+                if (params.exclude_keywords)
+                    obj.exclude_keywords = params.exclude_keywords;
+                return obj;
+            }),
+        };
+        if (params.name)
+            body.name = params.name;
+        if (params.description)
+            body.description = params.description;
+        if (params.labels)
+            body.labels = params.labels;
+        if (params.fetchFreqInHours)
+            body.fetchFreqInHours = parseInt(params.fetchFreqInHours);
+        const result = await client.post("/api-keyword-watchlist", body);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("list_keyword_watchlists", "List all keyword watchlists for your account.", {}, async () => {
+        const result = await client.get("/api-keyword-watchlist");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("update_keyword_watchlist", "Update a keyword watchlist's name, frequency, or status.", {
+        id: z.string().describe("Watchlist ID"),
+        name: z.string().optional(),
+        fetchFreqInHours: fetchFreqEnum.optional(),
+        status: z.enum(["active", "paused"]).optional(),
+    }, async (params) => {
+        const body = { id: params.id };
+        if (params.name)
+            body.name = params.name;
+        if (params.fetchFreqInHours)
+            body.fetchFreqInHours = parseInt(params.fetchFreqInHours);
+        if (params.status)
+            body.status = params.status;
+        const result = await client.put("/api-keyword-watchlist", body);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("delete_keyword_watchlist", "Delete a keyword watchlist and all its tracked data.", {
+        id: z.string().describe("Watchlist ID to delete"),
+    }, async (params) => {
+        const result = await client.delete("/api-keyword-watchlist", {
+            id: params.id,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── People Watchlists ───────────────────────────────────
+    server.tool("create_people_watchlist", "Create a watchlist that monitors posts from specific LinkedIn profiles.", {
+        profiles: z
+            .array(z.string())
+            .min(1)
+            .describe("LinkedIn profile URLs or slugs to track"),
+        name: z.string().optional().describe("Watchlist name"),
+        description: z.string().optional(),
+        labels: z.array(z.string()).optional(),
+        fetchFreqInHours: fetchFreqEnum.optional(),
+    }, async (params) => {
+        const body = { profiles: params.profiles };
+        if (params.name)
+            body.name = params.name;
+        if (params.description)
+            body.description = params.description;
+        if (params.labels)
+            body.labels = params.labels;
+        if (params.fetchFreqInHours)
+            body.fetchFreqInHours = parseInt(params.fetchFreqInHours);
+        const result = await client.post("/api-people-watchlist", body);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("list_people_watchlists", "List all people watchlists for your account.", {}, async () => {
+        const result = await client.get("/api-people-watchlist");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("update_people_watchlist", "Update a people watchlist's name, frequency, or status.", {
+        id: z.string().describe("Watchlist ID"),
+        name: z.string().optional(),
+        fetchFreqInHours: fetchFreqEnum.optional(),
+        status: z.enum(["active", "paused"]).optional(),
+    }, async (params) => {
+        const body = { id: params.id };
+        if (params.name)
+            body.name = params.name;
+        if (params.fetchFreqInHours)
+            body.fetchFreqInHours = parseInt(params.fetchFreqInHours);
+        if (params.status)
+            body.status = params.status;
+        const result = await client.put("/api-people-watchlist", body);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("delete_people_watchlist", "Delete a people watchlist and all its tracked data.", {
+        id: z.string().describe("Watchlist ID to delete"),
+    }, async (params) => {
+        const result = await client.delete("/api-people-watchlist", {
+            id: params.id,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── Company Watchlists ──────────────────────────────────
+    server.tool("create_company_watchlist", "Create a watchlist that monitors posts from LinkedIn company pages.", {
+        companies: z
+            .array(z.string())
+            .min(1)
+            .describe("LinkedIn company URLs or slugs to track"),
+        name: z.string().optional().describe("Watchlist name"),
+        description: z.string().optional(),
+        labels: z.array(z.string()).optional(),
+        fetchFreqInHours: fetchFreqEnum.optional(),
+    }, async (params) => {
+        const body = { companies: params.companies };
+        if (params.name)
+            body.name = params.name;
+        if (params.description)
+            body.description = params.description;
+        if (params.labels)
+            body.labels = params.labels;
+        if (params.fetchFreqInHours)
+            body.fetchFreqInHours = parseInt(params.fetchFreqInHours);
+        const result = await client.post("/api-company-watchlist", body);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("list_company_watchlists", "List all company watchlists for your account.", {}, async () => {
+        const result = await client.get("/api-company-watchlist");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("update_company_watchlist", "Update a company watchlist's name, frequency, or status.", {
+        id: z.string().describe("Watchlist ID"),
+        name: z.string().optional(),
+        fetchFreqInHours: fetchFreqEnum.optional(),
+        status: z.enum(["active", "paused"]).optional(),
+    }, async (params) => {
+        const body = { id: params.id };
+        if (params.name)
+            body.name = params.name;
+        if (params.fetchFreqInHours)
+            body.fetchFreqInHours = parseInt(params.fetchFreqInHours);
+        if (params.status)
+            body.status = params.status;
+        const result = await client.put("/api-company-watchlist", body);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("delete_company_watchlist", "Delete a company watchlist and all its tracked data.", {
+        id: z.string().describe("Watchlist ID to delete"),
+    }, async (params) => {
+        const result = await client.delete("/api-company-watchlist", {
+            id: params.id,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=watchlists.js.map

package/dist/tools/watchlists.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "outx-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for OutX — LinkedIn social listening & data API",
+  "main": "dist/index.js",
+  "bin": {
+    "outx-mcp-server": "dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "outx",
+    "linkedin",
+    "social-listening",
+    "linkedin-api",
+    "ai-agents"
+  ],
+  "author": "OutX AI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/outxai/outx-mcp-server.git"
+  },
+  "homepage": "https://outx.ai",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,105 @@
+/**
+ * OutX API client — shared HTTP wrapper with auth, error handling, and async task polling.
+ */
+
+export class OutxClient {
+  private baseUrl = "https://api.outx.ai";
+  private apiKey: string;
+
+  constructor(apiKey: string) {
+    this.apiKey = apiKey;
+  }
+
+  private headers(): Record<string, string> {
+    return {
+      "x-api-key": this.apiKey,
+      "Content-Type": "application/json",
+    };
+  }
+
+  private async handleResponse(res: Response): Promise<unknown> {
+    if (!res.ok) {
+      let message = `HTTP ${res.status}`;
+      try {
+        const body = await res.json();
+        if (body.error) message = body.error;
+        else if (body.message) message = body.message;
+        else message = JSON.stringify(body);
+      } catch {
+        message = await res.text().catch(() => message);
+      }
+      throw new Error(message);
+    }
+    return res.json();
+  }
+
+  async get(path: string, params?: Record<string, string>): Promise<unknown> {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "") url.searchParams.set(k, v);
+      }
+    }
+    const res = await fetch(url.toString(), { headers: this.headers() });
+    return this.handleResponse(res);
+  }
+
+  async post(path: string, body: unknown): Promise<unknown> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(body),
+    });
+    return this.handleResponse(res);
+  }
+
+  async put(path: string, body: unknown): Promise<unknown> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "PUT",
+      headers: this.headers(),
+      body: JSON.stringify(body),
+    });
+    return this.handleResponse(res);
+  }
+
+  async delete(path: string, body: unknown): Promise<unknown> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "DELETE",
+      headers: this.headers(),
+      body: JSON.stringify(body),
+    });
+    return this.handleResponse(res);
+  }
+
+  /**
+   * Poll an async LinkedIn Data API task until it completes or fails.
+   * Returns the task_output on success.
+   */
+  async pollTask(
+    taskId: string,
+    maxAttempts = 30,
+    delayMs = 5000
+  ): Promise<unknown> {
+    for (let i = 0; i < maxAttempts; i++) {
+      const result = (await this.get("/linkedin-agent/get-task-status", {
+        api_agent_task_id: taskId,
+      })) as { data: { status: string; task_output?: unknown } };
+
+      const { status, task_output } = result.data;
+
+      if (status === "completed") return task_output;
+      if (status === "failed") {
+        throw new Error(
+          `Task failed: ${task_output ? JSON.stringify(task_output) : "unknown error"}`
+        );
+      }
+
+      await new Promise((r) => setTimeout(r, delayMs));
+    }
+
+    throw new Error(
+      `Task ${taskId} did not complete within ${(maxAttempts * delayMs) / 1000}s. ` +
+        `Use get_task_status to check manually.`
+    );
+  }
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { OutxClient } from "./client.js";
+import { registerWatchlistTools } from "./tools/watchlists.js";
+import { registerPostTools } from "./tools/posts.js";
+import { registerEngagementTools } from "./tools/engagement.js";
+import { registerLinkedInTools } from "./tools/linkedin.js";
+
+const apiKey = process.env.OUTX_API_KEY;
+if (!apiKey) {
+  console.error(
+    "Error: OUTX_API_KEY environment variable is required.\n" +
+      "Get your key at https://mentions.outx.ai/api-doc"
+  );
+  process.exit(1);
+}
+
+const client = new OutxClient(apiKey);
+
+const server = new McpServer({
+  name: "outx",
+  version: "1.0.0",
+});
+
+registerWatchlistTools(server, client);
+registerPostTools(server, client);
+registerEngagementTools(server, client);
+registerLinkedInTools(server, client);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools/engagement.ts

@@ -0,0 +1,56 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { OutxClient } from "../client.js";
+
+export function registerEngagementTools(
+  server: McpServer,
+  client: OutxClient
+): void {
+  server.tool(
+    "like_post",
+    "Like a LinkedIn post from your watchlist. Requires the post ID from get_posts results.",
+    {
+      post_id: z.string().describe("Post ID from get_posts results"),
+      user_email: z.string().describe("Email of the LinkedIn account to like from"),
+      actor_type: z
+        .enum(["user", "company"])
+        .optional()
+        .describe("Like as user or company page (default: user)"),
+    },
+    async (params) => {
+      const body: Record<string, unknown> = {
+        post_id: params.post_id,
+        user_email: params.user_email,
+      };
+      if (params.actor_type) body.actor_type = params.actor_type;
+
+      const result = await client.post("/api-like", body);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "comment_on_post",
+    "Comment on a LinkedIn post from your watchlist. Requires the post ID from get_posts results.",
+    {
+      post_id: z.string().describe("Post ID from get_posts results"),
+      user_email: z.string().describe("Email of the LinkedIn account to comment from"),
+      comment_text: z.string().describe("The comment text to post"),
+      actor_type: z
+        .enum(["user", "company"])
+        .optional()
+        .describe("Comment as user or company page (default: user)"),
+    },
+    async (params) => {
+      const body: Record<string, unknown> = {
+        post_id: params.post_id,
+        user_email: params.user_email,
+        comment_text: params.comment_text,
+      };
+      if (params.actor_type) body.actor_type = params.actor_type;
+
+      const result = await client.post("/api-comment", body);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}

package/src/tools/linkedin.ts

@@ -0,0 +1,98 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { OutxClient } from "../client.js";
+
+export function registerLinkedInTools(
+  server: McpServer,
+  client: OutxClient
+): void {
+  server.tool(
+    "fetch_linkedin_profile",
+    "Fetch a LinkedIn profile by slug. Returns full profile data including name, headline, experience, education, and skills. Requires the OutX Chrome extension to be active within the last 48 hours. This tool handles async polling automatically.",
+    {
+      profile_slug: z
+        .string()
+        .describe("LinkedIn profile slug (e.g. 'williamhgates' from linkedin.com/in/williamhgates)"),
+    },
+    async (params) => {
+      const response = (await client.post("/linkedin-agent/fetch-profile", {
+        profile_slug: params.profile_slug,
+      })) as { api_agent_task_id: string };
+
+      const result = await client.pollTask(response.api_agent_task_id);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "fetch_linkedin_posts",
+    "Fetch recent posts from LinkedIn profiles by URN. Use fetch_linkedin_profile first to get the profile URN. Requires the OutX Chrome extension to be active. This tool handles async polling automatically.",
+    {
+      profile_urns: z
+        .array(z.string())
+        .min(1)
+        .describe("LinkedIn profile URNs (e.g. ['urn:li:fsd_profile:ABC123'])"),
+    },
+    async (params) => {
+      const response = (await client.post(
+        "/linkedin-agent/fetch-profiles-posts",
+        { profile_urns: params.profile_urns }
+      )) as { api_agent_task_id: string };
+
+      const result = await client.pollTask(response.api_agent_task_id);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "linkedin_like_post",
+    "Like a LinkedIn post by its activity URN. This uses the LinkedIn Data API (direct LinkedIn action). Requires the OutX Chrome extension to be active. This tool handles async polling automatically.",
+    {
+      social_urn: z
+        .string()
+        .describe("LinkedIn activity URN of the post to like"),
+    },
+    async (params) => {
+      const response = (await client.post("/linkedin-agent/like-post", {
+        social_urn: params.social_urn,
+      })) as { api_agent_task_id: string };
+
+      const result = await client.pollTask(response.api_agent_task_id);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "linkedin_comment_on_post",
+    "Comment on a LinkedIn post by its activity URN. This uses the LinkedIn Data API (direct LinkedIn action). Requires the OutX Chrome extension to be active. This tool handles async polling automatically.",
+    {
+      social_urn: z
+        .string()
+        .describe("LinkedIn activity URN of the post to comment on"),
+      comment_text: z.string().describe("The comment text to post"),
+    },
+    async (params) => {
+      const response = (await client.post("/linkedin-agent/comment-post", {
+        social_urn: params.social_urn,
+        comment_text: params.comment_text,
+      })) as { api_agent_task_id: string };
+
+      const result = await client.pollTask(response.api_agent_task_id);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "get_task_status",
+    "Check the status of an async LinkedIn Data API task. Use this to manually check tasks that timed out. Status values: pending, processing, completed, failed.",
+    {
+      task_id: z.string().describe("The api_agent_task_id to check"),
+    },
+    async (params) => {
+      const result = await client.get("/linkedin-agent/get-task-status", {
+        api_agent_task_id: params.task_id,
+      });
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}

package/src/tools/posts.ts

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { OutxClient } from "../client.js";
+
+export function registerPostTools(
+  server: McpServer,
+  client: OutxClient
+): void {
+  server.tool(
+    "get_posts",
+    "Search and filter LinkedIn posts from your watchlists. Supports keyword search, date range, seniority, trending, language, and more. Returns 20 posts per page.",
+    {
+      watchlist_id: z.string().optional().describe("Filter by watchlist ID (omit for all)"),
+      search_term: z.string().optional().describe("Search within post content"),
+      sort_by: z
+        .enum(["recent_first", "oldest_first", "engagement"])
+        .optional()
+        .describe("Sort order (default: recent_first)"),
+      page: z.string().optional().describe("Page number (default: 1)"),
+      start_date: z.string().optional().describe("Filter posts after this date (ISO 8601)"),
+      end_date: z.string().optional().describe("Filter posts before this date (ISO 8601)"),
+      seniority_level: z.string().optional().describe("Filter by author seniority (e.g. 'Director', 'VP')"),
+      trending: z.string().optional().describe("Set to 'true' to show only trending posts"),
+      lang: z.string().optional().describe("Filter by language code (e.g. 'en', 'es')"),
+      post_type: z.string().optional().describe("Filter by post type"),
+      labels: z.string().optional().describe("Filter by label"),
+      people_slug: z.string().optional().describe("Filter by author's LinkedIn slug"),
+      company_slug: z.string().optional().describe("Filter by company's LinkedIn slug"),
+      interacted: z.string().optional().describe("Set to 'true' to show only posts you've interacted with"),
+      linkedin_post_slug: z.string().optional().describe("Get a specific post by its LinkedIn slug"),
+    },
+    async (params) => {
+      const queryParams: Record<string, string> = {};
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined) queryParams[k] = v;
+      }
+      const result = await client.get("/api-posts", queryParams);
+      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}