# Reported issues for ruv-swarm

Pod holds 10 of 10 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [ruv-swarm](/mcp/ruv-swarm).

## Most discussed

### [Bug]: Invalid JSON Schema - daa_workflow_create 'steps' array missing 'items' property

## Bug Description

The `daa_workflow_create` MCP tool has an invalid JSON Schema definition that causes errors when used with Claude models. The `steps` property is defined as an array but is missing the required `items` property.

## Error Message

```
Invalid schema for function 'ruv-swarm_daa_workflow_create': In context=('properties', 'steps'), array schema missing items.
```

## Root Cause

In `ruv-swarm/npm/src/mcp-daa-tools.js`, the `inputSchema` for `daa_workflow_create` is:

```javascr

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/182) · 2026-02-01 · open · external user · 0 comments

### Bug: agent_metrics fails with 'neuralNetworks.map is not a function'

## Bug Description

The `agent_metrics` MCP tool fails with error:
```
MCP error -32603: MCP tool error: neuralNetworks.map is not a function
```

## Root Cause

In `src/mcp-tools-enhanced.js`, lines 2445 and 2448 call async methods from `SwarmPersistencePooled` **without `await`**:

```javascript
// Line 2445 - Missing await
const dbMetrics = this.persistence.getMetrics('agent', agent.id);

// Line 2448 - Missing await  
const neuralNetworks = this.persistence.getAgentNeuralNetworks(agent.id);

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/181) · 2026-01-25 · open · external user · 0 comments

### [BUG] TypeError: agents is not iterable in RUV-Swarm loadSwarms method

# GitHub Issue Content

---

**Title:** [BUG] TypeError: agents is not iterable in RUV-Swarm loadSwarms method

## Bug Description

The RUV-Swarm MCP server crashes with a **TypeError: agents is not iterable** error when attempting to load swarm agents during swarm initialization. This occurs because of a missing `await` keyword when calling the async `getSwarmAgents()` method, causing the code to attempt iteration over a Promise object instead of an array.

## Environment Details

- **Package:*

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/180) · 2025-11-27 · open · external user · 0 comments

### [BUG] `neural_train` MCP tool called without required `agentId` parameter in tests

# Bug: `neural_train` MCP tool called without required `agentId` parameter in tests

## Description

The `neural_train` MCP tool is being called without the required `agentId` parameter in test files, causing validation errors. The MCP handler correctly validates and rejects these calls with error code -32603.

## Error Details

```
ruv-swarm:neural_train (MCP) (iterations: 15)
Error: MCP error -32603: MCP tool error: agentId is required and must be a string
```

## Root Cause

The `neural_train

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/163) · 2025-07-22 · open · external user · 1 comment

### [BUG]

## 🐛 Bug Report

**Description:**
Unable to use ruv-swarm as an MCP tool inside Claude Code

**Steps to Reproduce:**
1. On MacOS install Claude Code using nvm with node 20.0.0
2. Switch Claude Code to local install
3. Log in using a Claude Max account
4. Use local install of ruv-swarm with --claude option
5. Install ruv-swarm using "claude mcp add ruv-swarm npx ruv-swarm mcp start"

**Expected Behavior:**
Type in /mcp and you see ruv-swarm as connected and ready to go

**Actual Behavior:**
Type 

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/142) · 2025-07-11 · open · external user · 35 comments

### [BUG] Swarm Session Lost - Need Recovery and Persistence Improvements

## 🐛 Problem

The swarm session was lost, requiring manual restart and reconfiguration. This indicates issues with swarm persistence and session management.

## 📍 Symptoms
- MCP server showed ruv-swarm was configured but swarm session was inactive
- Had to manually restart swarm with `mcp__ruv-swarm__swarm_init`
- Agent spawning required manual reconfiguration
- No automatic session restoration

## 🔧 Root Cause Analysis
- Swarm sessions are not persistent across disconnections
- No automatic ses

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/137) · 2025-07-10 · open · external user · 2 comments

### DAA Memory Persistence Not Functional - Agents/Workflows Lost Between Sessions

# DAA Memory Persistence Not Functional - Agents/Workflows Lost Between Sessions

## Description

The DAA (Decentralized Autonomous Agents) system's memory persistence feature is not functioning as expected. While agents and workflows operate correctly within a session, all DAA state is lost when the session ends, requiring complete recreation in subsequent sessions.

## Current Behavior

1. `mcp__ruv-swarm__memory_usage` with `action: "store"` returns only memory size info, not confirmation
2. 

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/83) · 2025-07-05 · open · external user · 0 comments

### 🐛 Terminal Views Not Displaying Data - WebSocket & API Integration Issues

## 🐛 Bug Report

### Description
Multiple terminal views are not displaying data properly due to WebSocket conflicts and missing API integrations.

### Issues Found

#### 1. **WebSocket Port Conflict (Port 4010)**
- Multiple instances of logger trying to start WebSocket server on same port
- Error: `EADDRINUSE: address already in use :::4010`
- **Fixed**: Modified `log-collector.ts` to not auto-start WebSocket server

#### 2. **Left Side Views Not Working**
- **Meme Launch View**: Shows empty ta

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/82) · 2025-07-05 · open · external user · 0 comments

## Most recent

### MCP Server stdout pollution prevents JSON-RPC communication

## Issue Description

The `ruv-swarm` MCP server outputs logging messages on stdout, which prevents proper JSON-RPC communication with MCP clients.

## Problem

When running `npx ruv-swarm mcp start`, the server outputs various logs to stdout:

```
[ERROR] Failed to initialize pooled persistence {...}
[ca426a4e...] [INFO] ruv-swarm MCP server starting in stdio mode
[ca426a4e...] [INFO] Connection established {...}
🧠 Initializing ruv-swarm with WASM capabilities...
✅ WASM bindings loaded successf

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/179) · 2025-10-17 · open · external user · 0 comments

### [BUG] ruv-swarm MCP server exits or fails after 10s

## 🐛 Bug Report

**Description:**
ruv-swarm MCP server starts and is supposedly available, but after a short while (less than 30s), it becomes unavailable. it seems like the process exits or stops responding to stdio. Experienced on existing projects, confirmed in isolation on a fresh repo.

**Steps to Reproduce:**
1. `claude mcp add ruv-swarm npx ruv-swarm mcp start` (also tested by building and installing from `main` rather than `npx`)
2. `claude`
3. `/mcp` shows ruv-swarm is connected
4. wait

[Read the thread](https://github.com/ruvnet/ruv-FANN/issues/145) · 2025-07-12 · closed · external user · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/ruvnet/ruv-FANN/issues).