buddypress_create_message

Create and send private messages between users on a BuddyPress community site. Specify recipients, subject, and content to facilitate user communication.

Instructions

Create a new message

Input Schema

TableJSON Schema

Name	Required	Description
`sender_id`	No	Sender user ID (default: current user)
`recipients`	Yes	Array of recipient user IDs
`subject`	Yes	Message subject
`message`	Yes	Message content

Implementation Reference

src/index.ts:699-701 (handler)
Executes the buddypress_create_message tool by sending a POST request to the BuddyPress /messages endpoint with the provided arguments using the shared buddypressRequest helper.
```
else if (name === 'buddypress_create_message') {
  result = await buddypressRequest('/messages', 'POST', args);
}
```

src/index.ts:431-440 (schema)

Input schema defining the parameters for the buddypress_create_message tool, including required recipients, subject, and message.

inputSchema: {
  type: 'object',
  properties: {
    sender_id: { type: 'number', description: 'Sender user ID (default: current user)' },
    recipients: { type: 'array', items: { type: 'number' }, description: 'Array of recipient user IDs', required: true },
    subject: { type: 'string', description: 'Message subject', required: true },
    message: { type: 'string', description: 'Message content', required: true },
  },
  required: ['recipients', 'subject', 'message'],
},

src/index.ts:428-441 (registration)

Tool object registration in the tools array, used by listTools handler, including name, description, and schema.

{
  name: 'buddypress_create_message',
  description: 'Create a new message',
  inputSchema: {
    type: 'object',
    properties: {
      sender_id: { type: 'number', description: 'Sender user ID (default: current user)' },
      recipients: { type: 'array', items: { type: 'number' }, description: 'Array of recipient user IDs', required: true },
      subject: { type: 'string', description: 'Message subject', required: true },
      message: { type: 'string', description: 'Message content', required: true },
    },
    required: ['recipients', 'subject', 'message'],
  },
},

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

Shared helper function that makes authenticated HTTP requests to the BuddyPress REST API, used by all tool handlers including buddypress_create_message.

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