buddypress_update_notification

Mark BuddyPress notifications as read or unread to manage user alerts and maintain organized community engagement.

Instructions

Update notification (mark as read/unread)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	Notification ID
`is_new`	No	Mark as unread (true) or read (false)

Implementation Reference

src/index.ts:718-720 (handler)
The execution handler for the 'buddypress_update_notification' tool. It extracts the notification ID and body (containing 'is_new' flag) from arguments and sends a PUT request to the BuddyPress notifications endpoint.
```
else if (name === 'buddypress_update_notification') {
  const { id, ...body } = args as any;
  result = await buddypressRequest(`/notifications/${id}`, 'PUT', body);
```

src/index.ts:479-490 (registration)

Registration of the 'buddypress_update_notification' tool in the tools array, including name, description, and input schema definition.

{
  name: 'buddypress_update_notification',
  description: 'Update notification (mark as read/unread)',
  inputSchema: {
    type: 'object',
    properties: {
      id: { type: 'number', description: 'Notification ID', required: true },
      is_new: { type: 'boolean', description: 'Mark as unread (true) or read (false)' },
    },
    required: ['id'],
  },
},

src/index.ts:482-489 (schema)

Input schema definition for validating tool arguments: requires notification ID, optional is_new boolean to mark read/unread.

inputSchema: {
  type: 'object',
  properties: {
    id: { type: 'number', description: 'Notification ID', required: true },
    is_new: { type: 'boolean', description: 'Mark as unread (true) or read (false)' },
  },
  required: ['id'],
},

src/index.ts:18-46 (helper)

Shared helper function used by all BuddyPress tools, including this one, to make authenticated API requests.

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();
}

BuddyPress MCP Server