Linked API MCP

Instructions

Implementation Reference

• src/tools/retrieve-ssi.ts:7-22 (handler)

  The RetrieveSSITool class implements the 'retrieve_ssi' tool. It maps to the 'retrieveSSI' operation, defines an empty Zod input schema for validation, sets the tool name and description, and returns the MCP Tool object definition.

  export class RetrieveSSITool extends OperationTool<unknown, unknown> {
    public override readonly operationName = OPERATION_NAME.retrieveSSI;
    public override readonly name = 'retrieve_ssi';
    protected override readonly schema = z.object({});
  
    public override getTool(): Tool {
      return {
        name: this.name,
        description:
          'Allows you to retrieve your current SSI (Social Selling Index) (st.retrieveSSI action).',
        inputSchema: {
          type: 'object',
          properties: {},
        },
      };
    }

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

  Registers the RetrieveSSITool (at line 53) as part of the LinkedApiTools class, instantiating it with a progress callback 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),
  ];

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

  The execute method in OperationTool (base class for RetrieveSSITool) that handles the tool execution: finds the LinkedAPI operation by operationName ('retrieveSSI'), validates args, and calls executeWithProgress to run it.

    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/retrieve-ssi.ts:10-10 (schema)

  Zod schema for input validation of retrieve_ssi tool (empty object, no parameters expected).

  protected override readonly schema = z.object({});

• src/tools/retrieve-ssi.ts:12-22 (helper)

  Overrides getTool() to provide the MCP-compatible Tool object with name 'retrieve_ssi', description, and empty inputSchema.

  public override getTool(): Tool {
    return {
      name: this.name,
      description:
        'Allows you to retrieve your current SSI (Social Selling Index) (st.retrieveSSI action).',
      inputSchema: {
        type: 'object',
        properties: {},
      },
    };
  }