Provides built-in kubectl port-forward management with auto-restart capabilities for connecting to Unblu deployments running in Kubernetes clusters.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Unblu MCP Serverlist all conversations from yesterday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
unblu-mcp
A Model Context Protocol (MCP) server for debugging and operating Unblu deployments. Optimised for debugging workflows — curated typed tools for common operations, plus an escape hatch for the full 300+ endpoint API.
📚
Design
The server exposes three layers, each progressively more powerful:
Layer | What it is | When to use |
Curated tools | Typed, token-efficient tools for common debugging tasks | 90% of debugging sessions |
| Generic escape hatch for any of 331 Unblu API operations | When a curated tool doesn't exist |
Resources | Read-only | Discovery and schema inspection |
Quick Start
Installation
uvx unblu-mcpOr install persistently: uv tool install unblu-mcp
MCP Client Configuration
Direct API access with an API key:
{
"mcpServers": {
"unblu": {
"command": "uvx",
"args": ["unblu-mcp"],
"env": {
"UNBLU_BASE_URL": "https://your-instance.unblu.cloud/app/rest/v4",
"UNBLU_API_KEY": "your-api-key"
}
}
}
}Kubernetes port-forward (auto-managed):
{
"mcpServers": {
"unblu": {
"command": "uvx",
"args": ["unblu-mcp", "--provider", "k8s", "--environment", "dev"],
"env": {
"PATH": "/Users/YOUR_USERNAME/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}Tools
Curated tools (read-only)
Tool | Description |
| Current account info — good first call to verify connectivity |
| Search conversations with filters |
| Full conversation detail with participants |
| Find persons (visitors, agents) |
| Full person detail |
| Batch-resolve up to 20 persons in parallel |
| Find registered users |
| Full user detail |
| Check agent availability per named area |
| List named areas (routing targets) |
| Discover API operations by keyword |
Mutation tools
Tool | Description |
| Assign a conversation to an agent |
| End an active conversation |
Escape hatch
Tool | Description |
| Execute any of the 331 Unblu API operations |
Resources
URI | Description |
| JSON list of all API service groups |
| Full resolved schema for a specific operation |
Prompts
Prompt | Description |
| Step-by-step debugging workflow for a conversation |
| Locate an agent and check their availability |
| Validate account configuration and connectivity |
Safety
By default, execute_operation blocks DELETE operations unless confirm_destructive=True is passed. For stricter control, install the optional Eunomia policy engine:
uv tool install "unblu-mcp[safety]"Then point to a policy file:
{
"mcpServers": {
"unblu": {
"command": "unblu-mcp",
"args": ["--policy", "config/mcp_policies.json"],
"env": { "UNBLU_BASE_URL": "...", "UNBLU_API_KEY": "..." }
}
}
}The bundled config/mcp_policies.json allows all read-only and curated tools while blocking destructive execute_operation calls by operation ID pattern.
Development
git clone https://github.com/detailobsessed/unblu-mcp.git
cd unblu-mcp
uv sync --all-extras --dev
uv run poe testLicense
ISC License