Nodal-Agents
ReferenceModels & grants

ROOT grants

The per-grant powers a ROOT agent can be given — every field of the RootGrants interface.

A ROOT agent is the top of an entity's hierarchy and the target of the dashboard chat. It can hold meta-tools that change your setup (create agents, author skills, connect MCP servers, manage schedules). Each power is a separate grant you toggle in Settings → ROOT agent, gated by the ROOT's autonomy level. The table below is every grant on the RootGrants interface.

The Default column is the value a manually-designated ROOT starts with (DEFAULT_ROOT_GRANTS). An auto-designated ROOT — the first orchestrator created in an entity — instead starts with every power off until you opt in.

GrantMeaningDefault
createAgentCreate new sub-agents (the create_agent meta-tool).Yes
updateAgentEdit an existing agent's model or personality (update_agent).Yes
attachAgentAttach / detach an existing agent as a sub-agent (attach_agent, detach_agent).Yes
createSkillAuthor a new skill (create_skill).Yes
updateSkillEdit an existing skill (update_skill).Yes
assignSkillAssign / unassign a skill to an agent (attach_skill, detach_skill).Yes
createMcpConnect a new MCP server (create_mcp).Yes
attachMcpAttach / detach an MCP server to an agent (attach_mcp, detach_mcp).Yes
createConnectorConnect a new connector (create_connector).Yes
attachConnectorAttach / detach a connector to an agent (attach_connector, detach_connector).Yes
manageSchedulesCreate, edit, toggle, and run cron schedules (create_schedule, update_schedule, toggle_schedule, run_schedule).Yes
autonomyAutonomy level for the ROOT meta-tools: propose_confirm, destructive_gate, or fully_autonomous.propose_confirm