AI agents drive Polygraph through MCP tools. Each tool maps to one operation in the session lifecycle - discover workspaces, delegate work, push branches, monitor progress.
Discovery
Section titled “Discovery”add_repo- Directly add specific repositories to a running Polygraph session.list_repos- Discover candidate repos available for a Polygraph session.session_intro- Render the Polygraph session welcome card for a session.start_session- Initialize a Polygraph session for the selected repositories.
Execution
Section titled “Execution”allow_agent- Grant a child agent's pending permission-required request.deny_agent- Deny a child agent's pending permission-required request.pack_and_copy- Pack publisher packages and install the tarballs into consumer repos for pre-release validation.show_agent- Get the status and recent output of child agents in a Polygraph session.spawn_agent- Delegate a task to a child AI agent in a dependent repository.stop_agent- Stop an in-progress child agent in a Polygraph session.
Publishing
Section titled “Publishing”associate_pr- Associate an existing pull request with a Polygraph session.create_pr- Create draft pull requests for one or more repositories in a Polygraph session.mark_pr_ready- Mark draft pull requests as ready for review.push_branch- Push a local git branch to the remote repository in a Polygraph session.
Monitoring
Section titled “Monitoring”get_ci_logs- Retrieve the plain-text log for a specific GitHub Actions CI job.list_sessions- List Polygraph sessions.show_session- Get the details of a specific Polygraph session.
archive_session- Archive a Polygraph session.link_reference- Link an external reference to a Polygraph session.list_accounts- List organizations the current user belongs to.login- Authenticate with Polygraph.logout- Remove stored Polygraph credentials from local config.select_account- Select an organization to operate on.update_session- Update a Polygraph session title and/or description.whoami- Show the current Polygraph authentication and selected organization state.
Resources
Section titled “Resources”Besides tools, the MCP server exposes resources that agents can attach as context:
polygraph://repos/<repoId>- one resource per organization repo (JSON).polygraph://sessions/<sessionId>- sessions from the last 30 days (JSON), so a prior session can be attached as context for new work.