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 clusters.

How do I use Unblu MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Unblu MCP Server list 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

documentation pypi version python versions license FastMCP

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.

📚 Full Documentation

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
`execute_operation`	Generic escape hatch for any of 331 Unblu API operations	When a curated tool doesn't exist
Resources	Read-only `api://` URIs for browsing the API surface	Discovery and schema inspection

Quick Start

Installation

uvx unblu-mcp

Or 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:

kubectl installed and available to the MCP client process
a valid Kubernetes login with access to the target namespace
a K8s environment map in ~/.unblu-mcp/k8s_environments.yaml or passed with --k8s-config

Quick bootstrap:

mkdir -p ~/.unblu-mcp
uvx unblu-mcp --print-k8s-config-template > ~/.unblu-mcp/k8s_environments.yaml

The --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/v4

Then 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
`get_current_account`	Current account info — good first call to verify connectivity
`search_conversations(status?, topic?, assignee_id?, limit?, fields?)`	Search conversations with filters
`get_conversation(conversation_id)`	Full conversation detail with participants
`search_persons(query?, email?, limit?, fields?)`	Find persons (visitors, agents)
`get_person(person_id)`	Full person detail
`get_persons(identifiers, fields?)`	Batch-resolve up to 20 persons in parallel
`search_users(query?, email?, limit?, fields?)`	Find registered users
`get_user(user_id)`	Full user detail
`check_agent_availability(named_area_id?)`	Check agent availability per named area
`search_named_areas(query?, limit?)`	List named areas (routing targets)
`find_operation(query, service?, include_schema?, limit?)`	Discover API operations by keyword

Mutation tools

Tool	Description
`assign_conversation(conversation_id, agent_id)`	Assign a conversation to an agent
`end_conversation(conversation_id)`	End an active conversation

Escape hatch

Tool	Description
`execute_operation(operation_id, path_params?, query_params?, body?, fields?, confirm_destructive?)`	Execute any of the 331 Unblu API operations

Resources

URI	Description
`api://services`	JSON list of all API service groups
`api://operations/{operation_id}`	Full resolved schema for a specific operation

Prompts

Prompt	Description
`debug_conversation(conversation_id)`	Step-by-step debugging workflow for a conversation
`find_agent(criteria)`	Locate an agent and check their availability
`account_health_check`	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 test

License

ISC License

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Unblu MCP Server

unblu-mcp

Design

Quick Start

Installation

MCP Client Configuration

Tools

Curated tools (read-only)

Mutation tools

Escape hatch

Resources

Prompts

Development

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API