Skip to main content

MCP Server

The MCP server (vibecontrols-mcp binary, from @vibecontrols/mcp) exposes Vibecontrols and Burdenoff Workspaces capabilities as Model Context Protocol tools for AI assistants like Claude Desktop, ChatGPT desktop, etc.

Install​

npm install -g @vibecontrols/mcp
# or
bun install -g @vibecontrols/mcp

Binary: vibecontrols-mcp

Run​

Stdio transport (typical for Claude Desktop):

vibecontrols-mcp --stdio

HTTP transport (for remote clients):

vibecontrols-mcp --http --port 5555

Architecture​

The MCP server is a thin shell over the platform MCP modules. It mounts 21+ modules, each contributing tools:

authModule, vibecontrolsModule, sandboxModule, rbacModule, organizationsModule,
toursModule, workspacesModule, groupsModule, tagsModule, filesModule,
conversationsModule, securityModule, integrationsModule, channelsModule,
schedulerModule, exportModule, notificationsModule, supportModule,
productsModule, devportalModule, billingModule, storeModule

Tool names are product-prefixed via mcpToolName('vibecontrols', ...).

Vibecontrols-specific tools​

Come from the vibecontrolsModule in the platform MCP modules. They cover the same surface as the CLI — agents, vibes, sessions, vibedecks, webhooks, etc. Browse the live tool list via:

vibecontrols-mcp --list-tools

Claude Desktop integration​

Add to your Claude Desktop config:

{
  "mcpServers": {
    "vibecontrols": {
      "command": "vibecontrols-mcp",
      "args": ["--stdio"],
      "env": {
        "BURDENOFF_TOKEN": "...",
        "WORKSPACE_ID": "..."
      }
    }
  }
}

Source​

~/products/vibecontrols/vibecontrols-mcp/ (thin shell)

Next steps​