esa MCP Server

Instructions

Implementation Reference

• index.ts:491-500 (handler)

  Executes the esa_get_post tool: validates post_number, calls EsaClient.getPost, returns JSON response.

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

• index.ts:114-131 (schema)

  Defines Tool metadata, name, description, and input schema for esa_get_post.

  const getPostTool: Tool = {
    name: "esa_get_post",
    description: "Get detailed information about a specific post",
    inputSchema: {
      type: "object",
      properties: {
        post_number: {
          type: "number",
          description: "Post number to retrieve",
        },
        include: {
          type: "string",
          description: "Related data to include in the response (e.g. 'comments,stargazers')",
        },
      },
      required: ["post_number"],
    },
  };

• index.ts:356-365 (helper)

  Core implementation: constructs URL and fetches post data from Esa API.

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

• index.ts:607-618 (registration)

  Registers getPostTool (esa_get_post) in the list of tools provided to MCP clients.

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