BuddyPress MCP Server

Instructions

Implementation Reference

• src/index.ts:682-684 (handler)

  Executes the buddypress_delete_friendship tool by sending a DELETE request to the BuddyPress API endpoint `/friends/${id}` using the shared `buddypressRequest` helper function.

  else if (name === 'buddypress_delete_friendship') {
    result = await buddypressRequest(`/friends/${args.id}`, 'DELETE');
  }

• src/index.ts:393-399 (schema)

  Defines the input schema for the tool, requiring a single 'id' parameter of type number representing the friendship ID.

  inputSchema: {
    type: 'object',
    properties: {
      id: { type: 'number', description: 'Friendship ID', required: true },
    },
    required: ['id'],
  },

• src/index.ts:390-400 (registration)

  Registers the buddypress_delete_friendship tool in the global tools array used for listing available tools.

  {
    name: 'buddypress_delete_friendship',
    description: 'Delete a friendship',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'number', description: 'Friendship ID', required: true },
      },
      required: ['id'],
    },
  },

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

  Helper function that performs authenticated HTTP requests to the BuddyPress REST API, used by all tools including buddypress_delete_friendship.

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