Agent Tools

Agent Tools

6 MCP tools for agent lifecycle management.

---

Tools

agent_spawn

Create a new agent instance.

Input:

{
  "type": "coder",
  "name": "my-coder",
  "sessionId": "optional-session-id",
  "metadata": {}
}

Output:

{
  "success": true,
  "agent": {
    "id": "uuid",
    "type": "coder",
    "name": "my-coder",
    "status": "idle"
  }
}

---

agent_list

List all active agents.

Input:

{
  "sessionId": "optional-filter"
}

Output:

{
  "agents": [...],
  "count": 3
}

---

agent_stop

Stop a running agent.

Input:

{
  "id": "agent-id"
}

---

agent_status

Get agent details and capabilities.

Input:

{
  "id": "agent-id"
}

Output:

{
  "agent": {...},
  "capabilities": ["write-code", "edit-code"],
  "systemPrompt": "..."
}

---

agent_types

List all available agent types.

Output:

{
  "types": [
    {
      "type": "coder",
      "name": "Coder Agent",
      "description": "...",
      "capabilities": [...]
    }
  ]
}

---

agent_update_status

Update agent status.

Input:

{
  "id": "agent-id",
  "status": "running"
}

---

Related:

• Tools Overview
• Understanding Agents
• Agent Guides