Manage monday Platform Agent
manage_agentManage the full lifecycle of monday.com agents: create via AI or manually, read, update, delete, activate, deactivate, and run agents.
Instructions
Full lifecycle management for monday platform agents — create, read, update, delete, change state, and run.
monday platform agents are user-built work orchestrators on monday.com — each has a profile (name, role, avatar), a goal, and a markdown execution plan. Agents in state ACTIVE can be triggered automatically. They are NOT local LangChain or MCP agents.
ACTIONS (only pass fields that apply to the chosen action):
create: { action:"create", prompt, agent_model? } — AI-generated agent. Platform creates profile, goal, and plan from the prompt.
create_blank: { action:"create_blank", name?, role?, role_description?, avatar_url?, gender?, background_color?, user_prompt? } — manually defined agent.
get one: { action:"get", agent_id }
list owned: { action:"get" }
update: { action:"update", agent_id, name?, role?, role_description?, plan?, agent_model? }
delete: { action:"delete", agent_id }
activate: { action:"activate", agent_id }
deactivate: { action:"deactivate", agent_id }
run: { action:"run", agent_id }
RULES:
"create_blank" with no fields creates a nameless blank agent — only do this intentionally.
"update" requires at least one of name/role/role_description/plan/agent_model.
"update", "delete", "activate", "deactivate", "run" all require "agent_id".
Created agents start INACTIVE. Follow with action:"activate" using the returned agent_id before they can be triggered.
⚠️ DESTRUCTIVE — "delete" is permanent and irreversible. When the user refers to an agent by name, ALWAYS call action:"get" first to confirm the correct agent_id before deleting.
"run" is fire-and-forget. Returns trigger_uuid — no run-status query exists, treat successful enqueue as the only signal.
Agent state is one of ACTIVE, INACTIVE, ARCHIVED, or FAILED. DELETED only appears as the return value of action:"delete".
USAGE EXAMPLES:
AI create: { "action": "create", "prompt": "Run my daily standup every weekday at 9am." }
Manual create:{ "action": "create_blank", "name": "Standup Bot", "role": "Project Manager", "gender": "female" }
Fetch one: { "action": "get", "agent_id": "42" }
List mine: { "action": "get" }
Rename: { "action": "update", "agent_id": "7", "name": "New Name" }
Activate: { "action": "activate", "agent_id": "7" }
Deactivate: { "action": "deactivate", "agent_id": "7" }
Run: { "action": "run", "agent_id": "7" }
Delete: { "action": "delete", "agent_id": "7" }
RELATED TOOLS:
agent_catalog — browse available trigger types and skills before wiring them to an agent
manage_agent_triggers — manage which triggers fire this agent automatically
manage_agent_skills — manage which skills this agent can perform
manage_agent_knowledge — manage which boards/docs this agent has access to
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | "create" — create a new agent via AI (pass prompt). "create_blank" — create a new agent manually (pass name/role/etc). "get" — fetch one agent by agent_id or list owned agents. "update" — modify mutable fields on an existing agent. "delete" — permanently delete an agent (irreversible). "activate" — transition agent to ACTIVE. "deactivate" — transition agent to INACTIVE. "run" — manually enqueue an agent run (fire-and-forget). | |
| agent_id | No | Used with action:"get" to fetch a specific agent. Required for action:"update", "delete", "activate", "deactivate", "run". Omit for action:"create", "create_blank", or action:"get" (to list owned agents). | |
| prompt | No | Required for action:"create". Plain-language description of what the agent should do. Platform generates profile, goal, and plan via AI. | |
| agent_model | No | Used with action:"create" or action:"update". Omit unless the user explicitly names a valid monday-supported model. | |
| name | No | Used with action:"create_blank" or action:"update". Display name of the agent. | |
| role | No | Used with action:"create_blank" or action:"update". Short role title (e.g. "Customer Success Bot"). | |
| role_description | No | Used with action:"create_blank" or action:"update". Detailed description of the agent role. | |
| avatar_url | No | Used with action:"create_blank". HTTPS URL of the avatar. Prefer dapulse-res.cloudinary.com or cdn.monday.com. | |
| gender | No | Used with action:"create_blank". Hint for generated avatar/name when profile fields are omitted. | |
| background_color | No | Used with action:"create_blank". Lowercase hex, e.g. "#9450fd". | |
| user_prompt | No | Used with action:"create_blank". Stored as metadata. Not used for AI generation. | |
| plan | No | Used with action:"update". New step-by-step execution plan in markdown. |