Which integrations are available for this server?

Provides built-in kubectl port-forward management with auto-restart capabilities for connecting to Unblu deployments running in [Kubernetes](/mcp/servers/integrations/kubernetes) clusters.

unblu-mcp

documentation pypi version python versions license FastMCP

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.

📚

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