Use this tool to create a new monday.com platform agent. Agents are work orchestrators that can be triggered to perform automated actions on monday boards. You can create an agent in two modes: Prompt mode (recommended), where the platform uses AI to generate the agent's name, role, avatar, goal, and execution plan from a plain-language description; or Manual mode, where you supply the profile fields yourself without AI generation.

All agents are created in the INACTIVE state. The agent cannot be triggered until it is activated from the monday.com agent settings UI. After calling this tool, instruct the user to navigate to their agent settings in monday.com and activate the agent manually.

🚧
Do not mix prompt with manual profile fields (name, role, role_description) in the same request. Use one mode or the other.

Parameters

Parameter	Type	Required	Description
prompt	`string`	No	Plain-language description of what the agent should do. When provided, the platform uses this to AI-generate the agent's profile, goal, and execution plan. Be specific about the domain and tasks to automate. Use this field for Prompt mode.
agent_model	`string`	No	Strongly discouraged — omit this field. Only set when the user explicitly names a monday-supported model. Invalid values are rejected by the platform. When omitted, the platform default is used.
name	`string`	No	Display name of the agent. Use in Manual mode when not providing a `prompt`.
role	`string`	No	Role title of the agent (e.g., "Project Manager", "Bug Reviewer").
role_description	`string`	No	Description of the agent's role and responsibilities.
avatar_url	`string`	No	HTTPS URL for the agent's avatar image. Prefer `dapulse-res.cloudinary.com` or `cdn.monday.com` URLs for full renderer compatibility.
gender	`string`	No	Hint for AI-generated avatar and name when profile fields are omitted. One of `male` or `female`.
background_color	`string`	No	Background color for the agent avatar, as a lowercase hex string (e.g., `"#9450fd"`).
user_prompt	`string`	No	Stored as metadata only. Not used for AI generation.

Example

Create an agent using Prompt mode with a plain-language description:

{
  "prompt": "Summarize open items on a board daily and post a digest as an update."
}

The platform generates the agent profile automatically. In the test account, this call returned an agent named Janet with the role "Task Summary Manager" and a full AI-generated execution plan. The agent was assigned ID 39662 and returned in state INACTIVE. Note that created_at and updated_at are null in the creation response — call get_agent with the returned id to fetch the populated timestamps.

Programmatic equivalent

monday.com platform agents are managed through the monday.com interface or via the MCP. There is no public GraphQL API for this operation.