Unblu
by detailobsessedcommunityv0.10.1
1
This MCP server facilitates debugging and operating Unblu deployments by providing curated tools for common tasks and access to a comprehensive API.
From the registry: Operate Unblu deployments: health checks, conversation ops, and 300+ API endpoints
Install & configure
Prerequisites
- required
- required
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `unblu` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **uv / uvx** — Required to run the Python package via uvx. Run: `pip install uv` (https://github.com/astral-sh/uv)
- **Unblu Instance** — Access to an Unblu deployment. (https://www.unblu.com)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["unblu-mcp"]
- required environment variables:
- `UNBLU_BASE_URL`: Base URL of your Unblu instance REST API. (example: `https://your-instance.unblu.cloud/app/rest/v4`)
- `UNBLU_API_KEY`: API key for authenticating with Unblu. (example: `your-api-key`)
Note: Also supports Kubernetes port-forward mode with --provider k8s and a k8s_environments.yaml config file. Provides 331 API operations via curated tools + execute_operation escape hatch.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Also supports Kubernetes port-forward mode with --provider k8s and a k8s_environments.yaml config file. Provides 331 API operations via curated tools + execute_operation escape hatch.
Tools (14)
get_current_account
Current account info — good first call to verify connectivity
search_conversations
Search conversations with filters
get_conversation
Full conversation detail with participants
search_persons
Find persons (visitors, agents)
get_person
Full person detail
get_persons
Batch-resolve up to 20 persons in parallel
search_users
Find registered users
get_user
Full user detail
check_agent_availability
Check agent availability per named area
search_named_areas
List named areas (routing targets)
find_operation
Discover API operations by keyword
assign_conversation
Assign a conversation to an agent
end_conversation
End an active conversation
execute_operation
Execute any of the 331 Unblu API operations
Environment variables
UNBLU_BASE_URLrequiredBase URL for the Unblu APIUNBLU_API_KEYrequiredAPI key for accessing Unblu servicesPackages
unblu-mcp
pypiv0.10.1transport: stdio
Details
- Language
- Python
- License
- ISC
- Released
- Mar 5, 2026
- Last commit
- May 15, 2026
- Registry name
- io.github.detailobsessed/unblu