# Bluebox

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

- **Kind:** MCP server
- **Platforms:** API, CLI, vscode, Web
- **Website:** https://docs.bluebox.ai/mcp-server
- **Repository:** https://github.com/bluebox-hq/skills
- **MCP Registry name:** io.github.bluebox-hq/bluebox
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

The README says the Bluebox MCP server brings a production environment into an MCP-capable coding agent. Once connected, the agent can ask natural-language questions about live services and receive evidence-backed answers, read past investigations including their findings and summaries, and browse the services and repositories linked to a workspace. Follow-up questions in the same thread keep the earlier service and time window unless the agent names new ones.

Access works through a remote Streamable HTTP endpoint at app.bluebox.ai. Most clients can sign in through the browser without a token, while clients that cannot sign in use a bearer access token. Sign-in grants the agent access to tools in the user's workspaces with the user's own permissions, and connections expire after 90 days or 14 days without use. Companion skills in the bluebox-hq/skills repository use the server when it is connected and fall back to the Bluebox CLI otherwise.

It suits engineers who want production context while they plan or review code changes in editors such as Claude Code, Cursor, VS Code, Codex or Kiro. Questions can take more than a minute, and the agent polls for the result in the background.

## Features

- **Natural language production queries:** Ask about live service behaviour and receive answers backed by evidence from the connected observability backend.
- **Investigation history access:** Read past investigations, including findings and summaries, with read-only access.
- **Service and repository browsing:** List the services and repositories connected to a workspace from inside the agent.
- **Threaded follow-ups:** Continue a conversation with follow-up questions that keep the earlier time window and service.
- **Workspace scoping:** Pin a connection to one workspace with an X-Workspace-Id header.
- **Browser sign-in or token access:** Connect with a browser approval flow where supported, or with a bearer token for other clients.

## Good for

- Checking error rates and latency before designing a change to a service
- Loading the root cause of an investigation that filed a GitHub issue before writing a fix
- Reviewing past investigation findings without leaving the editor
- Asking follow-up questions about a service's recent production behaviour

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bluebox 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": {
    "bluebox": {
      "url": "https://app.bluebox.ai/v1/mcp"
    }
  }
}
```

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

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

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

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

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

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

## FAQ

### How do I connect without an access token?

Add only the server URL, https://app.bluebox.ai/v1/mcp, in clients that support MCP sign-in. The agent opens a browser page where you approve access.

### How long does a sign-in connection last?

It ends 90 days after approval, or after 14 days without use, and then the agent must be approved again.

### Can the agent change investigations?

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

### Does Bluebox need a connected backend before it answers?

Yes. Until an observability backend is connected to the workspace, list_services returns no services and questions get a reply saying no backend is connected yet.

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

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

### What are the best alternatives to Bluebox?

The closest alternatives to Bluebox are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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