buddypress_get_message
Retrieve a specific message thread from a BuddyPress community site using its thread ID to access conversation details.
Instructions
Get a single message thread
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Thread ID |
Implementation Reference
- src/index.ts:696-698 (handler)Handler implementation for the buddypress_get_message tool. It retrieves a single message thread by ID using the shared buddypressRequest helper with the endpoint `/messages/${args.id}`.
else if (name === 'buddypress_get_message') { result = await buddypressRequest(`/messages/${args.id}`); } - src/index.ts:417-427 (schema)Tool definition including name, description, and input schema for buddypress_get_message. The schema requires a numeric 'id' parameter for the thread ID. This object is part of the tools array used for registration.
{ name: 'buddypress_get_message', description: 'Get a single message thread', inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'Thread ID', required: true }, }, required: ['id'], }, }, - src/index.ts:528-530 (registration)Registration of all tools via ListToolsRequestHandler, which returns the tools array containing the buddypress_get_message tool definition.
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; }); - src/index.ts:18-46 (helper)Shared helper function buddypressRequest used by all BuddyPress tools, including buddypress_get_message, to make authenticated HTTP requests to the BuddyPress REST API.
async function buddypressRequest( endpoint: string, method: string = 'GET', body?: any ): Promise<any> { const url = `${BUDDYPRESS_URL}/wp-json/buddypress/v2${endpoint}`; const auth = Buffer.from(`${BUDDYPRESS_USERNAME}:${BUDDYPRESS_PASSWORD}`).toString('base64'); const options: any = { method, headers: { 'Authorization': `Basic ${auth}`, 'Content-Type': 'application/json', }, }; if (body && method !== 'GET') { options.body = JSON.stringify(body); } const response = await fetch(url, options); if (!response.ok) { const errorText = await response.text(); throw new Error(`BuddyPress API Error (${response.status}): ${errorText}`); } return await response.json(); }