# BuddyBoss API Doc MCP Server

An MCP (Model Context Protocol) server that exposes BuddyBoss REST API contracts grouped by category. Built from the official [BuddyBoss Platform](https://github.com/buddyboss/buddyboss-platform) source.

**Base URL:** `https://your-site.com/wp-json/buddyboss/v1`

## API Groups

| Group | Endpoints |
|-------|-----------|
| Activity | Feed, comments, favorites, pins, notifications |
| Members | Profiles, avatars, covers, signup |
| Groups | Social groups, membership, invites, settings |
| Messages | Private threads, group threads, actions |
| Notifications | User notifications |
| Friends | Friendship connections |
| XProfile | Extended profile fields, data, types, search |
| Media (Photos) | Photo uploads and albums |
| Video | Video uploads and management |
| Document | Document uploads and folders |
| Forums | Forums, topics, replies, actions |
| Moderation | Content and member reporting |
| Reactions | Emoji reactions |
| Subscriptions | Forum/topic subscriptions |
| Settings | Platform and account settings |
| Misc | Mentions, invites, blogs |

## MCP Tools

| Tool | Description |
|------|-------------|
| `list_groups` | List all API groups with counts |
| `list_endpoints` | List endpoints, optionally filtered by group |
| `search_endpoints` | Search endpoints by keyword |
| `get_group_details` | Full details for a specific group |

## Setup

```bash
npm install
npm run build
```

## Usage with Claude

Add to your Claude config:

```json
{
  "mcpServers": {
    "buddyboss-api": {
      "command": "node",
      "args": ["/path/to/buddyboss-api-doc-mcp/dist/index.js"]
    }
  }
}
```

## Development

```bash
npm run dev   # run with tsx (no build needed)
```