Skip to content

show_agent

Get the status and recent output of child agents in a Polygraph session.

Use to monitor progress of delegated tasks. Each child's status field uses ACP lifecycle values: created, in-progress, input-required, permission-required, completed, failed, or cancelled. When status is input-required, the inputRequiredQuestion field contains the verbatim question the child has asked the parent. When status is permission-required, the pendingPermission field contains the structured request from the child; respond with allow_agent or deny_agent, unless the MCP client supports elicitation, in which case the permission dialog appears automatically.

NameTypeRequiredDescription
sessionIdstringyesThe Polygraph session ID, or a Polygraph app session URL (/s/<session-id> or /orgs/<org-id>/sessions/<session-id>).
repostringnoSpecific repo name or ID to check. If omitted, returns status for all children.
tailnumbernoNumber of output lines to return (default 50).