Getting Started

Install

Homebrew (macOS / Linux) 

brew install babmcp/tap/bab

Install script (macOS / Linux) 

curl -fsSL https://raw.githubusercontent.com/babmcp/bab/main/install.sh | bash

Binary download

Grab the latest from the releases page, then chmod +x and move to a directory on your PATH.

From source

Requires Bun 1.3.9 or newer.

git clone https://github.com/babmcp/bab.git && cd bab
bun install
bun run build:binary   # compiled binary at dist/bab

Self-update 

bab selfupdate

Configuration

Bab creates and uses ~/.config/bab/:

  • ~/.config/bab/env — dotenv-style environment file
  • ~/.config/bab/plugins/ — delegate plugins (one directory per plugin)
  • ~/.config/bab/prompts/ — prompt overrides
  • ~/.config/bab/logs/ — log files (mcp.log, error.log, per-plugin logs)

Provider API Keys

Set these in ~/.config/bab/env or in your MCP client config:

  • GOOGLE_API_KEY
  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY
  • OPENROUTER_API_KEY
  • CUSTOM_API_KEY + CUSTOM_API_URL

Bab Environment Variables

Variable Type Description
BAB_DISABLED_TOOLS comma-separated Tool names to exclude
BAB_EAGER_TOOLS boolean Set to 1 to disable lazy tool loading
BAB_PERSIST boolean Set to false to disable report persistence
BAB_PERSIST_TOOLS comma-separated Only persist reports for these tools
BAB_DISABLED_PERSIST_TOOLS comma-separated Disable persistence for these tools
BAB_CLI_TIMEOUT_MS integer Override delegate CLI timeout (default: 3 hours)
BAB_MAX_CONCURRENT_PROCESSES integer Max concurrent delegate processes (default: 5)
BAB_LOG_LEVEL string debug, info, warn, or error (default: info)

Logging

Log files are stored in ~/.config/bab/logs/:

  • mcp.log — all server events
  • error.log — warnings and errors only
  • <pluginId>.log — per-plugin delegate I/O

Common Commands

Start the MCP server:

bab serve

Install the first-party external plugins:

bab add git@github.com:babmcp/plugins.git

Security note: Plugin adapters run as trusted code with full access to your filesystem and network. Bab will always prompt for confirmation before installing. Only install plugins from sources you trust.

List bundled and installed plugins:

bab list

Validate a plugin directory:

bab test-plugin ~/.config/bab/plugins/my-plugin

Build the distributable bundle:

bun run build

Optional single-binary build:

bun run build:binary