Hive-Mind Prompt References Non-Existent MCP Tools

[TerrysPOV]

Hive-Mind Prompt References Non-Existent MCP Tools

Related: #236, #125

Summary

The hive-mind spawn command generates a coordination prompt that references 20+ MCP tools which do not exist in the actual MCP server. This causes spawned Claude Code instances to halt and request alternatives.

Environment

• claude-flow version: v2.7.47 (@Alpha)
• Node.js: v20.x
• Platform: macOS

Steps to Reproduce

1. Configure MCP server:

   claude mcp add claude-flow npx claude-flow@alpha mcp start

2. Spawn a hive-mind task:

   npx claude-flow@alpha hive-mind spawn "any task" --claude

3. Observe the generated prompt in .hive-mind/sessions/hive-mind-prompt-*.txt

4. Note that the spawned Claude Code instance cannot execute because tools don't exist

Expected MCP Tools (from prompt)

mcp__claude-flow__consensus_vote
mcp__claude-flow__queen_command
mcp__claude-flow__queen_monitor
mcp__claude-flow__swarm_think
mcp__claude-flow__memory_share
mcp__claude-flow__neural_sync
mcp__claude-flow__agent_assign
mcp__claude-flow__task_distribute
... (20+ tools)

Actual MCP Tools (from server)

mcp__claude-flow_alpha__swarm_init
mcp__claude-flow_alpha__agent_spawn
mcp__claude-flow_alpha__task_orchestrate
mcp__claude-flow_alpha__memory_usage
mcp__claude-flow_alpha__memory_search
... (tools have _alpha suffix, different names)

Root Cause

The hive-mind prompt generator appears to use tool names from Issue #125 (Epic roadmap) which were never implemented. Two issues:

1. Naming mismatch: Real tools use claude-flow_alpha prefix, prompt uses claude-flow
2. Missing tools: Queen/Consensus/Neural-sync tools from the Wiki don't exist as MCP tools

Impact

• Hive-mind feature is unusable as documented
• Users must fall back to swarm command or native Task tool
• Documentation (Wiki, README) describes functionality that doesn't work

Suggested Fix

Either:

1. Update prompt generator to use actual tool names (_alpha suffix)
2. Implement the missing tools to match the roadmap
3. Document the limitation and recommend swarm as the working alternative

Workaround

Use swarm command directly instead of hive-mind spawn:

# This works
npx claude-flow@alpha swarm "your task" --claude

# This doesn't (tool mismatch)
npx claude-flow@alpha hive-mind spawn "your task" --claude

References

• Issue Claude Code not using Claude Flow MCP, But Accessing Files Instead #236: Claude Code not using Claude Flow MCP, accessing files instead
• Issue Epic: Hive Mind: Unlimited Agent Swarm with Hive Mind - Complete MCP Integration & CLI Wizards #125: Epic roadmap with tool specifications that weren't implemented
• Wiki: Hive-Mind Intelligence (describes non-existent functionality)