update search with viewerState & connection degrees filter

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkedapi/mcp",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "MCP server that lets AI assistants control LinkedIn accounts and retrieve real-time data.",
   "main": "dist/index.js",
   "bin": {

src/tools/fetch-company.ts

@@ -34,6 +34,7 @@ export class FetchCompanyTool extends OperationTool<TFetchCompanyParams, unknown
             locations: z.array(z.string()).optional(),
             industries: z.array(z.string()).optional(),
             schools: z.array(z.string()).optional(),
+            connectionDegrees: z.array(z.enum(['1st', '2nd', '3rd+'])).optional(),
           })
           .optional(),
       })
@@ -142,6 +143,15 @@ export class FetchCompanyTool extends OperationTool<TFetchCompanyParams, unknown
                       'Optional. Array of institution names. Matches if employee currently attends or previously attended any of the listed institutions.',
                     items: { type: 'string' },
                   },
+                  connectionDegrees: {
+                    type: 'array',
+                    description:
+                      'Optional. Array of enums representing your connection degree to the employee. Matches if the employee is at any of the listed degrees.',
+                    items: {
+                      type: 'string',
+                      enum: ['1st', '2nd', '3rd+'],
+                    },
+                  },
                 },
               },
             },

src/tools/nv-fetch-company.ts

@@ -23,6 +23,7 @@ export class NvFetchCompanyTool extends OperationTool<TNvFetchCompanyParams, unk
             industries: z.array(z.string()).optional(),
             schools: z.array(z.string()).optional(),
             yearsOfExperiences: z.array(z.string()).optional(),
+            connectionDegrees: z.array(z.enum(['1st', '2nd', '3rd+', 'groupMembers'])).optional(),
           })
           .optional(),
       })
@@ -112,6 +113,15 @@ export class NvFetchCompanyTool extends OperationTool<TNvFetchCompanyParams, unk
                       enum: ['lessThanOne', 'oneToTwo', 'threeToFive', 'sixToTen', 'moreThanTen'],
                     },
                   },
+                  connectionDegrees: {
+                    type: 'array',
+                    description:
+                      'Optional. Array of enums representing your connection degree to the employee. Matches if the employee is at any of the listed degrees. groupMembers matches members of LinkedIn groups you belong to.',
+                    items: {
+                      type: 'string',
+                      enum: ['1st', '2nd', '3rd+', 'groupMembers'],
+                    },
+                  },
                 },
               },
             },

src/tools/nv-search-people.ts

@@ -21,6 +21,7 @@ export class NvSearchPeopleTool extends OperationTool<TNvSearchPeopleParams, unk
         previousCompanies: z.array(z.string()).optional(),
         schools: z.array(z.string()).optional(),
         yearsOfExperiences: z.array(z.string()).optional(),
+        connectionDegrees: z.array(z.enum(['1st', '2nd', '3rd+', 'groupMembers'])).optional(),
       })
       .optional(),
   });
@@ -29,7 +30,7 @@ export class NvSearchPeopleTool extends OperationTool<TNvSearchPeopleParams, unk
     return {
       name: this.name,
       description:
-        'Allows you to search people in Sales Navigator applying various filtering criteria. (nv.searchPeople action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. The same person carries the same urn in standard interface results, so it can be used to match Sales Navigator results against them.',
+        'Allows you to search people in Sales Navigator applying various filtering criteria. (nv.searchPeople action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. The same person carries the same urn in standard interface results, so it can be used to match Sales Navigator results against them. Every person also carries viewerState.connectionDegree — your connection degree to them (1st, 2nd, 3rd+), or null when LinkedIn shows none.',
       inputSchema: {
         type: 'object',
         properties: {
@@ -98,6 +99,15 @@ export class NvSearchPeopleTool extends OperationTool<TNvSearchPeopleParams, unk
                   enum: ['lessThanOne', 'oneToTwo', 'threeToFive', 'sixToTen', 'moreThanTen'],
                 },
               },
+              connectionDegrees: {
+                type: 'array',
+                description:
+                  'Optional. Array of enums representing your connection degree to the person. Matches if the person is at any of the listed degrees. groupMembers matches members of LinkedIn groups you belong to.',
+                items: {
+                  type: 'string',
+                  enum: ['1st', '2nd', '3rd+', 'groupMembers'],
+                },
+              },
             },
           },
         },

src/tools/search-people.ts

@@ -20,6 +20,7 @@ export class SearchPeopleTool extends OperationTool<TSearchPeopleParams, unknown
         currentCompanies: z.array(z.string()).optional(),
         previousCompanies: z.array(z.string()).optional(),
         schools: z.array(z.string()).optional(),
+        connectionDegrees: z.array(z.enum(['1st', '2nd', '3rd+'])).optional(),
       })
       .optional(),
   });
@@ -28,7 +29,7 @@ export class SearchPeopleTool extends OperationTool<TSearchPeopleParams, unknown
     return {
       name: this.name,
       description:
-        'Allows you to search people applying various filtering criteria (st.searchPeople action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it.',
+        'Allows you to search people applying various filtering criteria (st.searchPeople action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. Every person also carries viewerState.connectionDegree — your connection degree to them (1st, 2nd, 3rd+), or null when LinkedIn shows none.',
       inputSchema: {
         type: 'object',
         properties: {
@@ -88,6 +89,15 @@ export class SearchPeopleTool extends OperationTool<TSearchPeopleParams, unknown
                   'Optional. Array of institution names. Matches if person currently attends or previously attended any of the listed institutions.',
                 items: { type: 'string' },
               },
+              connectionDegrees: {
+                type: 'array',
+                description:
+                  'Optional. Array of enums representing your connection degree to the person. Matches if the person is at any of the listed degrees.',
+                items: {
+                  type: 'string',
+                  enum: ['1st', '2nd', '3rd+'],
+                },
+              },
             },
           },
         },

src/tools/search-posts.ts

@@ -165,7 +165,7 @@ export class SearchPostsTool extends OperationTool<TSearchPostsParams, unknown>
               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.',
+                  '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 filterNotApplied rather than filtering by a namesake.',
                 items: PERSON_FILTER_ENTRY_JSON_SCHEMA,
               },
               fromCompanies: {