Unblu

Token-efficient MCP server for 300+ Unblu API endpoints

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "unblu": {
      "command": "uvx",
      "args": [
        "unblu-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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.

📚 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

bash

uvx unblu-mcp

Or install persistently: uv tool install unblu-mcp

MCP Client Configuration

Direct API access with an API key:

config.json

{
  "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:

bash

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:

yaml

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:

config.json

{
  "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

bash

git clone https://github.com/detailobsessed/unblu-mcp.git
cd unblu-mcp
uv sync --all-extras --dev
uv run poe test

License

ISC License

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Unblu

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "unblu": { "command": "npx", "args": ["-y", "unblu"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/unblu?style=directory)](https://allmcps.com/mcp/unblu)

HTML Embed

<a href="https://allmcps.com/mcp/unblu"><img src="https://allmcps.com/api/badge/unblu?style=directory" alt="Unblu on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Unblu →Install in Claude Desktop Install in Cursor Install in VS Code

Unblu

Token-efficient MCP server for 300+ Unblu API endpoints

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "unblu": {
      "command": "uvx",
      "args": [
        "unblu-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

unblu-mcp

📚 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

bash

uvx unblu-mcp

Or install persistently: uv tool install unblu-mcp

MCP Client Configuration

Direct API access with an API key:

config.json

{
  "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:

bash

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:

yaml

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:

config.json

{
  "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

bash

git clone https://github.com/detailobsessed/unblu-mcp.git
cd unblu-mcp
uv sync --all-extras --dev
uv run poe test

License

ISC License

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Unblu

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "unblu": { "command": "npx", "args": ["-y", "unblu"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/unblu?style=directory)](https://allmcps.com/mcp/unblu)

HTML Embed

<a href="https://allmcps.com/mcp/unblu"><img src="https://allmcps.com/api/badge/unblu?style=directory" alt="Unblu on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Unblu →Install in Claude Desktop Install in Cursor Install in VS Code