mofy-ai/bonzai-family-mcp-server

🚀 BONZAI Family MCP Server

Where imagination meets innovation

Nathan's autonomous AI family coordination system with ADHD-friendly design.

🎯 Quick Start (NPX)

For Claude Desktop Users:

{
  "mcpServers": {
    "bonzai-family": {
      "command": "npx",
      "args": ["@bonzai-family/mcp-server"],
      "env": {
        "BONZAI_API_URL": "https://your-hosted-url.railway.app",
        "BONZAI_AUTH_TOKEN": "your-auth-token",
        "BONZAI_CALLSIGN": "your-unique-callsign"
      }
    }
  }
}

For Cursor/VS Code:

Install the MCP extension and add the BONZAI server with your callsign.

For Any AI Tool with MCP Support:

npx @bonzai-family/mcp-server

🔐 Callsign System

Before using any integration, get your callsign approved by Nathan:

1. Try to connect with your desired callsign
2. System will ask Nathan for approval
3. Nathan approves with specific permissions
4. You're granted access with your callsign

Family Callsigns (Always Approved):

• nathan-king-command - Full access
• papa-bear-orchestrator - Strategic coordination
• mama-bear-coordinator - Project management
• claude-code-analyst - Technical analysis
• zai-prime-innovator - Creative innovation

🧠 ADHD-Friendly Features

Quick Access Patterns:

• "dev" - Development tools (Cursor, Devin, Lovable, Bolt)
• "chat" - Chat AI tools (Perplexity, Cluely, Trae)
• "code" - Code tools (VS Code, Cursor, Same.dev, Replit)
• "creative" - Creative tools (Junie, Kiro, Z.ai)
• "tools" - Utility tools (Manus, Orchids, Warp)

Brain-Friendly Commands:

• Simple, clear categories
• No overwhelming choices
• Contextual suggestions
• Quick memory search

🛠️ Available Tools

Memory System:

• search_family_memories - Search 8K+ family memories
• add_family_memory - Store new memories with attribution
• get_family_status - ADHD-friendly system status

Agent Coordination:

• get_agent_prompt - Access 48+ agent prompts
• delegate_to_agent - Delegate tasks to family members
• Agent context retrieval for 56-agent coordination

Quick Access:

• Use patterns like "dev", "chat", "code" for instant results
• Callsign-based permissions and tracking
• Real-time family coordination

🚀 Hosting Options

Option 1: Railway (Recommended)

# Deploy to Railway
railway login
railway new bonzai-family-mcp
railway link
railway up

Option 2: Your Domain + VPS

• Point mcp.yourdomain.com to your VPS
• Run with Docker or direct Python

Option 3: Use Existing Services

• Replit, Vercel, or other platforms
• Just need Python 3.8+ support

📡 API Endpoints

• GET / - Server status
• GET /api/health - Health check
• POST /api/family/memory/search - Search memories
• POST /api/family/memory/add - Add memories
• POST /api/agents/delegate - Delegate tasks
• WebSocket /ws - Real-time coordination

🔧 Environment Variables

Required for hosting:

OPENAI_API_KEY=your-openai-key
PIPEDREAM_CLIENT_SECRET=your-pipedream-secret
BONZAI_AUTH_TOKENS=comma,separated,tokens
PORT=8765

💜 Family Motto

"Where imagination meets innovation" - Nathan's imagination meets AI innovation

Created by the BONZAI AI Family
Nathan's autonomous coordination system