outx-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OutX AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,217 @@
+# OutX MCP Server
+
+[![npm version](https://img.shields.io/npm/v/outx-mcp-server.svg)](https://www.npmjs.com/package/outx-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for the [OutX](https://outx.ai) LinkedIn social listening and data API. Connect AI agents like Claude, Cursor, and Claude Code to LinkedIn — create watchlists, search posts, fetch profiles, and engage, all through natural language.
+
+<p align="center">
+  <code>AI Agent ←→ MCP Protocol ←→ OutX MCP Server ←→ OutX API ←→ LinkedIn</code>
+</p>
+
+## What You Can Do
+
+- **Monitor LinkedIn** — Track posts by keywords, people, or companies with watchlists
+- **Search & filter posts** — 15+ filters: keyword, date, seniority, trending, language
+- **Fetch profiles** — Get full LinkedIn profiles: name, headline, experience, education, skills
+- **Engage** — Like and comment on posts through your LinkedIn account
+- **All via natural language** — Just tell your AI agent what you want
+
+## Quick Start
+
+**1. Get an API key** at [mentions.outx.ai/api-doc](https://mentions.outx.ai/api-doc)
+
+**2. Add to your AI tool** (pick one):
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "outx": {
+      "command": "npx",
+      "args": ["-y", "outx-mcp-server"],
+      "env": {
+        "OUTX_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "outx": {
+      "command": "npx",
+      "args": ["-y", "outx-mcp-server"],
+      "env": {
+        "OUTX_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+Add to `.mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "outx": {
+      "command": "npx",
+      "args": ["-y", "outx-mcp-server"],
+      "env": {
+        "OUTX_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "outx": {
+      "command": "npx",
+      "args": ["-y", "outx-mcp-server"],
+      "env": {
+        "OUTX_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+**3. Start using it:**
+
+> "Create a watchlist to monitor LinkedIn posts about AI startups raising Series A"
+
+## Available Tools (20)
+
+### Watchlist Management
+
+| Tool | Description |
+|------|-------------|
+| `create_keyword_watchlist` | Monitor LinkedIn posts matching keywords with optional required/excluded terms |
+| `list_keyword_watchlists` | List all keyword watchlists |
+| `update_keyword_watchlist` | Update name, scan frequency, or pause/resume |
+| `delete_keyword_watchlist` | Delete a keyword watchlist and all tracked data |
+| `create_people_watchlist` | Track posts from specific LinkedIn profiles |
+| `list_people_watchlists` | List all people watchlists |
+| `update_people_watchlist` | Update name, scan frequency, or pause/resume |
+| `delete_people_watchlist` | Delete a people watchlist |
+| `create_company_watchlist` | Monitor posts from LinkedIn company pages |
+| `list_company_watchlists` | List all company watchlists |
+| `update_company_watchlist` | Update name, scan frequency, or pause/resume |
+| `delete_company_watchlist` | Delete a company watchlist |
+
+### Posts & Engagement
+
+| Tool | Description |
+|------|-------------|
+| `get_posts` | Search and filter posts from watchlists (keyword, date, seniority, trending, language, etc.) |
+| `like_post` | Like a post from your watchlist results |
+| `comment_on_post` | Comment on a post from your watchlist results |
+
+### LinkedIn Data API
+
+These tools use the async LinkedIn Data API. The MCP server handles polling automatically — you get the result directly.
+
+| Tool | Description |
+|------|-------------|
+| `fetch_linkedin_profile` | Fetch full LinkedIn profile by slug (name, headline, experience, education, skills) |
+| `fetch_linkedin_posts` | Fetch recent posts from profiles by URN |
+| `linkedin_like_post` | Like a post by activity URN |
+| `linkedin_comment_on_post` | Comment on a post by activity URN |
+| `get_task_status` | Check status of an async task manually |
+
+> **Note:** LinkedIn Data tools require the [OutX Chrome extension](https://outx.ai/docs/resources/chrome-extension) to be active within the last 48 hours.
+
+## Example Prompts
+
+Once connected, try these with your AI agent:
+
+**Social listening:**
+- "Create a watchlist to monitor LinkedIn posts about AI startups raising Series A"
+- "Show me trending posts from my watchlists this week"
+- "What are VPs and Directors posting about machine learning?"
+- "Find posts mentioning our competitor from the last 7 days"
+
+**Profile research:**
+- "Fetch the LinkedIn profile for williamhgates"
+- "Get recent posts from this prospect's profile"
+
+**Engagement:**
+- "Like the top 3 most engaging posts about product management"
+- "Comment on this post with a thoughtful response"
+
+**Workflows:**
+- "Set up a watchlist for 'looking for a CRM' and check it every 6 hours"
+- "List all my watchlists and show me posts from the sales signals one"
+
+## Prerequisites
+
+- **Node.js 18+** — Required for the MCP server runtime
+- **OutX account** — [Sign up free](https://mentions.outx.ai/login) and get your API key
+- **OutX Chrome extension** — Required for LinkedIn Data API tools (profile fetching, direct engagement). [Install here](https://outx.ai/docs/resources/chrome-extension)
+
+## How It Works
+
+The OutX API has two surfaces:
+
+1. **Watchlists & Engagement API** (sync) — Create watchlists to monitor LinkedIn by keywords, people, or companies. OutX scans on your schedule and stores posts. Query and engage via API.
+
+2. **LinkedIn Data API** (async) — Direct LinkedIn proxy. Fetch profiles, get posts, like, comment. All endpoints return a task ID; the MCP server polls automatically until the result is ready.
+
+The MCP server wraps both APIs into 20 tools that any MCP-compatible AI agent can call.
+
+## Development
+
+```bash
+git clone https://github.com/outxai/outx-mcp-server.git
+cd outx-mcp-server
+npm install
+npm run build
+OUTX_API_KEY=your-key npm start
+```
+
+For development with auto-reload:
+
+```bash
+OUTX_API_KEY=your-key npm run dev
+```
+
+## Links
+
+- [OutX Platform](https://outx.ai) — Sign up and get started
+- [API Documentation](https://outx.ai/docs/api-reference/introduction) — Full API reference
+- [MCP Integration Guide](https://outx.ai/docs/integrations/mcp) — Detailed setup docs
+- [Get API Key](https://mentions.outx.ai/api-doc) — Generate your key
+- [Chrome Extension](https://outx.ai/docs/resources/chrome-extension) — Required for LinkedIn Data tools
+- [Python SDK](https://outx.ai/docs/integrations/python-sdk) — Python wrapper for the API
+- [LangChain Integration](https://outx.ai/docs/integrations/langchain) — Use OutX as a LangChain tool
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OutX API client — shared HTTP wrapper with auth, error handling, and async task polling.
+ */
+export declare class OutxClient {
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string);
+    private headers;
+    private handleResponse;
+    get(path: string, params?: Record<string, string>): Promise<unknown>;
+    post(path: string, body: unknown): Promise<unknown>;
+    put(path: string, body: unknown): Promise<unknown>;
+    delete(path: string, body: unknown): Promise<unknown>;
+    /**
+     * Poll an async LinkedIn Data API task until it completes or fails.
+     * Returns the task_output on success.
+     */
+    pollTask(taskId: string, maxAttempts?: number, delayMs?: number): Promise<unknown>;
+}

package/dist/client.js

@@ -0,0 +1,91 @@
+/**
+ * OutX API client — shared HTTP wrapper with auth, error handling, and async task polling.
+ */
+export class OutxClient {
+    baseUrl = "https://api.outx.ai";
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    headers() {
+        return {
+            "x-api-key": this.apiKey,
+            "Content-Type": "application/json",
+        };
+    }
+    async handleResponse(res) {
+        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, params) {
+        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, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        return this.handleResponse(res);
+    }
+    async put(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "PUT",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        return this.handleResponse(res);
+    }
+    async delete(path, body) {
+        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, maxAttempts = 30, delayMs = 5000) {
+        for (let i = 0; i < maxAttempts; i++) {
+            const result = (await this.get("/linkedin-agent/get-task-status", {
+                api_agent_task_id: taskId,
+            }));
+            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.`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/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);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AACxC,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CACX,yDAAyD;QACvD,kDAAkD,CACrD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAEtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/engagement.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OutxClient } from "../client.js";
+export declare function registerEngagementTools(server: McpServer, client: OutxClient): void;

package/dist/tools/engagement.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export function registerEngagementTools(server, client) {
+    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 = {
+            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", 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 = {
+            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", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=engagement.js.map

package/dist/tools/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../../src/tools/engagement.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,MAAkB;IAElB,MAAM,CAAC,IAAI,CACT,WAAW,EACX,wFAAwF,EACxF;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAC7E,UAAU,EAAE,CAAC;aACV,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;QACF,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,8FAA8F,EAC9F;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAChF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAC7D,UAAU,EAAE,CAAC;aACV,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CAAC,iDAAiD,CAAC;KAC/D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC;QACF,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/linkedin.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OutxClient } from "../client.js";
+export declare function registerLinkedInTools(server: McpServer, client: OutxClient): void;

package/dist/tools/linkedin.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export function registerLinkedInTools(server, client) {
+    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,
+        }));
+        const result = await client.pollTask(response.api_agent_task_id);
+        return { content: [{ type: "text", 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 }));
+        const result = await client.pollTask(response.api_agent_task_id);
+        return { content: [{ type: "text", 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,
+        }));
+        const result = await client.pollTask(response.api_agent_task_id);
+        return { content: [{ type: "text", 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,
+        }));
+        const result = await client.pollTask(response.api_agent_task_id);
+        return { content: [{ type: "text", 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", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=linkedin.js.map

package/dist/tools/linkedin.js.map

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

package/dist/tools/posts.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OutxClient } from "../client.js";
+export declare function registerPostTools(server: McpServer, client: OutxClient): void;

package/dist/tools/posts.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function registerPostTools(server, client) {
+    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 = {};
+        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", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=posts.js.map

package/dist/tools/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAkB;IAElB,MAAM,CAAC,IAAI,CACT,WAAW,EACX,iKAAiK,EACjK;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACrF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACzE,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;aACpD,QAAQ,EAAE;aACV,QAAQ,CAAC,oCAAoC,CAAC;QACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACpF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACrG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACrF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACjF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACzD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC/E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QACjF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACrG,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KAC/F,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,SAAS;gBAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/watchlists.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OutxClient } from "../client.js";
+export declare function registerWatchlistTools(server: McpServer, client: OutxClient): void;