esa MCP Server

Instructions

Implementation Reference

• index.ts:525-538 (handler)

  Handler logic for the esa_list_comments tool. Validates arguments, calls esaClient.listComments, and returns the API response as JSON.

  case "esa_list_comments": {
    const args = request.params.arguments as unknown as ListCommentsArgs;
    if (!args.post_number) {
      throw new Error("post_number is required");
    }
    const response = await esaClient.listComments(
      args.post_number,
      args.page,
      args.per_page
    );
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  }

• index.ts:226-249 (schema)

  Tool schema definition including name, description, and input schema for esa_list_comments.

  const listCommentsTool: Tool = {
    name: "esa_list_comments",
    description: "Get a list of comments for a post",
    inputSchema: {
      type: "object",
      properties: {
        post_number: {
          type: "number",
          description: "Post number to get comments for",
        },
        page: {
          type: "number",
          description: "Page number to retrieve",
          default: 1,
        },
        per_page: {
          type: "number",
          description: "Number of results per page (default: 20, max: 100)",
          default: 20,
        },
      },
      required: ["post_number"],
    },
  };

• index.ts:389-399 (helper)

  EsaClient helper method that performs the HTTP request to the esa API to list comments for a given post.

  async listComments(post_number: number, page?: number, per_page?: number): Promise<any> {
    const params = new URLSearchParams();
    
    if (page) params.append("page", page.toString());
    if (per_page) params.append("per_page", per_page.toString());
  
    const url = `${this.baseUrl}/posts/${post_number}/comments${params.toString() ? `?${params}` : ""}`;
    const response = await fetch(url, { headers: this.headers });
  
    return response.json();
  }

• index.ts:49-53 (schema)

  TypeScript interface defining the expected arguments for the esa_list_comments tool.

  interface ListCommentsArgs {
    post_number: number;
    page?: number;
    per_page?: number;
  }

• index.ts:607-619 (registration)

  Tool registration in the ListToolsRequest handler by including listCommentsTool in the returned tools list.

      tools: [
        listPostsTool,
        getPostTool,
        createPostTool,
        updatePostTool,
        listCommentsTool,
        getCommentTool,
        createCommentTool,
        getMembersTool,
        getMemberTool,
      ],
    };
  });