buddypress_get_notification
Retrieve a specific notification from a BuddyPress community site by providing its unique ID for management or review.
Instructions
Get a single notification
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Notification ID |
Implementation Reference
- src/index.ts:715-717 (handler)The execution handler for the 'buddypress_get_notification' tool. It calls the shared 'buddypressRequest' helper to fetch a single notification by ID from the BuddyPress '/notifications/{id}' API endpoint.
else if (name === 'buddypress_get_notification') { result = await buddypressRequest(`/notifications/${args.id}`); } - src/index.ts:469-478 (registration)Tool registration in the 'tools' array, which includes the tool name, description, and input schema definition. This array is returned by the ListTools handler.
name: 'buddypress_get_notification', description: 'Get a single notification', inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'Notification ID', required: true }, }, required: ['id'], }, }, - src/index.ts:471-477 (schema)Input schema definition for the tool, specifying that a numeric 'id' parameter is required.
inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'Notification ID', required: true }, }, required: ['id'], }, - src/index.ts:18-46 (helper)Shared utility function that performs authenticated HTTP requests to the BuddyPress REST API endpoints, handling authentication, JSON serialization, and error checking. This is the core implementation logic used by the tool handler.
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(); }