BeeBoo

This MCP server enables BeeBoo to interface with AI agents by exposing practical capabilities such as searching and managing a knowledge base, handling approvals, and creating work requests through a standardized Model Context Protocol connection.

How to use

You connect an MCP client to the BeeBoo MCP server to access knowledge base search, add, and list entries; request and check human approvals; and create or track work requests. After you configure an MCP client with the provided server settings, you can issue tool calls through your AI assistant to perform these actions. Use natural language prompts to search the knowledge base, add new entries, review approvals, or create work requests, and the MCP server will relay those actions to BeeBoo and return results or statuses to you.

How to install

Prerequisites you need before installing: Node.js and npm installed on your system.

Choose one of the following installation paths and follow the steps exactly.

# Local install via npm (recommended for quick setup)
npm install -g @beeboo/mcp-server

# Start using the local MCP server binary
beeboo-mcp-server

Additional setup details

Configure your MCP client with the BeeBoo server. You can use either a local npx-based setup or a published client configuration, as shown in the following examples.

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

Configuration options you will configure on clients

Assign your BeeBoo API key to the environment variable BEEBOO_API_KEY in your MCP client configuration. The API key authorizes your client to access BeeBoo resources.

Troubleshooting

If you encounter the error "BEEBOO_API_KEY environment variable is required", ensure you have set BEEBOO_API_KEY in your MCP configuration. If the server does not appear in your tools list, restart your AI tool, verify the configuration path, and confirm the JSON syntax is valid. If you face API errors, verify your API key, check network connectivity, and confirm BeeBoo status at the status endpoint.

Usage testing and validation

To verify basic tool availability and a simple call, use your MCP client to list tools and perform a sample call using the following patterns in your environment. Replace the placeholder with your actual key.

Development

To contribute or run locally for development, follow standard Node.js project workflows: install dependencies, build any required assets, and start the server using your chosen method.

Available tools

beeboo_knowledge_search

Search the knowledge base using semantic search to find relevant entries.

beeboo_knowledge_add

Add a new entry to the knowledge base with your content.

beeboo_knowledge_list

List all knowledge base entries currently stored in BeeBoo.

beeboo_approval_request

Request human approval for a specified action or operation.

beeboo_approval_check

Check the status of a previously submitted approval request.

beeboo_approvals_list

List all approval requests, with optional filters.

beeboo_request_create

Create a work request for the BeeBoo team with priority and details.

beeboo_requests_list

List all work requests, with optional filters and statuses.