bakescakes/mcp-server-habu

🚀 MCP Server for Habu

Model Context Protocol server for LiveRamp Clean Room API with comprehensive workflow automation

📖 Overview

Production-ready MCP server that provides intelligent, workflow-based access to the Habu Clean Room API. Built with OAuth2 authentication, 45 comprehensive tools, and enterprise-grade features for complete clean room lifecycle management.

🎯 Key Features

• 45 Production Tools - Complete coverage of clean room operations
• OAuth2 Authentication - Secure client credentials flow with Habu API
• Interactive Wizards - Step-by-step workflows for complex operations
• Multi-Cloud Support - Data connections across AWS, GCP, Azure, Snowflake
• Real-Time Monitoring - Question execution tracking and status updates
• Enterprise Ready - Security, compliance, and governance built-in

🏗️ Architecture

• TypeScript MCP Server - Built on Model Context Protocol standard
• Real API Integration - Direct connection to Habu production API
• Intelligent Workflows - Context-aware parameter detection and validation
• Mock Fallbacks - Graceful degradation when API unavailable

📊 Current Status

Live Project Status: See for real-time information
API Status: Available at for automated consumption
Dashboard Status: See for React dashboard deployment

🎯 Dashboard Integration

NEW: Production-ready React dashboard for monitoring Habu MCP Server status

🌐 Dashboard Architecture

• Backend API: Railway deployment (dashboard/backend/)
• Frontend: Vercel React app (dashboard/frontend/)
• Data Source: Live STATUS.json from this repository
• Auto-refresh: 30-second polling for real-time updates

📊 Dashboard Features

• Project Overview - Metrics, tools count, API status
• Tools Explorer - Interactive tool documentation
• Progress Tracking - Development timeline and milestones
• Documentation - Links to guides and references

🚀 Dashboard Deployment Status

• ✅ Code Complete - Dashboard pushed to GitHub
• ⏳ Railway API - Ready for deployment
• ⏳ Vercel Frontend - Ready for deployment
• ⏳ Production - Final testing pending

See for detailed deployment instructions.

🚀 MCP Server Quick Start

Prerequisites

• Node.js v18+
• Habu API credentials (CLIENT_ID, CLIENT_SECRET)
• MCP-compatible client (Claude, Memex, etc.)

Installation

# Clone repository  
git clone <repository-url>
cd mcp_server_for_habu

# Setup MCP server
cd mcp-habu-runner
npm install
npm run build

# Configure environment
cp .env.template .env
# Edit .env with your CLIENT_ID and CLIENT_SECRET

MCP Client Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "habu-cleanroom": {
      "command": "node",
      "args": ["./mcp-habu-runner/dist/index.js"],
      "env": {
        "CLIENT_ID": "your_client_id",
        "CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

First Steps

1. Test connection: Use test_connection tool to verify authentication
2. List resources: Try list_cleanrooms to see available clean rooms
3. Explore tools: Check MCP_TOOLS_REFERENCE.md for complete tool guide

📚 Documentation

Primary Documentation

• - Live project status, testing progress, current work
• - Complete setup, workflows, troubleshooting
• - User guide for all 45 tools
• - Implementation details and API analysis

Additional Resources

• - Comprehensive API implementation analysis
• - Known limitations and future work
• - Historical milestones and completed plans

⚠️ Known Issues

• 🔴 Authentication Configuration Bug: Environment variable credential passing fails; server currently works only with hardcoded fallback credentials. This blocks multi-user deployment until fixed. See for details.

🛠️ Development

For Developers

Complete development information is available in , including:

• Environment setup and configuration
• Testing workflows and best practices
• MCP server architecture and deployment
• Troubleshooting common issues
• React website integration
• Distribution and packaging

For Contributors

1. Read for setup
2. Check for current priorities
3. Follow testing workflow for new tools
4. Update documentation for any changes

🔧 Tool Categories

📄 License

MIT License - see for details

Built for the Model Context Protocol ecosystem • Production-ready • Enterprise-grade