src.marcus_mcp.tools.agent module#

Agent Management Tools for Marcus MCP.

This module contains tools for managing AI agents in the Marcus system: - register_agent: Register a new agent with skills and role - get_agent_status: Get current status and tasks for an agent - list_registered_agents: List all registered agents

async src.marcus_mcp.tools.agent.register_agent(agent_id, name, role, skills, state, project_id='')[source]#

Register a new agent with the Marcus system.

Parameters:

  • agent_id (str) – Unique identifier for the agent

  • name (str) – Display name for the agent

  • role (str) – Agent’s role (e.g., ‘Backend Developer’)

  • skills (List[str]) – List of agent’s technical skills

  • state (Any) – Marcus server state instance

  • project_id (str) – ID of the project this agent is working on. Used to scope request_next_task results so agents from concurrent experiments cannot steal tasks across project boundaries (GH-388).

Returns:

Dict with success status, registration details, and project_id.

Return type:

Dict[str, Any]

async src.marcus_mcp.tools.agent.get_agent_status(agent_id, state)[source]#

Get status and current assignment for an agent.

Parameters:

  • agent_id (str) – The agent’s unique identifier

  • state (Any) – Marcus server state instance

Returns:

Dict with agent status, current tasks, and assignment details

Return type:

Dict[str, Any]

async src.marcus_mcp.tools.agent.list_registered_agents(state)[source]#

List all registered agents and their current status.

Parameters:

state (Any) – Marcus server state instance

Returns:

Dict with list of all agents and their details

Return type:

Dict[str, Any]