@linkedapi/mcp 2.3.11 → 2.3.13

package/dist/tools/search-posts.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchPostsTool = void 0;
+const node_1 = require("@linkedapi/node");
+const zod_1 = require("zod");
+const linked_api_tool_js_1 = require("../utils/linked-api-tool.js");
+const PERSON_FILTER_ENTRY_SCHEMA = zod_1.z.union([
+    zod_1.z.string().min(1).max(100),
+    zod_1.z.object({
+        name: zod_1.z.string().min(1).max(100),
+        urn: zod_1.z.string().optional(),
+        personHashedUrl: zod_1.z.string().optional(),
+    }),
+]);
+const COMPANY_FILTER_ENTRY_SCHEMA = zod_1.z.union([
+    zod_1.z.string().min(1).max(100),
+    zod_1.z.object({
+        name: zod_1.z.string().min(1).max(100),
+        urn: zod_1.z.string().optional(),
+        companyHashedUrl: zod_1.z.string().optional(),
+    }),
+]);
+const PERSON_FILTER_ENTRY_JSON_SCHEMA = {
+    oneOf: [
+        {
+            type: 'string',
+            minLength: 1,
+            maxLength: 100,
+            description: 'Name of the person, shorthand for { name }.',
+        },
+        {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 100,
+                    description: 'Required. Name to type into the LinkedIn filter panel.',
+                },
+                urn: {
+                    type: 'string',
+                    description: 'Optional. Member URN of the person, urn:li:member:<id>.',
+                },
+                personHashedUrl: {
+                    type: 'string',
+                    description: 'Optional. Hashed LinkedIn URL of the person.',
+                },
+            },
+            required: ['name'],
+        },
+    ],
+};
+const COMPANY_FILTER_ENTRY_JSON_SCHEMA = {
+    oneOf: [
+        {
+            type: 'string',
+            minLength: 1,
+            maxLength: 100,
+            description: 'Name of the company, shorthand for { name }.',
+        },
+        {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 100,
+                    description: 'Required. Name to type into the LinkedIn filter panel.',
+                },
+                urn: {
+                    type: 'string',
+                    description: 'Optional. Organization URN of the company, urn:li:organization:<id>.',
+                },
+                companyHashedUrl: {
+                    type: 'string',
+                    description: 'Optional. Hashed LinkedIn URL of the company.',
+                },
+            },
+            required: ['name'],
+        },
+    ],
+};
+class SearchPostsTool extends linked_api_tool_js_1.OperationTool {
+    name = 'search_posts';
+    operationName = node_1.OPERATION_NAME.searchPosts;
+    schema = zod_1.z
+        .object({
+        term: zod_1.z.string().min(1).max(50).optional(),
+        limit: zod_1.z.number().min(1).max(100).optional(),
+        filter: zod_1.z
+            .object({
+            sort: zod_1.z.enum(['topMatch', 'latest']).optional(),
+            datePosted: zod_1.z.enum(['past24Hours', 'pastWeek', 'pastMonth']).optional(),
+            contentType: zod_1.z
+                .enum(['videos', 'images', 'jobPosts', 'liveVideos', 'documents'])
+                .optional(),
+            postedBy: zod_1.z.array(zod_1.z.enum(['me', 'firstConnections', 'peopleYouFollow'])).optional(),
+            fromMembers: zod_1.z.array(PERSON_FILTER_ENTRY_SCHEMA).optional(),
+            fromCompanies: zod_1.z.array(COMPANY_FILTER_ENTRY_SCHEMA).optional(),
+            mentioningMembers: zod_1.z.array(PERSON_FILTER_ENTRY_SCHEMA).optional(),
+            mentioningCompanies: zod_1.z.array(COMPANY_FILTER_ENTRY_SCHEMA).optional(),
+            authorCompanies: zod_1.z.array(COMPANY_FILTER_ENTRY_SCHEMA).optional(),
+            authorIndustries: zod_1.z.array(zod_1.z.string()).optional(),
+        })
+            .optional(),
+        customSearchUrl: zod_1.z.string().optional(),
+    })
+        .refine(({ term, customSearchUrl }) => Boolean(term) || Boolean(customSearchUrl), {
+        message: 'Either term or customSearchUrl must be provided.',
+    });
+    getTool() {
+        return {
+            name: this.name,
+            description: 'Allows you to search posts applying various filtering criteria (st.searchPosts action). Either term or customSearchUrl must be provided, and when customSearchUrl is specified, filter is ignored entirely and only the facets already encoded in the URL are applied. LinkedIn widens a narrow query on its own, so a non-empty result does not mean the term matched — check the returned posts against your own criteria when an exact match matters. Unlike fetch_post, the author and reposter of a search result carry no urn, so fetch the post by its url when you need one.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    term: {
+                        type: 'string',
+                        minLength: 1,
+                        maxLength: 50,
+                        description: 'Optional. Keyword or phrase to search, from 1 to 50 characters. Required unless customSearchUrl is specified.',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Optional. Number of search results to return. Defaults to 10, with a maximum value of 100. A search may return fewer posts than limit, because how many results come back depends on what LinkedIn loads for that account on that search.',
+                    },
+                    filter: {
+                        type: 'object',
+                        description: 'Optional. Filtering criteria for posts. Every specified field is applied, or the action fails. When multiple filter fields are specified, they are combined using AND logic. Ignored entirely when customSearchUrl is specified.',
+                        properties: {
+                            sort: {
+                                type: 'string',
+                                enum: ['topMatch', 'latest'],
+                                description: 'Optional. How to order the results.',
+                            },
+                            datePosted: {
+                                type: 'string',
+                                enum: ['past24Hours', 'pastWeek', 'pastMonth'],
+                                description: 'Optional. How recently the post was published.',
+                            },
+                            contentType: {
+                                type: 'string',
+                                enum: ['videos', 'images', 'jobPosts', 'liveVideos', 'documents'],
+                                description: 'Optional. Kind of content the post must carry.',
+                            },
+                            postedBy: {
+                                type: 'array',
+                                description: 'Optional. Array of author relationships to you. Matches if the post was published by any of the listed ones.',
+                                items: {
+                                    type: 'string',
+                                    enum: ['me', 'firstConnections', 'peopleYouFollow'],
+                                },
+                            },
+                            fromMembers: {
+                                type: 'array',
+                                description: 'Optional. Array of people whose posts to keep. Each entry is a plain name string, or an object with name plus an optional urn or personHashedUrl that pins the exact person; both forms can be mixed in one array. With a name alone LinkedIn takes whichever suggestion it ranked first, which may be a namesake. An identifier no suggestion resolves to fails the action with filterIdentityMismatch rather than filtering by a namesake.',
+                                items: PERSON_FILTER_ENTRY_JSON_SCHEMA,
+                            },
+                            fromCompanies: {
+                                type: 'array',
+                                description: 'Optional. Array of companies whose posts to keep. Same entry shape as fromMembers, with companyHashedUrl in place of personHashedUrl.',
+                                items: COMPANY_FILTER_ENTRY_JSON_SCHEMA,
+                            },
+                            mentioningMembers: {
+                                type: 'array',
+                                description: 'Optional. Array of people to look for in post text. Same entry shape as fromMembers.',
+                                items: PERSON_FILTER_ENTRY_JSON_SCHEMA,
+                            },
+                            mentioningCompanies: {
+                                type: 'array',
+                                description: 'Optional. Array of companies to look for in post text. Same entry shape as fromCompanies.',
+                                items: COMPANY_FILTER_ENTRY_JSON_SCHEMA,
+                            },
+                            authorCompanies: {
+                                type: 'array',
+                                description: 'Optional. Array of companies the author works at. Same entry shape as fromCompanies.',
+                                items: COMPANY_FILTER_ENTRY_JSON_SCHEMA,
+                            },
+                            authorIndustries: {
+                                type: 'array',
+                                description: 'Optional. Array of industry names the author works in. An industry is a taxonomy value rather than an entity, so it is matched by name only. Takes specific values available in the LinkedIn interface.',
+                                items: { type: 'string' },
+                            },
+                        },
+                    },
+                    customSearchUrl: {
+                        type: 'string',
+                        description: 'Optional. URL copied from a LinkedIn content search page after configuring filters. When specified, filter is ignored entirely.',
+                    },
+                },
+                anyOf: [{ required: ['term'] }, { required: ['customSearchUrl'] }],
+            },
+        };
+    }
+}
+exports.SearchPostsTool = SearchPostsTool;
+//# sourceMappingURL=search-posts.js.map

