Linked API MCP

Instructions

Implementation Reference

• src/tools/nv-fetch-person.ts:7-30 (handler)

  Defines the NvFetchPersonTool class which implements the 'nv_fetch_person' MCP tool. Sets the tool name, maps to the underlying operation (OPERATION_NAME.nvFetchPerson), defines Zod input schema, and provides the MCP Tool object with inputSchema.

  export class NvFetchPersonTool extends OperationTool<TNvOpenPersonPageParams, unknown> {
    public override readonly name = 'nv_fetch_person';
    public override readonly operationName = OPERATION_NAME.nvFetchPerson;
    protected override readonly schema = z.object({
      personHashedUrl: z.string(),
    });
  
    public override getTool(): Tool {
      return {
        name: this.name,
        description:
          'Allows you to open a person page in Sales Navigator to retrieve their basic information (nv.openPersonPage action).',
        inputSchema: {
          type: 'object',
          properties: {
            personHashedUrl: {
              type: 'string',
              description: 'Hashed LinkedIn URL of the person.',
            },
          },
          required: ['personHashedUrl'],
        },
      };
    }

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

  Registers the NvFetchPersonTool instance within the LinkedApiTools class constructor by adding it to the tools array.

  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),
    ];

• src/utils/linked-api-tool.ts:39-57 (handler)

  The execute method in OperationTool (base class for NvFetchPersonTool) that handles the tool execution: locates the specific operation by operationName ('nvFetchPerson'), validates params, and executes it via executeWithProgress.

  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-person.ts:10-12 (schema)

  Zod schema for input validation of personHashedUrl.

  protected override readonly schema = z.object({
    personHashedUrl: z.string(),
  });