🚧This is an internal UI component. It is called automatically by the Platform MCP server — do not call it directly.

show-assign renders an interactive assignment interface in the chat, displaying a list of items alongside their suggested assignees. The MCP server invokes this tool when a user asks to assign tasks, review assignments, or use an interactive assignment view. Assignment suggestions are based on task details (such as name and context) and person details (such as job title and availability).

Before calling show-assign, the MCP server typically calls list_users_and_teams to retrieve real user IDs and names. The user.id and user.name fields must contain valid, non-empty values from actual users in the system — placeholder or made-up values are not permitted.

Parameters

Parameter	Type	Required	Description
title	`string`	Yes	The board or context title displayed at the top of the assignment interface.
assignments	`array`	Yes	Array of item-to-user assignment objects. Each entry requires `itemId`, `itemName`, and a `user` object.
assignments[].itemId	`string`	Yes	The monday.com item ID. Must be a non-empty string.
assignments[].itemName	`string`	Yes	The display name of the item/task.
assignments[].user.id	`string`	Yes	The ID of the user to assign. Must be a real user ID from the account.
assignments[].user.name	`string`	Yes	The real name of the user to assign.
assignments[].user.avatarUrl	`string`	No	The user's avatar URL (`photo_tiny` or `photo_thumb` from the user object).
assignments[].user.jobTitle	`string`	No	The user's job title, used to support smart assignment suggestions.

Example

Render an assignment interface for a sprint board:

{
  "title": "Q2 Sprint Board",
  "assignments": [
    {
      "itemId": "987654321",
      "itemName": "Design new onboarding flow",
      "user": {
        "id": "12345678",
        "name": "Sarah Chen",
        "avatarUrl": "https://example.com/avatars/sarah.jpg",
        "jobTitle": "Product Designer"
      }
    },
    {
      "itemId": "987654322",
      "itemName": "Fix login bug on mobile",
      "user": {
        "id": "23456789",
        "name": "Alex Rivera",
        "jobTitle": "Frontend Engineer"
      }
    }
  ]
}

This displays an interactive panel listing each task alongside its suggested assignee, showing the user's name, avatar, and job title where available. Users can review and confirm assignments directly in the interface.

Programmatic equivalent

There is no direct API equivalent for rendering the assignment interface — this component is specific to the MCP chat interface. To assign a user to an item programmatically, use the change_column_value mutation targeting the people column:

mutation {
  change_column_value(
    board_id: 12406666,
    item_id: 987654321,
    column_id: "person",
    value: "{\"personsAndTeams\":[{\"id\":12345678,\"kind\":\"person\"}]}"
  ) {
    id
  }
}

For more details, see the People column reference in the monday.com API docs.