package/dist/tools/search-posts.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkedapi/mcp",
-  "version": "2.3.11",
+  "version": "2.3.13",
   "description": "MCP server that lets AI assistants control LinkedIn accounts and retrieve real-time data.",
   "main": "dist/index.js",
   "bin": {
@@ -30,7 +30,7 @@
   "author": "Linked API",
   "license": "MIT",
   "dependencies": {
-    "@linkedapi/node": "^2.3.11",
+    "@linkedapi/node": "^2.3.13",
     "@modelcontextprotocol/sdk": "^1.17.4",
     "zod": "^4.1.1"
   },
@@ -56,4 +56,4 @@
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.38.0"
   }
-}
+}

package/src/linked-api-tools.ts

@@ -22,6 +22,7 @@ import { AdminSetSeatsTool } from './tools/admin-set-seats.js';
 import { CheckConnectionStatusTool } from './tools/check-connection-status.js';
 import { CommentOnPostTool } from './tools/comment-on-post.js';
 import { CreatePostTool } from './tools/create-post.js';
+import { CreateRepostTool } from './tools/create-repost.js';
 import { ExecuteCustomWorkflowTool } from './tools/execute-custom-workflow.js';
 import { FetchCompanyTool } from './tools/fetch-company.js';
 import { FetchJobTool } from './tools/fetch-job.js';
