BeeBoo Server

Model Context Protocol (MCP) server for BeeBoo — Human-in-the-Loop Infrastructure for AI Agents.

This server enables AI agents like Claude, Cursor, and Windsurf to natively interact with BeeBoo's capabilities:

• Knowledge Base — Search, add, and list knowledge entries
• Approvals — Request and check human approval status
• Work Requests — Create and track work requests

Quick Start

1. Get your API Key

Get your BeeBoo API key from beeboo.ai/settings/api-keys.

Your key will look like: bb_sk_xxxxxxxxxxxx

2. Install & Configure

Choose your AI tool:

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "beeboo": {
      "command": "npx",
      "args": ["-y", "@beeboo/mcp-server"],
      "env": {
        "BEEBOO_API_KEY": "bb_sk_your_key_here"
      }
    }
  }
}

Then restart Claude Desktop.

Cursor

Add to your Cursor settings (~/.cursor/mcp.json or via Settings > MCP):

{
  "mcpServers": {
    "beeboo": {
      "command": "npx",
      "args": ["-y", "@beeboo/mcp-server"],
      "env": {
        "BEEBOO_API_KEY": "bb_sk_your_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "beeboo": {
      "command": "npx",
      "args": ["-y", "@beeboo/mcp-server"],
      "env": {
        "BEEBOO_API_KEY": "bb_sk_your_key_here"
      }
    }
  }
}

Alternative: Local Install

npm install -g @beeboo/mcp-server

Then use beeboo-mcp-server instead of npx @beeboo/mcp-server.

Available Tools

Tool	Description
beeboo_knowledge_search	Search the knowledge base using semantic search
beeboo_knowledge_add	Add a new entry to the knowledge base
beeboo_knowledge_list	List all knowledge base entries
beeboo_approval_request	Request human approval for an action
beeboo_approval_check	Check status of an approval request
beeboo_approvals_list	List all approval requests (with optional filter)
beeboo_request_create	Create a work request for the team
beeboo_requests_list	List all work requests (with optional filter)

Usage Examples

Once configured, you can ask your AI assistant:

Knowledge Base:

• "Search the knowledge base for deployment procedures"
• "Add to the knowledge base: our AWS account ID is 123456789"
• "List all knowledge entries"

Approvals:

• "I need approval to delete the staging database"
• "Check if approval abc123 has been approved"
• "Show me all pending approvals"

Work Requests:

• "Create a high-priority request to update the SSL certificate"
• "List all open work requests"

Environment Variables

Variable	Required	Default	Description
BEEBOO_API_KEY	Yes	—	Your BeeBoo API key
BEEBOO_API_URL	No	https://beeboo-api-625726065149.us-central1.run.app	API endpoint

Testing

Test the server locally:

# List available tools
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | BEEBOO_API_KEY=your_key node index.js

# Test a tool call
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"beeboo_knowledge_list","arguments":{}}}' | BEEBOO_API_KEY=your_key node index.js

Troubleshooting

"BEEBOO_API_KEY environment variable is required"

Make sure you've set the BEEBOO_API_KEY in your MCP configuration.

Server not appearing in tools list

1. Restart your AI tool (Claude Desktop, Cursor, etc.)
2. Check the configuration file path is correct
3. Verify the JSON syntax is valid

API errors

1. Check your API key is valid
2. Ensure you have network connectivity
3. Check the BeeBoo status at status.beeboo.ai

Development

# Clone the repo
git clone https://github.com/beeboo-ai/beeboo.git
cd beeboo/mcp-server

# Install dependencies
npm install

# Run locally
BEEBOO_API_KEY=your_key npm start

License

MIT