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