MCP Tool Reference

Auto-generated by replicator docs. 53 tools registered.

Org (11 tools)

org_cells

Query cells from the org database with flexible filtering. Use to list work items, find by status/type, or look up a cell by partial ID.

{
  "properties": {
    "id": {
      "description": "Partial cell ID to match",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 50)",
      "type": "number"
    },
    "ready": {
      "description": "If true, return only unblocked cells",
      "type": "boolean"
    },
    "status": {
      "enum": [
        "open",
        "in_progress",
        "blocked",
        "closed"
      ],
      "type": "string"
    },
    "type": {
      "enum": [
        "task",
        "bug",
        "feature",
        "epic",
        "chore"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

org_close

Close a cell with a reason.

{
  "properties": {
    "id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "reason"
  ],
  "type": "object"
}

org_create

Create a new cell (work item) in the org.

{
  "properties": {
    "description": {
      "type": "string"
    },
    "parent_id": {
      "type": "string"
    },
    "priority": {
      "maximum": 3,
      "minimum": 0,
      "type": "number"
    },
    "title": {
      "type": "string"
    },
    "type": {
      "enum": [
        "task",
        "bug",
        "feature",
        "epic",
        "chore"
      ],
      "type": "string"
    }
  },
  "required": [
    "title"
  ],
  "type": "object"
}

org_create_epic

Create an epic with subtasks in one atomic operation.

{
  "properties": {
    "epic_description": {
      "type": "string"
    },
    "epic_title": {
      "type": "string"
    },
    "subtasks": {
      "items": {
        "properties": {
          "files": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "priority": {
            "maximum": 3,
            "minimum": 0,
            "type": "number"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "epic_title",
    "subtasks"
  ],
  "type": "object"
}

org_query

Query cells with filters (alias for org_cells).

{
  "properties": {
    "id": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "ready": {
      "type": "boolean"
    },
    "status": {
      "enum": [
        "open",
        "in_progress",
        "blocked",
        "closed"
      ],
      "type": "string"
    },
    "type": {
      "enum": [
        "task",
        "bug",
        "feature",
        "epic",
        "chore"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

org_ready

Get the next ready cell (unblocked, highest priority).

{
  "properties": {},
  "type": "object"
}

org_session_end

End current session with handoff notes for next session.

{
  "properties": {
    "handoff_notes": {
      "type": "string"
    }
  },
  "type": "object"
}

org_session_start

Start a new work session. Returns previous session's handoff notes if available.

{
  "properties": {
    "active_cell_id": {
      "type": "string"
    }
  },
  "type": "object"
}

org_start

Mark a cell as in-progress.

{
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

org_sync

Sync cells to git and push.

{
  "properties": {
    "auto_pull": {
      "type": "boolean"
    },
    "project_path": {
      "description": "Project directory to sync (default: \".\")",
      "type": "string"
    }
  },
  "type": "object"
}

org_update

Update a cell's status, description, or priority.

{
  "properties": {
    "description": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "priority": {
      "maximum": 3,
      "minimum": 0,
      "type": "number"
    },
    "status": {
      "enum": [
        "open",
        "in_progress",
        "blocked",
        "closed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Comms (10 tools)

comms_ack

Acknowledge a message.

{
  "properties": {
    "message_id": {
      "type": "number"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

comms_health

Check comms database health.

{
  "properties": {},
  "type": "object"
}

comms_inbox

Fetch inbox (max 5 messages, bodies excluded).

{
  "properties": {
    "limit": {
      "maximum": 5,
      "type": "number"
    },
    "urgent_only": {
      "type": "boolean"
    }
  },
  "type": "object"
}

comms_init

Initialize comms session. Registers the agent.

{
  "properties": {
    "agent_name": {
      "type": "string"
    },
    "project_path": {
      "type": "string"
    },
    "task_description": {
      "type": "string"
    }
  },
  "required": [
    "project_path"
  ],
  "type": "object"
}

comms_read_message

Fetch one message body by ID.

{
  "properties": {
    "message_id": {
      "type": "number"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

comms_release

Release file reservations.

{
  "properties": {
    "paths": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "reservation_ids": {
      "items": {
        "type": "number"
      },
      "type": "array"
    }
  },
  "type": "object"
}

comms_release_agent

Release all file reservations for a specific agent.

{
  "properties": {
    "agent_name": {
      "type": "string"
    }
  },
  "required": [
    "agent_name"
  ],
  "type": "object"
}

comms_release_all

Release all file reservations in the project.

{
  "properties": {},
  "type": "object"
}

comms_reserve

Reserve file paths for exclusive editing.

{
  "properties": {
    "exclusive": {
      "type": "boolean"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "reason": {
      "type": "string"
    },
    "ttl_seconds": {
      "type": "number"
    }
  },
  "required": [
    "paths"
  ],
  "type": "object"
}

comms_send

Send a message to other agents via comms.

{
  "properties": {
    "ack_required": {
      "type": "boolean"
    },
    "body": {
      "type": "string"
    },
    "importance": {
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "thread_id": {
      "type": "string"
    },
    "to": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "to",
    "subject",
    "body"
  ],
  "type": "object"
}

Forge (24 tools)

forge_adversarial_review

VDD-style adversarial code review using hostile, fresh-context agent.

{
  "properties": {
    "diff": {
      "type": "string"
    },
    "test_output": {
      "type": "string"
    }
  },
  "required": [
    "diff"
  ],
  "type": "object"
}

forge_broadcast

Broadcast context update to all agents working on the same epic.

{
  "properties": {
    "agent_name": {
      "type": "string"
    },
    "epic_id": {
      "type": "string"
    },
    "files_affected": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "importance": {
      "enum": [
        "info",
        "warning",
        "blocker"
      ],
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "project_path": {
      "type": "string"
    }
  },
  "required": [
    "project_path",
    "agent_name",
    "epic_id",
    "message"
  ],
  "type": "object"
}

forge_complete

Mark subtask complete with Verification Gate.

{
  "properties": {
    "agent_name": {
      "type": "string"
    },
    "bead_id": {
      "type": "string"
    },
    "evaluation": {
      "type": "string"
    },
    "files_touched": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "project_key": {
      "type": "string"
    },
    "skip_review": {
      "type": "boolean"
    },
    "skip_verification": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    }
  },
  "required": [
    "project_key",
    "agent_name",
    "bead_id",
    "summary"
  ],
  "type": "object"
}

forge_complete_subtask

Handle subtask completion after Task agent returns.

{
  "properties": {
    "bead_id": {
      "type": "string"
    },
    "files_touched": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "task_result": {
      "type": "string"
    }
  },
  "required": [
    "bead_id",
    "task_result"
  ],
  "type": "object"
}

forge_decompose

Generate decomposition prompt for breaking task into subtasks.

{
  "properties": {
    "context": {
      "type": "string"
    },
    "max_subtasks": {
      "maximum": 10,
      "minimum": 2,
      "type": "integer"
    },
    "task": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "task"
  ],
  "type": "object"
}

forge_evaluation_prompt

Generate self-evaluation prompt for a completed subtask.

{
  "properties": {
    "bead_id": {
      "type": "string"
    },
    "files_touched": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "subtask_title": {
      "type": "string"
    }
  },
  "required": [
    "bead_id",
    "subtask_title",
    "files_touched"
  ],
  "type": "object"
}

forge_get_file_insights

Get file-specific gotchas for worker context.

{
  "properties": {
    "files": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "files"
  ],
  "type": "object"
}

forge_get_pattern_insights

Get common failure patterns across forges.

{
  "properties": {},
  "type": "object"
}

forge_get_strategy_insights

Get strategy success rates for decomposition planning.

{
  "properties": {
    "task": {
      "type": "string"
    }
  },
  "required": [
    "task"
  ],
  "type": "object"
}

forge_init

Initialize swarm session and check tool availability.

{
  "properties": {
    "isolation": {
      "enum": [
        "worktree",
        "reservation"
      ],
      "type": "string"
    },
    "project_path": {
      "type": "string"
    }
  },
  "type": "object"
}

forge_plan_prompt

Generate strategy-specific decomposition prompt.

{
  "properties": {
    "context": {
      "type": "string"
    },
    "max_subtasks": {
      "maximum": 10,
      "minimum": 2,
      "type": "integer"
    },
    "strategy": {
      "enum": [
        "file-based",
        "feature-based",
        "risk-based",
        "auto"
      ],
      "type": "string"
    },
    "task": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "task"
  ],
  "type": "object"
}

forge_progress

Report progress on a subtask to coordinator.

{
  "properties": {
    "agent_name": {
      "type": "string"
    },
    "bead_id": {
      "type": "string"
    },
    "files_touched": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "message": {
      "type": "string"
    },
    "progress_percent": {
      "maximum": 100,
      "minimum": 0,
      "type": "number"
    },
    "project_key": {
      "type": "string"
    },
    "status": {
      "enum": [
        "in_progress",
        "blocked",
        "completed",
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "project_key",
    "agent_name",
    "bead_id",
    "status"
  ],
  "type": "object"
}

forge_record_outcome

Record subtask outcome for implicit feedback scoring.

{
  "properties": {
    "bead_id": {
      "type": "string"
    },
    "criteria": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "duration_ms": {
      "minimum": 0,
      "type": "integer"
    },
    "error_count": {
      "minimum": 0,
      "type": "integer"
    },
    "files_touched": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "retry_count": {
      "minimum": 0,
      "type": "integer"
    },
    "strategy": {
      "enum": [
        "file-based",
        "feature-based",
        "risk-based"
      ],
      "type": "string"
    },
    "success": {
      "type": "boolean"
    }
  },
  "required": [
    "bead_id",
    "duration_ms",
    "success"
  ],
  "type": "object"
}

forge_review

Generate a review prompt for a completed subtask.

{
  "properties": {
    "epic_id": {
      "type": "string"
    },
    "files_touched": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "project_key": {
      "type": "string"
    },
    "task_id": {
      "type": "string"
    }
  },
  "required": [
    "project_key",
    "epic_id",
    "task_id"
  ],
  "type": "object"
}

forge_review_feedback

Send review feedback to a worker. Tracks attempts (max 3).

{
  "properties": {
    "issues": {
      "type": "string"
    },
    "project_key": {
      "type": "string"
    },
    "status": {
      "enum": [
        "approved",
        "needs_changes"
      ],
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "task_id": {
      "type": "string"
    },
    "worker_id": {
      "type": "string"
    }
  },
  "required": [
    "project_key",
    "task_id",
    "worker_id",
    "status"
  ],
  "type": "object"
}

forge_select_strategy

Analyze task and recommend decomposition strategy.

{
  "properties": {
    "codebase_context": {
      "type": "string"
    },
    "task": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "task"
  ],
  "type": "object"
}

forge_spawn_subtask

Prepare a subtask for spawning with Task tool.

{
  "properties": {
    "bead_id": {
      "type": "string"
    },
    "epic_id": {
      "type": "string"
    },
    "files": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "shared_context": {
      "type": "string"
    },
    "subtask_description": {
      "type": "string"
    },
    "subtask_title": {
      "type": "string"
    }
  },
  "required": [
    "bead_id",
    "epic_id",
    "subtask_title",
    "files"
  ],
  "type": "object"
}

forge_status

Get status of a swarm by epic ID.

{
  "properties": {
    "epic_id": {
      "type": "string"
    },
    "project_key": {
      "type": "string"
    }
  },
  "required": [
    "epic_id",
    "project_key"
  ],
  "type": "object"
}

forge_subtask_prompt

Generate the prompt for a spawned subtask agent.

{
  "properties": {
    "agent_name": {
      "type": "string"
    },
    "bead_id": {
      "type": "string"
    },
    "epic_id": {
      "type": "string"
    },
    "files": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "shared_context": {
      "type": "string"
    },
    "subtask_description": {
      "type": "string"
    },
    "subtask_title": {
      "type": "string"
    }
  },
  "required": [
    "agent_name",
    "bead_id",
    "epic_id",
    "subtask_title",
    "files"
  ],
  "type": "object"
}

forge_validate_decomposition

Validate a decomposition response against CellTreeSchema.

{
  "properties": {
    "response": {
      "type": "string"
    }
  },
  "required": [
    "response"
  ],
  "type": "object"
}

forge_worktree_cleanup

Remove a worktree after completion or abort. Idempotent.

{
  "properties": {
    "cleanup_all": {
      "type": "boolean"
    },
    "project_path": {
      "type": "string"
    },
    "task_id": {
      "type": "string"
    }
  },
  "required": [
    "project_path"
  ],
  "type": "object"
}

forge_worktree_create

Create a git worktree for isolated task execution.

{
  "properties": {
    "project_path": {
      "type": "string"
    },
    "start_commit": {
      "type": "string"
    },
    "task_id": {
      "type": "string"
    }
  },
  "required": [
    "project_path",
    "task_id",
    "start_commit"
  ],
  "type": "object"
}

forge_worktree_list

List all active worktrees for a project.

{
  "properties": {
    "project_path": {
      "type": "string"
    }
  },
  "required": [
    "project_path"
  ],
  "type": "object"
}

forge_worktree_merge

Cherry-pick commits from worktree back to main branch.

{
  "properties": {
    "project_path": {
      "type": "string"
    },
    "start_commit": {
      "type": "string"
    },
    "task_id": {
      "type": "string"
    }
  },
  "required": [
    "project_path",
    "task_id"
  ],
  "type": "object"
}

Memory (8 tools)

hivemind_find

Search all memories by semantic similarity. Proxies to Dewey semantic search.

{
  "properties": {
    "collection": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

hivemind_get

Get specific memory by ID (DEPRECATED)

{
  "properties": {},
  "type": "object"
}

hivemind_index

Index AI session directories (DEPRECATED)

{
  "properties": {},
  "type": "object"
}

hivemind_remove

Delete outdated/incorrect memory (DEPRECATED)

{
  "properties": {},
  "type": "object"
}

hivemind_stats

Memory statistics and health check (DEPRECATED)

{
  "properties": {},
  "type": "object"
}

hivemind_store

Store a memory (learnings, decisions, patterns) with metadata and tags. Proxies to Dewey semantic search.

{
  "properties": {
    "information": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    }
  },
  "required": [
    "information"
  ],
  "type": "object"
}

hivemind_sync

Sync learnings to git-backed team sharing (DEPRECATED)

{
  "properties": {},
  "type": "object"
}

hivemind_validate

Confirm memory is still accurate (DEPRECATED)

{
  "properties": {},
  "type": "object"
}