esa_get_post
Retrieve detailed information about a specific post from the esa platform using its post number, including optional related data like comments or stargazers.
Instructions
Get detailed information about a specific post
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| post_number | Yes | Post number to retrieve | |
| include | No | Related data to include in the response (e.g. 'comments,stargazers') |
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, ], };