@@ -56,6 +57,7 @@ import { RetrieveSSITool } from './tools/retrieve-ssi.js';
 import { SearchCompaniesTool } from './tools/search-companies.js';
 import { SearchJobsTool } from './tools/search-jobs.js';
 import { SearchPeopleTool } from './tools/search-people.js';
+import { SearchPostsTool } from './tools/search-posts.js';
 import { SendConnectionRequestTool } from './tools/send-connection-request.js';
 import { SendFeedbackTool } from './tools/send-feedback.js';
 import { SendMessageTool } from './tools/send-message.js';
@@ -103,6 +105,7 @@ export class LinkedApiTools {
       new SearchCompaniesTool(),
       new SearchPeopleTool(),
       new SearchJobsTool(),
+      new SearchPostsTool(),
       new FetchCompanyTool(),
       new FetchPersonTool(),
       new FetchPostTool(),
@@ -112,6 +115,7 @@ export class LinkedApiTools {
       new ReactToCommentTool(),
       new ReplyToCommentTool(),
       new CreatePostTool(),
+      new CreateRepostTool(),
       new RetrieveFeedTool(),
       new RetrieveProfileViewersTool(),
       new RetrieveSSITool(),

package/src/tools/comment-on-post.ts

@@ -8,7 +8,8 @@ export class CommentOnPostTool extends OperationTool<TCommentOnPostParams, TComm
   public override readonly name = 'comment_on_post';
   public override readonly operationName = OPERATION_NAME.commentOnPost;
   protected override readonly schema = z.object({
-    postUrl: z.string(),
+    postUrl: z.string().optional(),
+    postUrn: z.string().optional(),
     text: z.string().min(1),
     companyUrl: z.string().optional(),
   });
@@ -24,7 +25,12 @@ export class CommentOnPostTool extends OperationTool<TCommentOnPostParams, TComm
           postUrl: {
             type: 'string',
             description:
-              "The LinkedIn post URL to comment on (e.g., 'https://www.linkedin.com/posts/username_activity-id')",
+              "The LinkedIn post URL to comment on (e.g., 'https://www.linkedin.com/posts/username_activity-id') Provide this or postUrn.",
+          },
+          postUrn: {
+            type: 'string',
+            description:
+              "URN of the post to comment on, as an alternative to postUrl. (e.g., 'urn:li:activity:1234567890123456789')",
           },
           text: {
             type: 'string',
@@ -36,7 +42,7 @@ export class CommentOnPostTool extends OperationTool<TCommentOnPostParams, TComm
               "LinkedIn company page URL. If specified, the comment will be added on behalf of the company. (e.g., 'https://www.linkedin.com/company/acme-corp')",
           },
         },
-        required: ['postUrl', 'text'],
+        required: ['text'],
       },
     };
   }

package/src/tools/create-post.ts

