Skip to content

MCP Server

bnerd can run as a Model Context Protocol (MCP) server, allowing AI clients to manage cloud infrastructure through structured tool calls.

Quick Start

bnerd mcp-server

This starts the MCP server over stdio transport in read-only mode (default).

What is MCP?

The Model Context Protocol is a standard for AI applications to interact with external tools. When running as an MCP server, bnerd exposes cloud management tools that AI clients (like Claude Desktop) can use to:

  • Query DNS zones, records, and domains
  • List compute resources (servers, volumes, networks)
  • View billing information
  • Manage Kubernetes clusters
  • Read and write files
  • Execute shell commands

Safety Modes

The server supports three safety modes that control which operations are available:

bnerd mcp-server --read-only        # Default: only read operations
bnerd mcp-server --non-destructive  # Read + create/update
bnerd mcp-server --allow-writes     # Full access including delete

Tools that normally require interactive confirmation (deletes, key rotation) stay hidden from MCP clients even under --allow-writes, since this transport has no human dialog to show that confirmation to. Pass --allow-destructive alongside --allow-writes to expose them anyway — doing so makes the connected MCP client the only confirmation layer.

See Safety Modes for details.

Team coordination tools

The server also registers bnerd_team_* tools (status, approve, answer, pause/resume, …) for driving an agent team — see Available Tools → Team Coordination for the full list.

Read this before reaching for them: these tools resolve a team through an in-process registry, so they only see a team running in the same process as the MCP server. The stock bnerd mcp-server runs as its own separate stdio process, so it cannot see a team launched from the TUI, bnerd web, or a separate bnerd team run invocation. Today, team approvals for a chat-driven team resolve via the TUI's inline prompts, not through these tools.

Server Information

Field Value
Implementation name bnerd-cloud
Transport stdio
Protocol MCP (Model Context Protocol)

Sections