@updately/mcp-server 1.0.2 → 1.1.0

package/README.md

@@ -36,7 +36,7 @@ curl -X POST https://api.updately.ai/org/api-key/generate \
 }
 ```
 
-## Available Tools (30)
+## Available Tools (37)
 
 ### Campaigns
 - `list_campaigns` — List all campaigns
@@ -56,6 +56,19 @@ curl -X POST https://api.updately.ai/org/api-key/generate \
 - `enroll_contacts` — Add LinkedIn profiles
 - `remove_contact` — Remove a contact
 
+### Direct Outreach
+- `reach_out` — Send a LinkedIn message or connection invitation to one or more profiles. Auto-detects connection status: sends a DM if already connected, or a connection invite with the message as note if not. Auto-picks the org's LinkedIn account if not specified.
+
+### Lead Search
+- `search_leads` — Search for LinkedIn leads using natural language (e.g. "DevOps in SF, companies with 100+ employees", "VP of Sales at SaaS startups in NYC"). Returns matching profiles with name, headline, company, location, and LinkedIn URL.
+- `confirm_lead_action` — Confirm and execute a suggested action from search_leads (e.g. create a signal, ICP, or campaign from the results)
+
+### Social Listening
+- `list_keyword_groups` — List all keyword groups configured for social listening
+- `fetch_posts` — Fetch social-media posts matching keyword groups and/or platforms (Reddit, Twitter, LinkedIn, Quora, HackerNews, GitHub, StackOverflow). Returns scored, ranked posts with engagement metrics, sentiment, priority, and lead-type tags.
+- `save_post` — Save/bookmark a post for follow-up
+- `get_saved_posts` — List saved posts
+
 ### Scheduler
 - `run_campaign` — Trigger processing
 - `process_contact` — Process one contact now
@@ -76,7 +89,7 @@ curl -X POST https://api.updately.ai/org/api-key/generate \
 ### Signals
 - `list_signals` — List signals
 - `get_signal` — Get signal details
-- `create_signal` — Create a signal
+- `create_signal` — Create a signal (KEYWORD_GROUP, LINKEDIN_JOBS, PROFILE_SEARCH, or NETWORK)
 - `update_signal` — Update config
 - `run_signal` — Trigger a run
 - `delete_signal` — Delete

package/build/server.js

@@ -9,6 +9,8 @@ import { registerLeadTools } from "./tools/leads.js";
 import { registerSignalTools } from "./tools/signals.js";
 import { registerIcpTools } from "./tools/icp.js";
 import { registerOutreachTools } from "./tools/outreach.js";
+import { registerSocialListeningTools } from "./tools/social-listening.js";
+import { registerLeadSearchTools } from "./tools/lead-search.js";
 /**
  * Creates and configures the Updately MCP server with all tools registered.
  */
@@ -28,5 +30,7 @@ export function createServer() {
     registerSignalTools(server);
     registerIcpTools(server);
     registerOutreachTools(server);
+    registerSocialListeningTools(server);
+    registerLeadSearchTools(server);
     return server;
 }

package/build/tools/lead-search.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLeadSearchTools(server: McpServer): void;

package/build/tools/lead-search.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { apiPost, formatResponse } from "../api-client.js";
+export function registerLeadSearchTools(server) {
+    server.tool("search_leads", "Search for LinkedIn leads using a natural-language query. " +
+        "Examples: 'DevOps engineers in San Francisco at companies with 100+ employees', " +
+        "'VP of Sales at SaaS companies in New York', " +
+        "'founders of AI startups in Bangalore'. " +
+        "Returns matching LinkedIn profiles with name, headline, company, location, and profile URL.", {
+        query: z
+            .string()
+            .describe("Natural-language lead search query (e.g. 'DevOps in SF, companies with 100+ employees')"),
+    }, async ({ query }) => {
+        const res = await apiPost("/chat/action", { message: query });
+        return { content: [{ type: "text", text: formatResponse(res.data) }] };
+    });
+    server.tool("confirm_lead_action", "Confirm and execute a suggested action from search_leads. " +
+        "After search_leads returns results with a suggestion (e.g. create a signal, " +
+        "ICP, or campaign from the search), use this to confirm and execute it.", {
+        type: z
+            .enum(["leadSearch", "createSignal", "createIcp", "createCampaign"])
+            .describe("The action type returned by search_leads"),
+        suggestion: z
+            .record(z.unknown())
+            .describe("The suggestion object returned by search_leads — pass it as-is"),
+    }, async ({ type, suggestion }) => {
+        const res = await apiPost("/chat/confirm", {
+            type,
+            suggestion: suggestion,
+        });
+        return { content: [{ type: "text", text: formatResponse(res.data) }] };
+    });
+}

package/build/tools/signals.js

@@ -9,14 +9,23 @@ export function registerSignalTools(server) {
         const res = await apiGet(`/signals/${signalId}`);
         return { content: [{ type: "text", text: formatResponse(res.data) }] };
     });
-    server.tool("create_signal", "Create a new signal to auto-capture LinkedIn leads. Types: KEYWORD_GROUP (monitors posts matching keywords) or LINKEDIN_JOBS (scrapes job postings for hiring signals).", {
+    server.tool("create_signal", "Create a new signal to auto-capture LinkedIn leads. Types:\n" +
+        "• KEYWORD_GROUP — monitors social posts matching keywords and captures authors as leads\n" +
+        "• LINKEDIN_JOBS — scrapes job postings for hiring signals\n" +
+        "• PROFILE_SEARCH — searches LinkedIn profiles by title, industry, company size, location\n" +
+        "• NETWORK — discovers leads from your LinkedIn network by title/company/industry keywords", {
         name: z.string().describe("Signal name"),
         type: z
-            .enum(["KEYWORD_GROUP", "LINKEDIN_JOBS"])
+            .enum(["KEYWORD_GROUP", "LINKEDIN_JOBS", "PROFILE_SEARCH", "NETWORK"])
             .describe("Signal type"),
         listIds: z
             .array(z.string())
             .describe("Lead list IDs to fan captured leads into"),
+        enabled: z.boolean().optional().describe("Enable signal (default: true)"),
+        icpId: z
+            .string()
+            .optional()
+            .describe("ICP profile ID to filter captured leads"),
         // KEYWORD_GROUP fields
         keywordGroupIds: z
             .array(z.string())
@@ -39,11 +48,48 @@ export function registerSignalTools(server) {
             .number()
             .optional()
             .describe("How often to run in hours (min 24, default 24)"),
-        icpId: z
+        // PROFILE_SEARCH fields
+        searchKeywords: z
             .string()
             .optional()
-            .describe("ICP profile ID to filter captured leads"),
-        enabled: z.boolean().optional().describe("Enable signal (default: true)"),
+            .describe("Keywords for profile search (for PROFILE_SEARCH type)"),
+        searchTitle: z
+            .string()
+            .optional()
+            .describe("Job title filter (e.g. 'CTO', 'DevOps Engineer')"),
+        searchLocation: z
+            .string()
+            .optional()
+            .describe("Location for profile search (e.g. 'San Francisco')"),
+        searchCompanySizeMin: z
+            .number()
+            .optional()
+            .describe("Min company size (e.g. 50)"),
+        searchCompanySizeMax: z
+            .number()
+            .optional()
+            .describe("Max company size (e.g. 500)"),
+        searchMaxResults: z
+            .number()
+            .optional()
+            .describe("Max profiles to return (default: 25)"),
+        // NETWORK fields
+        networkTitleKeywords: z
+            .array(z.string())
+            .optional()
+            .describe("Title keywords to match in your network (for NETWORK type, e.g. ['CTO', 'VP Engineering'])"),
+        networkCompanyKeywords: z
+            .array(z.string())
+            .optional()
+            .describe("Company keywords to match (e.g. ['Google', 'Microsoft'])"),
+        networkIndustryKeywords: z
+            .array(z.string())
+            .optional()
+            .describe("Industry keywords to match (e.g. ['SaaS', 'Fintech'])"),
+        networkMaxResults: z
+            .number()
+            .optional()
+            .describe("Max network leads to return (default: 25)"),
     }, async (args) => {
         const res = await apiPost("/signals", args);
         return { content: [{ type: "text", text: formatResponse(res.data) }] };

package/build/tools/social-listening.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSocialListeningTools(server: McpServer): void;

package/build/tools/social-listening.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { apiGet, apiPost, formatResponse } from "../api-client.js";
+export function registerSocialListeningTools(server) {
+    server.tool("list_keyword_groups", "List all keyword groups configured for social listening. " +
+        "Each group has a name and a list of tracked keywords. " +
+        "Use the group names as filters in fetch_posts.", {}, async () => {
+        const res = await apiGet("/org/groupkeywords");
+        return { content: [{ type: "text", text: formatResponse(res.data) }] };
+    });
+    server.tool("fetch_posts", "Fetch social-media posts matching keyword groups and/or platforms. " +
+        "Returns scored, ranked posts with author info, engagement metrics, " +
+        "sentiment, priority (URGENT/HIGH/MEDIUM/LOW), and lead-type tags. " +
+        "Use list_keyword_groups first to get available group names.", {
+        keywordGroupNames: z
+            .array(z.string())
+            .optional()
+            .describe("Filter by keyword group names (e.g. ['AI Tools', 'DevOps']). " +
+            "Omit to fetch across all groups."),
+        platforms: z
+            .array(z.enum([
+            "REDDIT",
+            "TWITTER",
+            "LINKEDIN",
+            "QUORA",
+            "HACKER_NEWS",
+            "GITHUB",
+            "STACK_OVERFLOW",
+        ]))
+            .optional()
+            .describe("Filter by platform. Omit to fetch across all platforms."),
+        priorities: z
+            .array(z.enum(["P(-1)", "P(-2)", "P(-3)", "P(-4)"]))
+            .optional()
+            .describe("Filter by priority level: P(-1)=URGENT, P(-2)=HIGH, P(-3)=MEDIUM, P(-4)=LOW"),
+        sentiments: z
+            .array(z.enum(["POSITIVE", "NEGATIVE", "NEUTRAL"]))
+            .optional()
+            .describe("Filter by sentiment"),
+        sortBy: z
+            .enum(["LATEST", "RELEVANCE", "PRIORITY"])
+            .optional()
+            .describe("Sort order (default: RELEVANCE)"),
+        page: z
+            .number()
+            .optional()
+            .describe("Page number, 1-indexed (default: 1)"),
+        limit: z
+            .number()
+            .optional()
+            .describe("Results per page (default: 10, max: 50)"),
+    }, async ({ keywordGroupNames, platforms, priorities, sentiments, sortBy, page, limit, }) => {
+        const effectivePage = page ?? 1;
+        const effectiveLimit = Math.min(limit ?? 10, 50);
+        const body = {
+            sortField: sortBy ?? "RELEVANCE",
+            sortOrder: "DESC",
+            keywordGroupNameFilters: keywordGroupNames ?? [],
+            platformFilters: platforms ?? [],
+            priorityFilters: priorities ?? [],
+            sentimentFilters: sentiments ?? [],
+            leadTypeFilters: [],
+            offset: (effectivePage - 1) * effectiveLimit,
+            limit: effectiveLimit,
+            excludedUnifiedIds: [],
+        };
+        const res = await apiPost("/org/posts/fetch", body);
+        return { content: [{ type: "text", text: formatResponse(res) }] };
+    });
+    server.tool("save_post", "Save/bookmark a post from the social listening feed for follow-up later.", {
+        postId: z
+            .string()
+            .describe("The unifiedId of the post to save (from fetch_posts results)"),
+    }, async ({ postId }) => {
+        // The backend expects the full Post object; we pass minimal shape
+        const res = await apiPost("/org/posts/save", [
+            { post: { unifiedId: postId } },
+        ]);
+        return { content: [{ type: "text", text: formatResponse(res.data) }] };
+    });
+    server.tool("get_saved_posts", "List all previously saved/bookmarked posts from social listening.", {
+        page: z.number().optional().describe("Page number (default: 1)"),
+    }, async ({ page }) => {
+        const effectivePage = page ?? 1;
+        const body = {
+            sortField: "LATEST",
+            sortOrder: "DESC",
+            keywordGroupNameFilters: [],
+            platformFilters: [],
+            priorityFilters: [],
+            sentimentFilters: [],
+            leadTypeFilters: [],
+            offset: (effectivePage - 1) * 10,
+            limit: 10,
+            excludedUnifiedIds: [],
+        };
+        const res = await apiPost("/org/posts/saved", body);
+        return { content: [{ type: "text", text: formatResponse(res) }] };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@updately/mcp-server",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "MCP server for Updately LinkedIn Outreach — exposes campaign management, contacts, inbox, signals, ICP and more as AI-callable tools.",
   "type": "module",
   "main": "./build/index.js",