Built by Metorial, the integration platform for agentic AI.
Create or update a GitHub issue, including issue type, lifecycle state, duplicate closure, and organization-defined issue fields. Existing calls may continue to omit method and use issueNumber.
Create a new release for a GitHub repository with a tag, name, release notes, and draft/pre-release options. Can automatically generate release notes from commits since the last release.
List commits on a repository branch with filtering by SHA, path, author, or date range.
List repositories for the authenticated user or a specific organization. Supports filtering by type, sorting, and pagination.
Create, submit, or delete pull request reviews; resolve or unresolve review threads; add line or file comments to a pending review; and reply or react to review comments. Existing APPROVE, REQUEST_CHANGES, COMMENT, and request_reviewers actions remain supported.
List branches in a GitHub repository.
Create, read, update, or delete GitHub Gists (code snippets). - **create**: Create a new gist with one or more files. - **get**: Retrieve a gist by ID. - **update**: Update a gist's description or files. - **delete**: Delete a gist. - **list**: List gists for the authenticated user.
Read, create, update, or delete a file in a GitHub repository. - **read**: Retrieve file contents (decoded from Base64). - **write**: Create or update a file. Provide Base64-encoded content and a commit message. - **delete**: Delete a file. Requires the file's current SHA and a commit message.
Add a comment and/or reaction to a GitHub issue or pull request. Reactions can target the issue or pull request itself, or a specific issue comment; use the review-comment tools for pull request review comments.
Retrieve a GitHub user's profile. Provide a username to look up any user, or omit it to get the authenticated user's profile.
List pull requests in a GitHub repository with filtering by state, head/base branch, and sorting options. When filtering by author, use `search` with type `issues` and an `is:pr author:<login>` query instead.
Search across GitHub for repositories, code, issues/pull requests, users, or organizations using GitHub's search syntax. Supports qualifiers for filtering (e.g., "language:python stars:>100" for repositories).
Merge a pull request using the specified merge method (merge commit, squash, or rebase).
Retrieve detailed information about a GitHub repository including its settings, statistics, and metadata. Use this to inspect a repository's configuration, check its visibility, default branch, language, star/fork counts, and more.
List, create, update, rename, or delete labels in a GitHub repository. Use labels on issues and pull requests for categorization; existing action-based calls remain supported.
List, inspect, download, trigger, rerun, cancel, and troubleshoot GitHub Actions workflows, runs, jobs, artifacts, and logs. Supports the official Actions method contracts and existing action-based calls.
Retrieve detailed information about a specific issue, including its body, comments count, labels, assignees, and milestone.
List issues in a GitHub repository with cursor pagination, labels, custom issue fields, state, date, and ordering filters. Pass pageInfo.endCursor from one response as after to retrieve the next page.
Create a new GitHub repository for the authenticated user or within an organization. Repositories are private by default unless private is explicitly set to false.
List, add, or remove collaborators on a GitHub repository. Control access permissions for individual users.
Create a new pull request or update an existing one. When creating: provide head branch, base branch, and title. Reviewers may be GitHub usernames or ORG/team-slug teams. When updating: provide the pull request number along with fields to change, including draft state and reviewers.
Create a status check on a specific commit. Useful for integrating CI/CD results, deployment status, or other external checks. Also supports reading the combined status of all checks for a given ref.
Update settings of an existing GitHub repository. Modify name, description, visibility, feature toggles (issues, wiki, projects), default branch, and archive status.
Star or unstar a GitHub repository for the authenticated user.
Get details for a commit from a GitHub repository.
List GitHub Discussions for a repository or organization, with cursor pagination, category filtering, paired ordering controls, and optional title/body filtering of the fetched page.
Fork a GitHub repository to the authenticated account or a specified organization. GitHub may complete large forks asynchronously.
Push multiple files to a GitHub repository in a single commit.
Get detailed information for a specific GitHub notification. List notifications first when the notification ID is unknown.
Get the tree structure (files and directories) of a GitHub repository at a specific ref or SHA.
List releases in a GitHub repository. Regular git tags without an associated release are not included.
Add a sub-issue to a parent issue in a GitHub repository.
Read details, conversation comments, child issues, the parent issue, or assigned labels for a single GitHub issue.
Get details of a specific secret scanning alert in a GitHub repository, including its secret type, location, state, and resolution information.
List issue types available to a GitHub repository or directly from its owner organization.
Get details of a specific code scanning alert in a GitHub repository, including its rule, state, severity, affected location, and dismissal information.
List GitHub Discussion category node IDs and names for a repository, or for an organization through its .github repository.
Dismiss a GitHub notification by marking its thread as read or done. Marking it done removes the thread from the notification inbox.
Get a global security advisory.
Get a GitHub Discussion by repository-local number, including its Markdown body, category, answer state, author, timestamps, and permalink.
Get details of a specific code quality finding in a GitHub repository, including its diagnostic context and remediation suggestion when available.
Tools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items for a specific project.
Get details about a git tag, including whether it is lightweight or annotated and the object it targets.
Get details of the GitHub organization teams a user belongs to. Results are limited to organizations and teams accessible with the current credentials.
List repository security advisories across a GitHub organization, with optional lifecycle filtering and chronological sorting.
List repositories starred by a GitHub user. Omit username to list repositories starred by the authenticated user.
Get the latest published full release in a GitHub repository. Drafts and prereleases are excluded by GitHub.
List repository security advisories for a GitHub repository, with optional lifecycle filtering and chronological sorting.
Get details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project items by their unique IDs.
List issue field definitions for a GitHub repository or organization, including valid options for single-select fields.
Scan raw file contents, snippets, or recent diffs with GitHub for exposed API keys, passwords, tokens, and other credentials. The supplied content is sent to GitHub for an ephemeral pre-commit scan and is not persisted as a repository secret scanning alert.
List code scanning alerts in a GitHub repository. Filter by alert state, Git ref, severity, or scanning tool to focus security triage.
List secret scanning alerts in a GitHub repository. Filter by state, resolution, or secret type to investigate exposed credentials and remediation status.
Get a file or directory from a GitHub repository. Files are returned as downloadable content; directories return entry metadata.
Get details of a specific Dependabot alert in a GitHub repository, including the vulnerable dependency, advisory, severity, and remediation information.
Get a specific label from a GitHub repository by name.
Create and manage GitHub Projects: create projects, add/update/delete items, create status updates, and add iteration fields.
Manage a GitHub notification thread subscription. Watch subscribes to updates, ignore mutes the thread, and delete removes the current subscription.
List git tags in a GitHub repository.
List Dependabot alerts in a GitHub repository. Filter by lifecycle state or severity and use the returned cursor to continue through larger security backlogs.
Read details, a downloadable diff, commit status, changed files, commits, review threads, reviews, conversation comments, or check runs for one GitHub pull request.
Update the branch of a pull request with the latest changes from the base branch.
Get a cursor-paginated page of top-level comments from a GitHub Discussion, optionally including up to 100 nested replies per comment.
Add, reply to, update, or delete GitHub Discussion comments, and mark or unmark a comment as the accepted answer for a Q&A discussion.
Get the members of a specific GitHub organization team. Results are limited to teams accessible with the current credentials.
Mark GitHub notifications as read through a specified time. Optionally limit the operation to one repository by providing owner and repo together.
List global security advisories from GitHub.
Get a published GitHub release by its tag name.
Manage notification subscription settings for a GitHub repository. Watch subscribes to updates, ignore mutes repository notifications, and delete removes the current subscription.
List GitHub notifications for the authenticated user, including mentions, review requests, assignments, and updates on issues or pull requests. Use this to discover pending work or summarize what needs attention.
Create a new branch in a GitHub repository.
Search for commits across GitHub repositories using GitHub's commit search syntax. Searches commit messages on default branches only.