# Bluebox

> Bluebox is an MCP server for developer tools. Ask Bluebox about live production health, errors and root causes from your coding agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, vscode
- **Website:** https://docs.bluebox.ai/mcp-server
- **Repository:** https://github.com/bluebox-hq/skills
- **MCP Registry name:** ai.bluebox/mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-19

## About

The README describes Bluebox as an observability agent for AI-native development, and its MCP server lets a coding client query a workspace's live production environment in natural language. Answers come back as evidence-backed responses about service health, errors, latency and dependencies, and the agent can also read past investigations and their findings without changing them.

Connection is over Streamable HTTP at the Bluebox endpoint. Most supported clients sign in through the browser the first time they connect, while others, or agents running in cloud sandboxes, use a bearer access token. Questions can be followed up within the same thread, and long-running questions run in the background in clients that support it.

The product suits engineers who work in Claude Code, Cursor, VS Code, Codex and similar editors and want production context before they change code. Bluebox needs a connected observability backend in the workspace before it can answer.

## Features

- **Natural language production queries:** Ask questions about live services and get answers grounded in workspace telemetry.
- **Read past investigations:** Browse findings and summaries from investigations, including those shared with the workspace, in read-only form.
- **Browser-based sign-in:** Clients that support MCP sign-in approve access in the browser without pasting a token.
- **Workspace scoping:** Pin a connection to one workspace with an X-Workspace-Id header.
- **Follow-up questions:** Continue a thread while the earlier service and time window carry over unless changed.
- **Revocable agent connections:** Review and revoke approved agents and access tokens from the Account page.

## Good for

- Checking production error rates and latency before designing a code change
- Loading the root cause of a Bluebox investigation into a fix in the editor
- Exploring which services and repositories are connected to a workspace
- Asking a coding agent about dependencies of a failing service

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://app.bluebox.ai/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.bluebox.ai/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://app.bluebox.ai/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://app.bluebox.ai/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://app.bluebox.ai/v1/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://app.bluebox.ai/v1/mcp
```

Enter a Name (for example "Bluebox"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://app.bluebox.ai/v1/mcp"
    }
  }
}
```

## FAQ

### Which clients can connect to Bluebox?

The docs list Claude Code, Claude Desktop, Visual Studio Code, Cursor, Kiro, Kiro web, Codex, and other MCP clients that support Streamable HTTP.

### Do I need an access token?

Not for clients that support MCP sign-in, which open a browser for approval. Clients without sign-in support, or agents running where a browser cannot open, use a bearer access token instead.

### Can the agent change investigations?

No. The docs say the agent reads investigations with the user's access and cannot change them.

### Why does a new workspace return no services?

Until an observability backend is connected to the workspace, list_services returns nothing and questions reply that no backend is connected yet.

### How do I add Bluebox to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://app.bluebox.ai/v1/mcp

### What are the best alternatives to Bluebox?

The closest alternatives to Bluebox are Agent Blueprint, Simular, q4a.dev - Questions 4 Agents, Cloud for Bots and Charlotte.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent Blueprint](https://ai-powered.com/mcp/agent-blueprint-2): Agent Blueprint is an MCP server for developer tools.
- [Simular](https://ai-powered.com/mcp/simular): Simular is a freemium MCP server for developer tools.
- [q4a.dev - Questions 4 Agents](https://ai-powered.com/mcp/q4a-dev-questions-4-agents): q4a.dev - Questions 4 Agents is a free MCP server for community directories.
- [Cloud for Bots](https://ai-powered.com/mcp/cloud-for-bots): Cloud for Bots is a freemium MCP server for cloud and infrastructure.
- [Charlotte](https://ai-powered.com/mcp/charlotte): Charlotte is an MCP server for developer tools.
- [Feedbacks](https://ai-powered.com/mcp/feedbacks): Feedbacks is an open-source MCP server for developer tools.
- [Lockbox](https://ai-powered.com/mcp/lockbox-3): Lockbox is an open-source MCP server for security.
- [BoxCompute](https://ai-powered.com/mcp/boxcompute): BoxCompute is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/bluebox-2
