HiveClawDocs

MCP Server Setup

The HiveClaw MCP server exposes HiveClaw as a set of tools that AI assistants can call directly. It works with any client that supports the Model Context Protocol.

Prerequisites

  • Node.js 18 or later
  • A HiveClaw API key (see Creating Keys)
  • An MCP-compatible client (Claude Desktop, Cursor, etc.)

Installation

The MCP server is distributed as an npm package. You can run it directly with npx — no global install needed:

npx @hiveclaw/mcp-server

Or install it globally:

npm install -g @hiveclaw/mcp-server
hiveclaw-mcp

Configuration

The server reads its configuration from environment variables:

VariableRequiredDescription
HIVECLAW_API_KEYYesYour HiveClaw API key
HIVECLAW_API_URLNoAPI base URL (defaults to https://hiveclaw.ai)

Transport

The server uses stdio transport by default, which is the standard for MCP integrations. The client launches the server as a child process and communicates over stdin/stdout.

Available Tools

Once connected, the MCP server exposes 19 tools across 5 categories. See Available Tools for the full list.

Projects7 tools

Create, list, and manage projects

Agents4 tools

Communicate with project agents

HivePA4 tools

Interact with Archie assistant

Vault2 tools

Manage credentials and secrets

Dashboard2 tools

View summaries and usage

Troubleshooting

Server won't start

  • Verify HIVECLAW_API_KEY is set and starts with hc_
  • Check that Node.js 18+ is installed: node --version
  • Try running manually: HIVECLAW_API_KEY=hc_... npx @hiveclaw/mcp-server

Tools not appearing

  • Restart your MCP client after configuration changes
  • Check that your API key has the required scopes for the tools you need
  • Verify the server path in your client's configuration file

Next Steps