@@ -9,6 +9,17 @@ export class CreatePostTool extends OperationTool<TCreatePostParams, unknown> {
   public override readonly operationName = OPERATION_NAME.createPost;
   protected override readonly schema = z.object({
     text: z.string().min(1).max(3000),
+    mentions: z
+      .array(
+        z.object({
+          key: z.string(),
+          name: z.string(),
+          urn: z.string().optional(),
+          personHashedUrl: z.string().optional(),
+          companyHashedUrl: z.string().optional(),
+        }),
+      )
+      .optional(),
     companyUrl: z.string().optional(),
     attachments: z
       .array(
@@ -26,13 +37,49 @@ export class CreatePostTool extends OperationTool<TCreatePostParams, unknown> {
     return {
       name: this.name,
       description:
-        'Creates a new LinkedIn post with optional media attachments (st.createPost action). If this workflow is still running, do not retry this tool; retrying can create duplicate posts.',
+        'Creates a new LinkedIn post with optional mentions and media attachments (st.createPost action). Returns the URL and URN of the new post. If this workflow is still running, do not retry this tool; retrying can create duplicate posts.',
       inputSchema: {
         type: 'object',
         properties: {
           text: {
             type: 'string',
-            description: 'Post content, must be up to 3000 characters.',
+            description:
+              'Post content, must be up to 3000 characters. Write "@[key]" where a mention should appear and describe that key in mentions.',
+          },
+          mentions: {
+            type: 'array',
+            description:
+              'People and companies to mention in the text. Each item binds a "@[key]" placeholder to one entity.',
+            items: {
+              type: 'object',
+              properties: {
+                key: {
+                  type: 'string',
+                  description:
+                    'Placeholder name used in the text as "@[key]". 1-30 characters: letters, digits, underscore or hyphen.',
+                },
+                name: {
+                  type: 'string',
+                  description:
+                    'Name to find the person or company by. Always required: LinkedIn resolves a mention through its own name suggestions.',
+                },
+                urn: {
+                  type: 'string',
+                  description:
+                    "URN of the entity (e.g., 'urn:li:member:123456789' or 'urn:li:organization:1234567'). Decides which of the offered namesakes is taken.",
+                },
+                personHashedUrl: {
+                  type: 'string',
+                  description:
+                    'Hashed LinkedIn profile URL of the person, as an alternative to urn.',
+                },
+                companyHashedUrl: {
+                  type: 'string',
+                  description: 'Hashed LinkedIn company page URL, as an alternative to urn.',
+                },
+              },
+              required: ['key', 'name'],
+            },
           },
           companyUrl: {
             type: 'string',

package/src/tools/create-repost.ts

@@ -0,0 +1,90 @@
+import { OPERATION_NAME, TCreateRepostParams } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+
+import { OperationTool } from '../utils/linked-api-tool.js';
+
+export class CreateRepostTool extends OperationTool<TCreateRepostParams, unknown> {
+  public override readonly name = 'create_repost';
+  public override readonly operationName = OPERATION_NAME.createRepost;
+  protected override readonly schema = z.object({
+    postUrl: z.string().optional(),
+    postUrn: z.string().optional(),
+    text: z.string().max(3000).optional(),
+    mentions: z
+      .array(
+        z.object({
+          key: z.string(),
+          name: z.string(),
+          urn: z.string().optional(),
+          personHashedUrl: z.string().optional(),
+          companyHashedUrl: z.string().optional(),
+        }),
+      )
+      .optional(),
+  });
+
+  public override getTool(): Tool {
+    return {
+      name: this.name,
+      description:
+        'Reposts a LinkedIn post, either as is or with your own commentary (st.createRepost action). Returns the URL and URN of the repost itself, which is a post of your own account, not of the post that was reshared. Reposting the same post twice from the same account fails with alreadyReposted. If this workflow is still running, do not retry this tool; retrying can create duplicate reposts.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          postUrl: {
+            type: 'string',
+            description:
+              "LinkedIn URL of the post to repost. (e.g., 'https://www.linkedin.com/posts/username_activity-id') Provide this or postUrn.",
+          },
+          postUrn: {
+            type: 'string',
+            description:
+              "URN of the post to repost, as an alternative to postUrl. (e.g., 'urn:li:activity:1234567890123456789')",
+          },
+          text: {
+            type: 'string',
+            description:
+              'Your own commentary, up to 3000 characters. Without it the post is reposted as is. Write "@[key]" where a mention should appear and describe that key in mentions.',
+          },
+          mentions: {
+            type: 'array',
+            description:
+              'People and companies to mention in the commentary. Each item binds a "@[key]" placeholder to one entity.',
+            items: {
+              type: 'object',
+              properties: {
+                key: {
+                  type: 'string',
+                  description:
+                    'Placeholder name used in the text as "@[key]". 1-30 characters: letters, digits, underscore or hyphen.',
+                },
+                name: {
+                  type: 'string',
+                  description:
+                    'Name to find the person or company by. Always required: LinkedIn resolves a mention through its own name suggestions.',
+                },
+                urn: {
+                  type: 'string',
+                  description:
+                    "URN of the entity (e.g., 'urn:li:member:123456789' or 'urn:li:organization:1234567'). Decides which of the offered namesakes is taken.",
+                },
+                personHashedUrl: {
+                  type: 'string',
+                  description:
+                    'Hashed LinkedIn profile URL of the person, as an alternative to urn.',
+                },
+                companyHashedUrl: {
+                  type: 'string',
+                  description: 'Hashed LinkedIn company page URL, as an alternative to urn.',
+                },
+              },
+              required: ['key', 'name'],
+            },
+          },
+        },
+        required: [],
+      },
+    };
+  }
+}

package/src/tools/fetch-post.ts

@@ -8,7 +8,8 @@ export class FetchPostTool extends OperationTool<TFetchPostParams, unknown> {
   public override readonly name = 'fetch_post';
   public override readonly operationName = OPERATION_NAME.fetchPost;
   protected override readonly schema = z.object({
-    postUrl: z.string(),
+    postUrl: z.string().optional(),
+    postUrn: z.string().optional(),
     retrieveComments: z.boolean().optional(),
     retrieveReactions: z.boolean().optional(),
     commentsRetrievalConfig: z
@@ -36,7 +37,12 @@ export class FetchPostTool extends OperationTool<TFetchPostParams, unknown> {
           postUrl: {
             type: 'string',
             description:
-              "LinkedIn URL of the post. (e.g., 'https://www.linkedin.com/posts/username_activity-id')",
+              "LinkedIn URL of the post. (e.g., 'https://www.linkedin.com/posts/username_activity-id') Provide this or postUrn.",
+          },
+          postUrn: {
+            type: 'string',
+            description:
+              "URN of the post to fetch, as an alternative to postUrl. (e.g., 'urn:li:activity:1234567890123456789')",
           },
           retrieveComments: {
             type: 'boolean',
@@ -83,7 +89,7 @@ export class FetchPostTool extends OperationTool<TFetchPostParams, unknown> {
             },
           },
         },
-        required: ['postUrl'],
+        required: [],
       },
     };
   }

package/src/tools/react-to-post.ts

@@ -8,7 +8,8 @@ export class ReactToPostTool extends OperationTool<TReactToPostParams, unknown>
   public override readonly name = 'react_to_post';
   public override readonly operationName = OPERATION_NAME.reactToPost;
   protected override readonly schema = z.object({
-    postUrl: z.string(),
+    postUrl: z.string().optional(),
+    postUrn: z.string().optional(),
     type: z.enum(['like', 'love', 'celebrate', 'support', 'funny', 'insightful']).or(z.string()),
     companyUrl: z.string().optional(),
   });
@@ -24,7 +25,12 @@ export class ReactToPostTool extends OperationTool<TReactToPostParams, unknown>
           postUrl: {
             type: 'string',
             description:
-              "LinkedIn URL of the post to react. (e.g., 'https://www.linkedin.com/posts/username_activity-id')",
+              "LinkedIn URL of the post to react. (e.g., 'https://www.linkedin.com/posts/username_activity-id') Provide this or postUrn.",
+          },
+          postUrn: {
+            type: 'string',
+            description:
+              "URN of the post to react to, as an alternative to postUrl. (e.g., 'urn:li:activity:1234567890123456789')",
           },
           type: {
             type: 'string',
@@ -37,7 +43,7 @@ export class ReactToPostTool extends OperationTool<TReactToPostParams, unknown>
               "LinkedIn company page URL. If specified, the reaction will be added on behalf of the company. (e.g., 'https://www.linkedin.com/company/acme-corp')",
           },
         },
-        required: ['postUrl', 'type'],
+        required: ['type'],
       },
     };
   }