Unblu MCP Server
Provides built-in kubectl port-forward management with auto-restart capabilities for connecting to Unblu deployments running in Kubernetes clusters.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 |
Related MCP server: Dialpad Universal MCP Server
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):
For --provider k8s, you need all of the following:
kubectlinstalled and available to the MCP client processa valid Kubernetes login with access to the target namespace
a K8s environment map in
~/.unblu-mcp/k8s_environments.yamlor passed with--k8s-config
Quick bootstrap:
mkdir -p ~/.unblu-mcp
uvx unblu-mcp --print-k8s-config-template > ~/.unblu-mcp/k8s_environments.yamlThe --environment value must match a key from that YAML file, such as dev, test1, or t1.
Minimal config file:
environments:
dev:
local_port: 8084
namespace: unblu-dev
service: haproxy
service_port: 8080
api_path: /app/rest/v4Then point your MCP client at that environment:
{
"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"
}
}
}
}The env block is optional if your MCP client already inherits a PATH that includes both uvx and kubectl. Keep it if the client cannot otherwise find those binaries.
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 |
Development
git clone https://github.com/detailobsessed/unblu-mcp.git
cd unblu-mcp
uv sync --all-extras --dev
uv run poe testLicense
ISC License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect assistants to your workspace knowledge, skills, and work tools.
Connect your AI agent to 300+ methods and 100+ live tools
Discover, compare, route, and execute machine-accessible capabilities for AI agents.
Give AI agents 30,000+ safe, token-optimized actions across Workday, SAP, Oracle + hundreds more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Onboarded platform through automatic API discovery and execution, with entity memory persistence and optional source code access from local repositories.MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Dialpad's tools and services through a unified API, allowing users to manage communications via natural language.MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with access to OpenAPI specifications, enabling API discovery, schema retrieval, and direct API execution with support for OAuth 2.0 and other authentication methods.6 npm1MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to look up and update WorkForceAI platform data, including voice agents, campaigns, phone numbers, call logs, and dashboard stats, through natural language.-