Linked API MCP

Instructions

Implementation Reference

• src/utils/linked-api-tool.ts:36-58 (handler)

  The OperationTool base class implements the execute method, which is the core handler logic for running the 'nvFetchCompany' operation from the LinkedIn API.

  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-fetch-company.ts:7-136 (handler)

  The specific NvFetchCompanyTool class that configures the 'nv_fetch_company' tool with name, operationName, Zod schema, and MCP Tool definition.

  export class NvFetchCompanyTool extends OperationTool<TNvFetchCompanyParams, unknown> {
    public override readonly name = 'nv_fetch_company';
    public override readonly operationName = OPERATION_NAME.nvFetchCompany;
    protected override readonly schema = z.object({
      companyHashedUrl: z.string(),
      retrieveEmployees: z.boolean().optional().default(false),
      retrieveDMs: z.boolean().optional().default(false),
      employeeRetrievalConfig: z
        .object({
          limit: z.number().min(1).max(500).optional(),
          filter: z
            .object({
              firstName: z.string().optional(),
              lastName: z.string().optional(),
              positions: z.array(z.string()).optional(),
              locations: z.array(z.string()).optional(),
              industries: z.array(z.string()).optional(),
              schools: z.array(z.string()).optional(),
              yearsOfExperiences: z.array(z.string()).optional(),
            })
            .optional(),
        })
        .optional(),
      dmRetrievalConfig: z
        .object({
          limit: z.number().min(1).max(20).optional(),
        })
        .optional(),
    });
  
    public override getTool(): Tool {
      return {
        name: this.name,
        description:
          'Allows you to open a company page in Sales Navigator to retrieve its basic information (nv.openCompanyPage action). Can optionally retrieve employees and decision makers.',
        inputSchema: {
          type: 'object',
          properties: {
            companyHashedUrl: {
              type: 'string',
              description: 'Hashed LinkedIn URL of the company.',
            },
            retrieveEmployees: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the company's employees information. Default is false.",
            },
            retrieveDMs: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the company's decision makers information. Default is false.",
            },
            employeeRetrievalConfig: {
              type: 'object',
              description:
                'Optional. Configuration for retrieving employees. Available only if retrieveEmployees is true.',
              properties: {
                limit: {
                  type: 'number',
                  description:
                    'Optional. Maximum number of employees to retrieve. Defaults to 500, with a maximum value of 500.',
                },
                filter: {
                  type: 'object',
                  description:
                    'Optional. Object that specifies filtering criteria for employees. When multiple filter fields are specified, they are combined using AND logic.',
                  properties: {
                    firstName: {
                      type: 'string',
                      description: 'Optional. First name of employee.',
                    },
                    lastName: {
                      type: 'string',
                      description: 'Optional. Last name of employee.',
                    },
                    positions: {
                      type: 'array',
                      description:
                        "Optional. Array of job position names. Matches if employee's current position is any of the listed options.",
                      items: { type: 'string' },
                    },
                    locations: {
                      type: 'array',
                      description:
                        'Optional. Array of free-form strings representing locations. Matches if employee is located in any of the listed locations.',
                      items: { type: 'string' },
                    },
                    industries: {
                      type: 'array',
                      description:
                        'Optional. Array of enums representing industries. Matches if employee works in any of the listed industries. Takes specific values available in the LinkedIn interface.',
                      items: { type: 'string' },
                    },
                    schools: {
                      type: 'array',
                      description:
                        'Optional. Array of institution names. Matches if employee 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 employee's experience falls within any of the listed ranges.",
                      items: {
                        type: 'string',
                        enum: ['lessThanOne', 'oneToTwo', 'threeToFive', 'sixToTen', 'moreThanTen'],
                      },
                    },
                  },
                },
              },
            },
            dmRetrievalConfig: {
              type: 'object',
              description:
                'Optional. Configuration for retrieving decision makers. Available only if retrieveDMs is true.',
              properties: {
                limit: {
                  type: 'number',
                  description:
                    'Optional. Number of decision makers to retrieve. Defaults to 20, with a maximum value of 20. If a company has fewer decision makers than specified, only the available ones will be returned.',
                },
              },
            },
          },
          required: ['companyHashedUrl'],
        },
      };
    }
  }

• src/linked-api-tools.ts:34-66 (registration)

  Registers the NvFetchCompanyTool instance in the LinkedApiTools collection's tools array, likely used for MCP tool provision.

  constructor(progressCallback: (progress: LinkedApiProgressNotification) => void) {
    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 CreatePostTool(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),
    ];