unblu-mcp

A Model Context Protocol (MCP) server for interacting with Unblu deployments. Provides AI assistants with token-efficient access to 300+ Unblu API endpoints through progressive disclosure.

📚 Full Documentation

Features

• Progressive Disclosure — 5 discovery tools instead of 300+ API definitions upfront
• Full API Coverage — Access to all Unblu REST API v4 endpoints
• Smart Discovery — Search and browse operations by service category or keyword
• Safety Controls — MCP annotations + optional Eunomia policy enforcement
• K8s Integration — Built-in kubectl port-forward management with auto-restart

Quick Start

Installation

uv tool install unblu-mcp

MCP Client Configuration

Add to your MCP client config (Claude Desktop, Windsurf, etc.):

{
  "mcpServers": {
    "unblu": {
      "command": "unblu-mcp",
      "args": ["--provider", "k8s", "--environment", "dev"],
      "env": {
        "PATH": "/Users/YOUR_USERNAME/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Or with environment variables for direct API access:

{
  "mcpServers": {
    "unblu": {
      "command": "unblu-mcp",
      "env": {
        "PATH": "/Users/YOUR_USERNAME/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
        "UNBLU_BASE_URL": "https://your-instance.unblu.cloud/app/rest/v4",
        "UNBLU_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Tool	Description
list_services()	List all API service categories
list_operations(service)	List operations in a specific service
search_operations(query)	Search for operations by keyword
get_operation_schema(operation_id)	Get full schema for an operation
call_api(operation_id, ...)	Execute any API operation

Documentation

For complete documentation including:

• Detailed configuration options
• Kubernetes provider setup
• Safety & authorization policies
• Programmatic usage
• Troubleshooting

Visit detailobsessed.github.io/unblu-mcp

Development

git clone https://github.com/detailobsessed/unblu-mcp.git
cd unblu-mcp
uv sync --all-extras --dev
uv run poe test

License

ISC License