discourse_read_post
Retrieve a specific post from a Discourse forum by providing its unique post ID for reading content and accessing information.
Instructions
Read a specific post.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| post_id | Yes |
Implementation Reference
- src/tools/builtin/read_post.ts:16-34 (handler)Executes the tool logic: fetches post data from Discourse API via cached GET to /posts/{post_id}.json?include_raw=true, extracts username, created_at, raw content, limits to maxReadLength, builds formatted text with link, returns as text content block or error.async ({ post_id }, _extra: any) => { try { const { base, client } = ctx.siteState.ensureSelectedSite(); // Prefer raw by asking API for include_raw const data = (await client.getCached(`/posts/${post_id}.json?include_raw=true`, 10000)) as any; const username = data?.username || data?.user_id || "user"; const created = data?.created_at || ""; const raw: string = data?.raw || data?.cooked || ""; const limit = Number.isFinite(ctx.maxReadLength) ? ctx.maxReadLength : 50000; const content = raw.slice(0, limit); const url = data?.topic_slug && data?.topic_id ? `${base}/t/${data.topic_slug}/${data.topic_id}/${data.post_number}` : `${base}/posts/${post_id}`; const text = `Post by @${username} (${created})\n\n${content}${raw.length > content.length ? `\n… (+${raw.length - content.length} more)` : ""}\n\nLink: ${url}`; return { content: [{ type: "text", text }] }; } catch (e: any) { return { content: [{ type: "text", text: `Failed to read post ${post_id}: ${e?.message || String(e)}` }], isError: true }; } }
- src/tools/builtin/read_post.ts:5-7 (schema)Zod schema defining input: post_id as positive integer.const schema = z.object({ post_id: z.number().int().positive(), });
- src/tools/builtin/read_post.ts:9-35 (registration)Registers the discourse_read_post tool with MCP server, providing name, metadata (title, description), input schema, and inline handler function.server.registerTool( "discourse_read_post", { title: "Read Post", description: "Read a specific post.", inputSchema: schema.shape, }, async ({ post_id }, _extra: any) => { try { const { base, client } = ctx.siteState.ensureSelectedSite(); // Prefer raw by asking API for include_raw const data = (await client.getCached(`/posts/${post_id}.json?include_raw=true`, 10000)) as any; const username = data?.username || data?.user_id || "user"; const created = data?.created_at || ""; const raw: string = data?.raw || data?.cooked || ""; const limit = Number.isFinite(ctx.maxReadLength) ? ctx.maxReadLength : 50000; const content = raw.slice(0, limit); const url = data?.topic_slug && data?.topic_id ? `${base}/t/${data.topic_slug}/${data.topic_id}/${data.post_number}` : `${base}/posts/${post_id}`; const text = `Post by @${username} (${created})\n\n${content}${raw.length > content.length ? `\n… (+${raw.length - content.length} more)` : ""}\n\nLink: ${url}`; return { content: [{ type: "text", text }] }; } catch (e: any) { return { content: [{ type: "text", text: `Failed to read post ${post_id}: ${e?.message || String(e)}` }], isError: true }; } } );
- src/tools/registry.ts:52-52 (registration)Invokes registerReadPost during registerAllTools to add the tool to the MCP server.registerReadPost(server, ctx, { allowWrites: false });