Buu AI MCP Server

Overview

This server acts as a command execution gateway for the Buu platform, exposing tools to manage teams, subthreads, and generation requests using a standardized MCP interface.

Features

• Connects to the Buu GraphQL server
• Supports Team, Subthread and GenRequest operations
• Enables generation request handling
• Authenticates with API key
• Communicates via `stdio` transport (ideal for CLI or tool embedding)

Client Installation Instructions

Running on Claude Desktop

To configure Octagon MCP for Claude Desktop:

npx -y @smithery/cli@latest install @OctagonAI/octagon-mcp-server --client claude

Configuration

Environment Variables

Required

• `BUU_TEAM_API_KEY`: Your Buu AI team API key
  • Required for all operations

Optional

• `BUU_SERVER_URL`: Buu API URL
  • By default uses the sandbox environment

Tool Registration

1. TeamTools

• `team_create` — Create a new team
• `team_add_member` — Add a member to a team
• `team_remove_member` — Remove a member from a team
• `team_update` — Update team data
• `team_update_member_role` — Update member role
• `team_get` — Get the personal team for the current user
• `team_get_all` — Get all teams for the current user

3. SubthreadTools

• `subthread_generate` — Generate a subthread for a Thread
• `subthread_get` — Get subthread by ID
• `subthread_get_all` — Get all team's subthread

4. GenRequestTools

• `generate_image` — Generate image for a subthread
• `generate_model` — Generate 3D model for subthread
• `genrequest_get_all` — Get all GenRequests for a specific subthread