List issues for a GitHub repository (pull requests excluded).

Get a single GitHub issue by number.

List the comments on a GitHub issue or pull request conversation, oldest first.

Works for plain issues, which list_pull_request_comments_tool does not. On a pull request it returns only the conversation comments; diff comments and reviews come from list_pull_request_comments_tool.

Create a new issue in a GitHub repository.

Create a comment on a GitHub issue or pull request.

Update a GitHub issue, including closing or reopening it.

Set state="closed" to close an issue. Set state="open" with state_reason="reopened" to reopen.

List pull requests for a GitHub repository.

Get a single GitHub pull request by number.

Get the unified diff for a GitHub pull request.

Get a CI verdict for a PR that distinguishes skipped from failed.

Classifies every check-run and commit-status context into passed, failing, pending, or skipped. SKIPPED checks are NOT failures. Use the returned ready_to_merge boolean as the signal for whether the PR is clear to merge (True only when nothing is failing or pending and the PR is not known-unmergeable). A token that cannot read check-runs (any fine-grained token) gets the Actions jobs instead; checks_source says which, and only Actions-reported checks are then visible.

Update a GitHub pull request, including closing or reopening it.

This does NOT merge. Set state="closed" to close a PR without merging.

Open a GitHub pull request.

Merge a GitHub pull request, only once its required checks are green.

The tool enforces the base branch's required status checks itself before merging, because an organization owner's token (or one on a ruleset's bypass list) lets GitHub merge past failing required checks. It refuses, naming each offending check, when a required check run or status on the PR head is missing, pending or failed; when sha is not the current head; when branch protection cannot be read; and when the base branch requires no checks at all, unless allow_no_required_checks is True. Passing check runs conclude success, skipped or neutral. The merge is pinned to the head SHA that was checked. A token that cannot read check-runs (any fine-grained token) is judged on the Actions jobs, and a required check not reported by GitHub Actions is refused as missing.

List everything said on a GitHub pull request, in one list.

Combines the PR's conversation comments (kind "issue_comment"), comments on the diff (kind "review_comment", with path, line, review_id and in_reply_to_id) and submitted reviews (kind "review", with state), oldest first. Every item carries kind, id, author, created_at, body and html_url.

Each kind is capped at 300 items; truncated and truncated_kinds say when newer items were left out.

Reply in the thread of a pull request review comment.

comment_id is the id of a "review_comment" item from list_pull_request_comments_tool whose in_reply_to_id is empty; GitHub rejects a reply to a reply, so answer the comment that started the thread.

Get the decoded text content of a file in a GitHub repository.

List the git tree (files and directories) of a GitHub repository.

Search for code across GitHub.

Uses GitHub code search syntax (e.g., "addClass repo:jquery/jquery").

Search for issues and pull requests across GitHub.

Uses GitHub issue search syntax (e.g., "is:open is:pr author:octocat").

List GitHub Actions workflow runs for a repository.

Trigger a fresh GitHub Actions run via the workflow_dispatch event.

Use this to force a new build. Unlike rerun_workflow_run_tool (which re-runs an existing run and is rejected by GitHub for runs older than 30 days), this starts a brand-new run regardless of when the workflow last ran. The target workflow must declare an on: workflow_dispatch trigger.

Re-run all jobs in a GitHub Actions workflow run.

Re-run only the failed jobs in a GitHub Actions workflow run.

Get one GitHub Actions workflow run and its jobs (no logs).

Get the failure summary of each failed job in a GitHub Actions run.

Returns, for every job that failed or timed out, a failure_summary: the log-tail lines that name the cause (error annotations, test failures, tracebacks, non-zero exits), with ANSI escapes and timestamps removed, plus the names of the steps that failed. Set include_raw_log to also get the full cleaned tail as log — it can be large and, for a repository whose CI output quotes attack corpora, a scanning gateway may flag and withhold it, where the small, signal-only summary is far more likely to pass.

Logs are fetched for at most 5 failed jobs and all log text together is capped at 256 KiB; truncated and failed_jobs_omitted say when something was cut. jobs_truncated means the run has more than the 300 jobs examined, so the failed-job counts cover only those.

Create a GitHub release, creating its tag if the tag does not exist.

Publishing a release (draft=false) fires the repository's on: release workflows, such as package and image publishing.