Use this tool to retrieve monday.com platform agents. Pass an agent id to fetch a single specific agent, or omit id to list all non-deleted agents owned by the authenticated user (capped at 100 by default).

monday.com platform agents are user-built work orchestrators that live on the platform. Each agent has a profile (name, role, avatar), a goal, and an execution plan in Markdown describing its capabilities and operating principles. They are not local or MCP-based agents — they are managed entities on monday.com owned by a specific user.

Agent state is one of ACTIVE, INACTIVE, ARCHIVED, or FAILED. Deleted agents are filtered from results — DELETED only appears as the return value of delete_agent. Agent kind is one of PERSONAL, ACCOUNT_LEVEL, or EXTERNAL. An empty list means the user owns no agents, which is not an error.

Parameters

Parameter	Type	Required	Description
id	`string`	No	Unique identifier of a monday platform agent. When provided, returns that single agent. When omitted, returns all non-deleted agents owned by the authenticated user (up to 100).

Example

Fetch all agents owned by the authenticated user:

{}

In the test account, this returned 22 agents with a mix of PERSONAL and EXTERNAL kinds, and states including ACTIVE and INACTIVE. Each agent object includes its id, kind, state, profile (name, role, avatar URL), goal, plan (Markdown), user_prompt, version_id, created_at, and updated_at.

Fetch a specific agent by ID:

{
  "id": "13431"
}

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.