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:

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