nv_search_people
Search for professionals in Sales Navigator using customizable filters like name, job position, location, industry, company, and experience range to refine results.
Instructions
Allows you to search people in Sales Navigator applying various filtering criteria. (nv.searchPeople action).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter | No | Optional. Object that specifies filtering criteria for people. When multiple filter fields are specified, they are combined using AND logic. | |
| limit | No | Optional. Number of search results to return. Defaults to 10, with a maximum value of 100. | |
| term | No | Optional. Keyword or phrase to search. |
Input Schema (JSON Schema)
{
"properties": {
"filter": {
"description": "Optional. Object that specifies filtering criteria for people. When multiple filter fields are specified, they are combined using AND logic.",
"properties": {
"currentCompanies": {
"description": "Optional. Array of company names. Matches if person currently works at any of the listed companies.",
"type": "array"
},
"firstName": {
"description": "Optional. First name of person.",
"type": "string"
},
"industries": {
"description": "Optional. Array of enums representing industries. Matches if person works in any of the listed industries. Takes specific values available in the LinkedIn interface.",
"type": "array"
},
"lastName": {
"description": "Optional. Last name of person.",
"type": "string"
},
"locations": {
"description": "Optional. Array of free-form strings representing locations. Matches if person is located in any of the listed locations.",
"type": "array"
},
"position": {
"description": "Optional. Job position of person.",
"type": "string"
},
"previousCompanies": {
"description": "Optional. Array of company names. Matches if person previously worked at any of the listed companies.",
"type": "array"
},
"schools": {
"description": "Optional. Array of institution names. Matches if person currently attends or previously attended any of the listed institutions.",
"type": "array"
},
"yearsOfExperiences": {
"description": "Optional. Array of enums representing professional experience. Matches if person's experience falls within any of the listed ranges.",
"enum": [
"lessThanOne",
"oneToTwo",
"threeToFive",
"sixToTen",
"moreThanTen"
],
"type": "array"
}
},
"type": "object"
},
"limit": {
"description": "Optional. Number of search results to return. Defaults to 10, with a maximum value of 100.",
"type": "number"
},
"term": {
"description": "Optional. Keyword or phrase to search.",
"type": "string"
}
},
"type": "object"
}
Implementation Reference
- src/tools/nv-search-people.ts:7-107 (handler)NvSearchPeopleTool class defines the tool handler by extending OperationTool, specifying the name 'nv_search_people', the operationName, input schema validation, and the Tool metadata.export class NvSearchPeopleTool extends OperationTool<TNvSearchPeopleParams, unknown> { public override readonly name = 'nv_search_people'; public override readonly operationName = OPERATION_NAME.nvSearchPeople; protected override readonly schema = z.object({ term: z.string().optional(), limit: z.number().min(1).max(2500).optional(), filter: z .object({ firstName: z.string().optional(), lastName: z.string().optional(), position: z.string().optional(), locations: z.array(z.string()).optional(), industries: z.array(z.string()).optional(), currentCompanies: z.array(z.string()).optional(), previousCompanies: z.array(z.string()).optional(), schools: z.array(z.string()).optional(), yearsOfExperiences: z.array(z.string()).optional(), }) .optional(), }); public override getTool(): Tool { return { name: this.name, description: 'Allows you to search people in Sales Navigator applying various filtering criteria. (nv.searchPeople action).', inputSchema: { type: 'object', properties: { term: { type: 'string', description: 'Optional. Keyword or phrase to search.', }, limit: { type: 'number', description: 'Optional. Number of search results to return. Defaults to 25, with a maximum value of 2500.', }, filter: { type: 'object', description: 'Optional. Object that specifies filtering criteria for people. When multiple filter fields are specified, they are combined using AND logic.', properties: { firstName: { type: 'string', description: 'Optional. First name of person.', }, lastName: { type: 'string', description: 'Optional. Last name of person.', }, position: { type: 'string', description: 'Optional. Job position of person.', }, locations: { type: 'array', description: 'Optional. Array of free-form strings representing locations. Matches if person is located in any of the listed locations.', items: { type: 'string' }, }, industries: { type: 'array', description: 'Optional. Array of enums representing industries. Matches if person works in any of the listed industries. Takes specific values available in the LinkedIn interface.', items: { type: 'string' }, }, currentCompanies: { type: 'array', description: 'Optional. Array of company names. Matches if person currently works at any of the listed companies.', items: { type: 'string' }, }, previousCompanies: { type: 'array', description: 'Optional. Array of company names. Matches if person previously worked at any of the listed companies.', items: { type: 'string' }, }, schools: { type: 'array', description: 'Optional. Array of institution names. Matches if person currently attends or previously attended any of the listed institutions.', items: { type: 'string' }, }, yearsOfExperiences: { type: 'array', description: "Optional. Array of enums representing professional experience. Matches if person's experience falls within any of the listed ranges.", items: { type: 'string', enum: ['lessThanOne', 'oneToTwo', 'threeToFive', 'sixToTen', 'moreThanTen'], }, }, }, }, }, }, }; } }
- src/tools/nv-search-people.ts:10-26 (schema)Zod schema for input validation of the nv_search_people tool parameters.protected override readonly schema = z.object({ term: z.string().optional(), limit: z.number().min(1).max(2500).optional(), filter: z .object({ firstName: z.string().optional(), lastName: z.string().optional(), position: z.string().optional(), locations: z.array(z.string()).optional(), industries: z.array(z.string()).optional(), currentCompanies: z.array(z.string()).optional(), previousCompanies: z.array(z.string()).optional(), schools: z.array(z.string()).optional(), yearsOfExperiences: z.array(z.string()).optional(), }) .optional(), });
- src/linked-api-tools.ts:34-64 (registration)The NvSearchPeopleTool is instantiated with a progress callback and registered in the tools array of LinkedApiTools class.this.tools = [ // Standard tools new SendMessageTool(progressCallback), new GetConversationTool(progressCallback), new CheckConnectionStatusTool(progressCallback), new RetrieveConnectionsTool(progressCallback), new SendConnectionRequestTool(progressCallback), new WithdrawConnectionRequestTool(progressCallback), new RetrievePendingRequestsTool(progressCallback), new RemoveConnectionTool(progressCallback), new SearchCompaniesTool(progressCallback), new SearchPeopleTool(progressCallback), new FetchCompanyTool(progressCallback), new FetchPersonTool(progressCallback), new FetchPostTool(progressCallback), new ReactToPostTool(progressCallback), new CommentOnPostTool(progressCallback), new RetrieveSSITool(progressCallback), new RetrievePerformanceTool(progressCallback), // Sales Navigator tools new NvSendMessageTool(progressCallback), new NvGetConversationTool(progressCallback), new NvSearchCompaniesTool(progressCallback), new NvSearchPeopleTool(progressCallback), new NvFetchCompanyTool(progressCallback), new NvFetchPersonTool(progressCallback), // Other tools new ExecuteCustomWorkflowTool(progressCallback), new GetWorkflowResultTool(progressCallback), new GetApiUsageTool(progressCallback), ];
- src/utils/linked-api-tool.ts:36-58 (handler)The execute method in OperationTool implements the core logic for executing the LinkedIn API operation specified by operationName, used by NvSearchPeopleTool.export abstract class OperationTool<TParams, TResult> extends LinkedApiTool<TParams, TResult> { public abstract readonly operationName: TOperationName; public override execute({ linkedapi, args, workflowTimeout, progressToken, }: { linkedapi: LinkedApi; args: TParams; workflowTimeout: number; progressToken?: string | number; }): Promise<TMappedResponse<TResult>> { const operation = linkedapi.operations.find( (operation) => operation.operationName === this.operationName, )! as Operation<TParams, TResult>; return executeWithProgress(this.progressCallback, operation, workflowTimeout, { params: args, progressToken, }); } }
- src/tools/nv-search-people.ts:29-106 (helper)getTool method provides the MCP Tool definition including name, description, and detailed inputSchema for the nv_search_people tool.return { name: this.name, description: 'Allows you to search people in Sales Navigator applying various filtering criteria. (nv.searchPeople action).', inputSchema: { type: 'object', properties: { term: { type: 'string', description: 'Optional. Keyword or phrase to search.', }, limit: { type: 'number', description: 'Optional. Number of search results to return. Defaults to 25, with a maximum value of 2500.', }, filter: { type: 'object', description: 'Optional. Object that specifies filtering criteria for people. When multiple filter fields are specified, they are combined using AND logic.', properties: { firstName: { type: 'string', description: 'Optional. First name of person.', }, lastName: { type: 'string', description: 'Optional. Last name of person.', }, position: { type: 'string', description: 'Optional. Job position of person.', }, locations: { type: 'array', description: 'Optional. Array of free-form strings representing locations. Matches if person is located in any of the listed locations.', items: { type: 'string' }, }, industries: { type: 'array', description: 'Optional. Array of enums representing industries. Matches if person works in any of the listed industries. Takes specific values available in the LinkedIn interface.', items: { type: 'string' }, }, currentCompanies: { type: 'array', description: 'Optional. Array of company names. Matches if person currently works at any of the listed companies.', items: { type: 'string' }, }, previousCompanies: { type: 'array', description: 'Optional. Array of company names. Matches if person previously worked at any of the listed companies.', items: { type: 'string' }, }, schools: { type: 'array', description: 'Optional. Array of institution names. Matches if person currently attends or previously attended any of the listed institutions.', items: { type: 'string' }, }, yearsOfExperiences: { type: 'array', description: "Optional. Array of enums representing professional experience. Matches if person's experience falls within any of the listed ranges.", items: { type: 'string', enum: ['lessThanOne', 'oneToTwo', 'threeToFive', 'sixToTen', 'moreThanTen'], }, }, }, }, }, }, }; }