Content
# Website Toolbox MCP
Chat with your forum using AI. The Website Toolbox MCP server lets you manage categories, topics, posts, users, and more through any MCP-compatible AI tool like [Claude Desktop](https://claude.ai), [Cursor](https://cursor.com), or [Hermes Agent](https://github.com/nousresearch/hermes-agent).
## Install in Claude Desktop
1. Open [Claude Desktop](https://claude.ai/download). If you don't have it, download it first.
2. [Download the .mcpb bundle](https://github.com/webtoolbox/websitetoolbox-mcp/releases/latest/download/websitetoolbox-mcp.mcpb).
3. In Claude Desktop, go to **Settings** (click your name at the bottom left, then the gear icon), then click **Extensions** in the left sidebar.
4. Click **Install from file** and select the downloaded `.mcpb` file.
5. When prompted, enter your forum's [API key](https://www.websitetoolbox.com/support/getting-your-api-key-252). You can find it in your forum's admin area under **Integrate → API**.
6. Start a new conversation and ask something about your forum!
## Features
| Resource | Tools |
|---|---|
| **Categories** | list, get, create, update, delete, list permissions, update permissions |
| **Topics** | list, get, create, update, delete |
| **Posts** | list, get, create, update, delete |
| **Users** | list, get, create, update, delete, follow topics, unfollow topics |
| **User Groups** | list, get, create, update, delete, add users, remove users |
| **Conversations** | list, get, create, delete |
| **Messages** | list, get, create |
| **Moderators** | list, get, create, update, delete |
| **Tags** | list |
| **Page Views** | list |
---
## For developers
### Prerequisites
- Node.js ≥ 18
### Install
#### From npm
```bash
npm install -g websitetoolbox-mcp
```
#### From source
```bash
git clone https://github.com/webtoolbox/websitetoolbox-mcp
cd websitetoolbox-mcp
npm install
npm run build
```
### Configure
1. **Get your [API key](https://www.websitetoolbox.com/support/getting-your-api-key-252)** from your forum's **Integrate → API** settings.
2. **Set it as an environment variable:**
```bash
export WEBSITETOOLBOX_API_KEY="your-api-key"
```
On **Windows**:
```cmd
set WEBSITETOOLBOX_API_KEY=your-api-key
```
Or create a `.env` file (copy `.env.example` to `.env` and fill in your key).
3. **Optional** — act as a specific user:
```bash
export WEBSITETOOLBOX_USERNAME="admin"
export WEBSITETOOLBOX_EMAIL="admin@example.com"
```
### Claude Desktop (manual config)
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"websitetoolbox": {
"command": "npx",
"args": ["websitetoolbox-mcp"],
"env": {
"WEBSITETOOLBOX_API_KEY": "your-api-key"
}
}
}
}
```
### Other MCP clients
Run the server on stdio:
```bash
npx websitetoolbox-mcp
```
### API Reference
This MCP server wraps the [Website Toolbox REST API](https://www.websitetoolbox.com/docs/api/). See the full API documentation at [https://www.websitetoolbox.com/docs/api/](https://www.websitetoolbox.com/docs/api/) or the [API Documentation](https://www.websitetoolbox.com/support/api-documentation-663) support article for details on authentication, endpoints, and rate limits.
## License
MIT
