Linked API MCP

Instructions

Implementation Reference

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

  The execute method of OperationTool provides the core handler logic for the fetch_person tool. It resolves the LinkedAPI operation using the tool's operationName (OPERATION_NAME.fetchPerson) and executes it with progress notifications.

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

  Zod input schema for validating parameters to the fetch_person tool, used in the validate method.

  protected override readonly schema = z.object({
    personUrl: z.string(),
    retrieveExperience: z.boolean().optional().default(false),
    retrieveEducation: z.boolean().optional().default(false),
    retrieveSkills: z.boolean().optional().default(false),
    retrieveLanguages: z.boolean().optional().default(false),
    retrievePosts: z.boolean().optional().default(false),
    retrieveComments: z.boolean().optional().default(false),
    retrieveReactions: z.boolean().optional().default(false),
    postsRetrievalConfig: z
      .object({
        limit: z.number().min(1).max(20).optional(),
        since: z.string().optional(),
      })
      .optional(),
    commentRetrievalConfig: z
      .object({
        limit: z.number().min(1).max(20).optional(),
        since: z.string().optional(),
      })
      .optional(),
    reactionRetrievalConfig: z
      .object({
        limit: z.number().min(1).max(20).optional(),
        since: z.string().optional(),
      })
      .optional(),
  });

• src/tools/fetch-person.ts:39-143 (schema)

  MCP Tool specification including name 'fetch_person', detailed description, and JSON inputSchema matching the zod schema.

    public override getTool(): Tool {
      return {
        name: this.name,
        description: `Allows you to open a person page to retrieve their basic information and perform additional person-related actions if needed. (st.openPersonPage action). Allows additional optional retrieval of experience, education, skills, languages, posts, comments and reactions.
  ⚠️ **PERFORMANCE WARNING**: Only set additional retrieval flags to true if you specifically need that data. Each additional parameter significantly increases execution time:
  💡 **Recommendation**: Start with basic info only. Only request additional data if the user explicitly asks for it or if it's essential for the current task.
  `,
        inputSchema: {
          type: 'object',
          properties: {
            personUrl: {
              type: 'string',
              description:
                "The LinkedIn profile URL of the person to fetch (e.g., 'https://www.linkedin.com/in/john-doe')",
            },
            retrieveExperience: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's experience information. Default is false.",
            },
            retrieveEducation: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's education information. Default is false.",
            },
            retrieveSkills: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's skills information. Default is false.",
            },
            retrieveLanguages: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's languages information. Default is false.",
            },
            retrievePosts: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's posts information. Default is false.",
            },
            retrieveComments: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's comments information. Default is false.",
            },
            retrieveReactions: {
              type: 'boolean',
              description:
                "Optional. Whether to retrieve the person's reactions information. Default is false.",
            },
            postsRetrievalConfig: {
              type: 'object',
              description:
                'Optional. Configuration for retrieving posts. Available only if retrievePosts is true.',
              properties: {
                limit: {
                  type: 'number',
                  description:
                    'Optional. Number of posts to retrieve. Defaults to 20, with a maximum value of 20.',
                },
                since: {
                  type: 'string',
                  description:
                    'Optional. ISO 8601 timestamp to filter posts published after the specified time.',
                },
              },
            },
            commentRetrievalConfig: {
              type: 'object',
              description:
                'Optional. Configuration for retrieving comments. Available only if retrieveComments is true.',
              properties: {
                limit: {
                  type: 'number',
                  description:
                    'Optional. Number of comments to retrieve. Defaults to 20, with a maximum value of 20.',
                },
                since: {
                  type: 'string',
                  description:
                    'Optional. ISO 8601 timestamp to filter comments made after the specified time.',
                },
              },
            },
            reactionRetrievalConfig: {
              type: 'object',
              description:
                'Optional. Configuration for retrieving reactions. Available only if retrieveReactions is true.',
              properties: {
                limit: {
                  type: 'number',
                  description:
                    'Optional. Number of reactions to retrieve. Defaults to 20, with a maximum value of 20.',
                },
                since: {
                  type: 'string',
                  description:
                    'Optional. ISO 8601 timestamp to filter reactions made after the specified time.',
                },
              },
            },
          },
          required: ['personUrl'],
        },
      };

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

  Registers FetchPersonTool as part of the LinkedApiTools collection by instantiating it and adding to the readonly tools array.

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