Add GitHub to your AI agent

Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository.

Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.

Creates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 'Reference already exists' error. To update an existing reference, use the 'Update a reference' (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation.

Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is given, it must already exist.

Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree` SHA; all provided SHAs must be valid.

Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access.

Creates a new comment on an existing GitHub issue or pull request within the specified repository.

Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates.

Creates a new branch in a GitHub repository pointing to a specified commit. Use this action when you need to create a new branch from an existing commit SHA. IMPORTANT: This action only creates NEW branches. If the branch already exists, it will fail with a 422 'Reference already exists' error. The repository must not be empty (must have at least one commit) before creating a branch.

Creates a draft issue item in a user-owned GitHub ProjectsV2. Use when you need to add a new draft item to track ideas or tasks in a user's project.

Creates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided.

Creates a new repository for the authenticated user. Use this action when you need to create a new GitHub repository under the authenticated user's account. The repository name must be unique for the user, and various settings can be configured such as visibility (public/private), enabled features (issues, wiki, projects), and merge options.

Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository.

Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows. GitHub search results are capped at ~1000 total items; narrow filters when totals approach this limit. `created_since`/`updated_since` filter on creation/update timestamps, not `merged_at`; apply merge-date filtering client-side.

AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data. Check `incomplete_results` in the response — when true, results are non-exhaustive. Search endpoints are rate-limited to ~30 requests/minute (vs. 5000/hour for general REST); apply backoff on 403/429. Total results are capped at ~1000 per query regardless of pagination.

Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number.

Retrieves a specific Git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a GitHub repository. The reference must exist in the repository; use 'list_matching_references' first if unsure what references are available.

Browse and list all files/directories in a GitHub repository. Efficiently retrieves the complete repository structure in a single API call when used with recursive mode. Perfect for analyzing codebase structure, finding specific files, or getting an overview of repository contents without cloning.

Retrieves detailed information for a specific check run within a GitHub repository.

Retrieves all comments for a specific GitHub issue in chronological order. Use this action when you need to view discussion history, analyze comment threads, or fetch comment details for a specific issue. Comments can be filtered by update time and paginated for large discussions.

Retrieves a list of teams for a specified GitHub organization. Use this action when you need to list all teams, find team information, or explore team structure within an organization. Requires read:org scope and returns paginated results.

Retrieves a list of pull requests from a repository with flexible filtering options. Use this action when you need to list all pull requests in a repository, optionally filtered by state (open, closed, all), base branch, head branch, or sort order. Returns an array of pull request objects with comprehensive details including title, state, author, labels, timestamps, and branch information.

Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository.

Retrieves a list of members for a specific team within an organization. Returns team members including members of child teams. Use this action when you need to see who belongs to a team, optionally filtered by their role (member or maintainer). Requires the authenticated user to have read access to the team within the organization.

List branches in a GitHub repository. Returns branch names, commit information, and protection status. Use this action when you need to retrieve all branches in a repository, optionally filtered by protection status. This is useful for identifying available branches, checking which branches are protected, or preparing to create pull requests.

List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Use when you need reliable CI pass/fail signals beyond commit metadata.

Lists deployments for a specified repository; repository must exist.

Tool to abort a repository migration that is queued or in progress. Use when you need to cancel an ongoing migration operation.

Accepts a PENDING repository invitation that has been issued to the authenticated user.

Adds GitHub Apps to the list of apps allowed to push to a protected branch. The branch must already have protection rules with restrictions enabled. This endpoint only works for organization repositories, not personal repositories. Apps must be installed on the repository with 'contents' write permissions.

Tool to add a custom field to a user-owned GitHub Projects V2 project. Use when you need to add fields like status, priority, or custom data to organize project items.

Tool to add an issue or pull request to a user-owned GitHub project. Use when you need to add existing repository items to a project board.

Adds a classic project to a team or updates the team's permission on it. This endpoint grants or updates permissions for a team on a specific classic project (not Projects V2). The authenticated user must have admin permissions for the project. Both the team and project must belong to the same organization. Requirements: - The project must be a classic project (not GitHub Projects V2) - The authenticated user must have admin permissions on the project - The team and project must be in the same organization - Requires 'admin:org' scope for the authentication token Returns HTTP 204 No Content on success, 403 if project is not an org project, or 404 if the organization, team, or project is not found.

Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.

Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added.

Adds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access.

Grants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the repository must belong to the organization, and the call succeeds without change if access already exists.

Adds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.

Adds and appends custom labels to a self-hosted repository runner, which must be registered and active.

Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent.

Grants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected_repositories'.

Grants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret.

Adds one or more social media links (which must be valid, full URLs for platforms supported by GitHub) to the authenticated user's public GitHub profile.

Adds status check contexts to a protected branch's required status checks. This action appends new status check contexts to the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead.

Tool to add a sub-issue to a parent GitHub issue using GraphQL. Use when you need to establish a parent-child relationship between issues. Requires the 'sub_issues' GraphQL feature to be enabled.

Adds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike 'Set team access restrictions' (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access

Adds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items

Adds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization's Codespaces billing access to be set to 'selected_members' mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to 'selected_members'.

Retrieves a map of all top-level GitHub REST API resource URLs and their templates.

Assigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`), provided the organization, team, and role already exist.

Assigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role ID.

Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories.

Blocks a GitHub user from an organization, preventing their contributions, collaboration, and forking of the organization's repositories. Requires admin or 'Blocking users' organization permission (write access).

Cancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`.

Tool to cancel an active GitHub sponsorship using GraphQL. Use when you need to terminate a sponsorship relationship between a sponsor and a sponsorable entity. Either sponsor ID/login and sponsorable ID/login must be provided.

Cancels a workflow run in a GitHub repository if it is in a cancellable state (e.g., 'in_progress' or 'queued'). Returns 202 Accepted on success.

Check if the authenticated user is following a specified person on GitHub. Use this action when you need to verify whether the currently authenticated user follows another GitHub user. The action returns a boolean status and descriptive message.

Checks if a gist is starred by the authenticated user. Returns `is_starred: true` if the gist is starred (HTTP 204), or `is_starred: false` if not starred (HTTP 404). Use this to verify star status before starring/unstarring a gist.

Checks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found).

Verifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an HTTP 204 (No Content) response, resulting in an empty 'data' field in the response.

Checks if a specified GitHub user can be assigned to a given issue within a repository.

Checks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid.

Checks if the specified GitHub user is blocked by the authenticated user; a 204 No Content response indicates the user is blocked, while a 404 Not Found indicates they are not.

Checks if a GitHub user is blocked by an organization. Returns is_blocked=True if the user is blocked (HTTP 204), or is_blocked=False if not blocked (HTTP 404). Requires 'Blocking users' organization permission (read access).

Checks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the repository/user does not exist.

Checks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404).

Checks if private vulnerability reporting is enabled for the specified repository.

Tool to check if a user is a public member of an organization. Use when you need to verify public organization membership status.

Check if a repository is starred by the authenticated user. Use this action when you need to verify whether the authenticated user has starred a specific repository. This is useful for confirming star status before performing star/unstar operations or displaying repository status.

Checks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed.

Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.

Checks if a GitHub App or OAuth access_token is valid for the specified client_id and retrieves its details, typically to verify its active status and grants. NOTE: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App.

Tool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields).

Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete.

Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain.

Generates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization.

Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') form the OIDC token's subject (`sub`). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs.

Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories.

Converts an open pull request to draft status, indicating it is not ready for review. Use this action when you need to mark a PR as work-in-progress after it has been opened. Draft pull requests cannot be merged until they are marked as ready for review. This action is useful when additional work is needed before the PR can be reviewed or merged.

Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs.

Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success.

Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request.

Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration.

Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified.

Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided.

Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context.

Creates a custom role with defined permissions within a GitHub organization.

Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key.

Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository.

Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable.

Creates a status for an existing deployment, updating its operational state, associated URLs, and description.

Creates a new discussion post on a specific team's page within an organization.

Creates a new comment on an existing team discussion within a GitHub organization.

Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.

Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility.

Creates a new comment on a specified GitHub gist.

Use this action to complete the GitHub App Manifest flow (step 3 of 3) by exchanging the temporary authorization `code` for the app's full configuration, including credentials and private key. The code is provided via redirect URL after creating the app through GitHub's web interface and must be used within 1 hour.

Creates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact (containing static assets) is accessible.

Configures or updates GitHub Pages for a repository, setting build type and source; ensure a Pages workflow exists for 'workflow' `build_type`, or `source_branch` exists for 'legacy' or unspecified `build_type`. This action allows users to effectively manage their GitHub Pages site settings, specifying how the site is built and where the source files are located.

Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions.

Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions.

Creates a project card in a GitHub project column (classic projects only). DEPRECATION NOTICE: GitHub Projects (classic) was sunset on August 23, 2024. This API only works with existing classic project columns. New classic projects cannot be created. Consider using GitHub Projects V2 (GraphQL API) instead. The request body must contain either: - `note`: A text note for the card - OR `content_id` AND `content_type`: To associate an issue or pull request

Generates a time-limited token required to register a new self-hosted runner with a specific repository.

Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions.

Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.

Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.

Posts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body.

Triggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of GitHub.

Creates a new repository for the authenticated user, optionally within an organization if `team_id` is specified.

Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit.

Creates a new GitHub Projects V2 project board linked to a specified repository. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub. The project is owned by the repository owner (user or organization) and linked to the specified repository.

Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.

Creates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an organization, repository creation permissions within it.

Creates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists.

Creates a webhook for a specified repository; requires admin permissions on the repository.

Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment.

Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and omitting `event` makes the review `PENDING`.

Exchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub App, requiring `client_id`, `access_token`, either `target` or `target_id`, and at least one permission; for repository-specific scoping, provide either `repositories` (names) or `repository_ids` (IDs), but not both.

Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit ID, `ref` a fully qualified Git reference (e.g., `refs/heads/main`), and `scanned` an ISO 8601 timestamp.

Creates an annotated Git tag object in a repository, pointing to an existing Git object (commit, tree, or blob) defined by its SHA and ensuring the `type` field correctly specifies the object's type.

Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent_team_id` is given, `privacy` must be 'closed'.

Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible.

Creates a new GitHub Projects V2 project board for the authenticated user to organize and track issues, pull requests, and notes. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub.

Manually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events.

Creates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a `url_template` that includes `<num>`.

Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists.

Creates a new classic project board within a specified GitHub organization. Note: This action uses GitHub's Projects (classic) REST API. The classic projects feature may be disabled in some organizations, and GitHub recommends migrating to Projects V2 (accessible via GraphQL API) for new projects. Requirements: - The authenticated user must be an organization member with project creation permissions - Classic projects must be enabled for the organization - Requires 'repo' and 'admin:org' or 'write:org' scopes

Creates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected).

Creates a webhook for a GitHub organization to deliver event notifications to a configured URL.

Enables commit signature protection for a specified branch, requiring all new commits to be signed.

Enables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via `integration_id`) to control deployments.

Tool to create chat completions using GitHub Models inference API. Use when you need to generate AI-powered text responses using models like GPT-4, Claude, or Llama through GitHub's inference endpoint.

Tool to create inference embeddings using GitHub's AI models. Use when you need to convert text into vector representations for similarity search, clustering, or other ML tasks.

Create a new issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.

Generates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default `runner_group_id` must be an existing runner group accessible by the repository.

Creates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value.

Creates or updates a Codespaces secret for the authenticated user; `encrypted_value` must be encrypted with the public key (ID: `key_id`) from GitHub's 'Get public key for the authenticated user' endpoint.

Creates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment_name` is URL-encoded if it contains special characters.

Creates or updates an environment secret with an `encrypted_value` that was encrypted using the public key identified by `key_id` for the specified environment.

Creates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key.

Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property_name` and `value_type`.

Creates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories.

Tool to enable or update GitHub Pages configuration for a repository. Use when setting up GitHub Pages for static site deployment or modifying Pages settings like custom domains and HTTPS enforcement.

Creates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot public key) and its corresponding `key_id`. This action allows you to securely manage secrets for a given repository, ensuring that sensitive data remains protected during the update process. By providing the encrypted value alongside the key ID, you can seamlessly maintain the necessary credentials for your repository's operations.

Creates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned.

Adds a specified reaction to a pull request review comment within a GitHub repository.

Creates an emoji reaction for a specific, existing release in a GitHub repository.

Creates a reaction for a team discussion within a GitHub organization.

Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.

Creates a reaction for a specified issue within a GitHub repository.

Creates a reaction for a specific comment on an issue within a GitHub repository.

Tool to create a new payment tier for your GitHub Sponsors profile using GraphQL. Use when you need to add a new sponsorship tier with a specific monthly price and description. The amount is specified in dollars and will be converted to cents automatically.

Tool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. Use when you need to sponsor a maintainer through GitHub Sponsors with a specified amount and privacy level.

Creates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public key obtained from the 'Get an organization public key' endpoint.

Tool to create a new user list on GitHub. Use when you need to organize and group GitHub users for easier tracking and management.

Tool to create a new view in a user-owned GitHub project (Projects V2). Use when you need to add a customized view with specific layout, filters, and visible fields to organize project items. Note: This action works with GitHub Projects V2. The view can be configured with different layouts (table, board, roadmap) and optional filters. The visible_fields parameter is not applicable to roadmap layouts.

Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`.

Deletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided.

Deletes an existing package version associated with the authenticated user.

Deletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag').

Permanently deletes a specific release, its assets, and potentially its associated Git tag from a repository.

Deletes a specific release asset from a GitHub repository; this action is idempotent.

Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist.

Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository.

Permanently deletes a repository ruleset.

Deletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist.

Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it.

Deletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist.

Deletes a specific webhook from a repository.

Deletes a specific pull request review comment.

Deletes an existing Codespaces secret for the authenticated user by `secret_name`. This is a destructive and irreversible operation. Returns 404 if the secret does not exist.

Removes a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent.

Forces the removal of a self-hosted runner from a GitHub organization. This endpoint can be used to completely remove the runner when the machine you were using no longer exists. The runner will be immediately disconnected from GitHub Actions. Requires admin:org scope and organization admin access. Returns 204 No Content on successful deletion.

Deletes a team (and any child teams) from an organization.

Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings.

Deletes a specific workflow run from a repository.

Removes all user, team, and app-based access restrictions from a protected branch.

Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository.

Deletes an OAuth application grant for a user, which revokes ALL OAuth tokens and their associated authorizations for the application. This endpoint is only accessible to OAuth App owners and requires Basic Authentication using the OAuth App's client_id and client_secret.

Revokes a single OAuth access token for an OAuth App or GitHub App with OAuth authorization. IMPORTANT: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. It CANNOT be called with personal access tokens, GitHub App installation tokens, or any other token type. You must be the OAuth App owner to use this endpoint.

Deletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success.

Deletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository.

Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled.

Deletes a specific code scanning analysis by its ID from a repository; `confirm_delete` must be `true` if it's the last analysis of its type for a given tool and reference to prevent data loss.

Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.

Deletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist.

Deletes a reaction from a commit comment in a GitHub repository.

Disables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing.

Deletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success.

Deletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist.

Deletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created.

Permanently deletes a specified *inactive* deployment from a repository.

Deletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository.

Deletes a specific team discussion, identified by its number, from an organization's team.

Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist.

Sends an empty request body to `DELETE /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary.

Deletes an existing deployment environment from an existing repository.

Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise.

Deletes a named environment variable from a specified, existing environment within a GitHub repository.

Permanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone.

Deletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`.

Deletes a specific GitHub Actions cache from a repository using its unique `cache_id`.

Deletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled.

Permanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid.

Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.

Permanently removes a specific reaction from an issue in a GitHub repository.

Permanently removes an existing label from a repository.

Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.

Permanently deletes a specific codespace belonging to a member of the specified organization.

Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads.

Deletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days.

Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools.

Deletes a named GitHub Actions variable from a specified organization.

Deletes a specific webhook, identified by `hook_id`, from an existing organization.

Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API.

Tool to delete a package version using GitHub GraphQL API. Use when you need to remove a specific version of a package by its global node ID.

Permanently and irreversibly deletes a specific version of a package owned by the specified user.

Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.

Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted.

Deletes the specified GitHub project (Projects V2) using the GraphQL API. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025 and is no longer available. The project is permanently deleted and cannot be recovered. The user must have admin permissions for the project to delete it.

Deletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted.

Tool to delete a project item for a user in GitHub Projects V2. Use when you need to remove an item from a user's project. Requires the project item's GraphQL node ID (starts with 'PVTI_'). Uses the GitHub GraphQL API deleteProjectV2Item mutation.

Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository.

Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled.

Deletes a specific Codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist.

Deletes currently linked social media account URLs from the authenticated user's GitHub profile.

Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID.

Permanently deletes a specific reaction from a team discussion within an organization.

Tool to delete a GitHub user list using GraphQL. Use when you need to remove a user list from a GitHub account.

Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support.

Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist.

Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository.

Disables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue.

Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository.

Removes a repository from the list of selected repositories enabled for GitHub Actions in an organization. Only works when the organization's `enabled_repositories` policy is set to `selected`. Requires admin:org scope.

Dismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews.

Downloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible.

Downloads a repository's source code as a ZIP archive for a specific Git reference (branch, tag, or commit SHA). IMPORTANT SIZE LIMITATION: This action may fail with 'payload too large' errors for large repositories due to platform size restrictions. If you encounter size limit issues, consider these alternatives: - Use GITHUB_GET_REPOSITORY_CONTENT to fetch specific files or directories (also lists directory contents) - Clone the repository using git if you need the full codebase Best suited for: small to medium repositories, downloading specific tagged releases, or quick code inspection.

Downloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first.

Downloads logs for a specific job in a GitHub Actions workflow run, contingent on the repository's existence and the job ID being valid and having produced logs.

Downloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run.

Downloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow.

Reactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename.

Sets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's Actions policy is 'selected repositories'.

Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.

Adds a repository to the list of selected repositories enabled for GitHub Actions in an organization. Requires the organization's 'enabled_repositories' policy to be set to 'selected'.

Creates or updates a repository's development environment secret using an `encrypted_value` and its corresponding `key_id`; the secret must be pre-encrypted with the repository's Codespaces public key.

Creates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID.

Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL.

Exports the software bill of materials (SBOM) in SPDX JSON format for a repository, if its dependency graph is enabled and it has at least one commit.

Tool to follow a GitHub organization using GraphQL. Use when you need to make the authenticated user follow an organization.

Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves.

Tool to follow a GitHub user using GraphQL. Use when you need to make the authenticated user follow another user.

Forcefully cancels a queued or in-progress GitHub Actions workflow run, bypassing conditions like always() that would otherwise continue execution. Only use when the standard cancel endpoint fails. Cannot cancel completed workflow runs. Requires write permissions to the repository.

Forks a specified public gist, creating a copy under the authenticated user's account.

Generates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file.

Retrieves the raw, typically Base64-encoded, content of a file (blob) from a GitHub repository using its SHA hash, if the repository and blob SHA exist.

Retrieves detailed information for a specified branch within a GitHub repository.

Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (SHA, branch, or tag), supporting pagination for large diffs.

Retrieves detailed information for a specific milestone within a GitHub repository by its number.

Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers.

Retrieves a specific package (by type and name) from an organization, if both the package and organization exist.

Retrieves detailed information for a specific package owned by the authenticated user.

Retrieves a specific public package version associated with a GitHub user.

Retrieves detailed information for a specific version of a package within an organization.

Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID.

Retrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub's Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed.

Retrieves all details of a specific project card, given its unique `card_id`. DEPRECATION NOTICE: GitHub Projects (classic) REST API was sunset on April 1, 2025. This action only works with existing classic project cards that were created before the sunset date. For new projects, use GitHub Projects V2 (GraphQL API) instead.

Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists.

Gets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset.

Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist.

Retrieves detailed information about an existing and accessible GitHub repository.

Gets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible.

Fetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata.

Retrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag.

Gets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules.

Retrieves a specific repository ruleset by its ID; if `includes_parents` is true, the search for this `ruleset_id` also extends to rulesets from parent organizations.

Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.

Gets the authenticated user's subscription details for a repository, indicating if they receive notifications.

Gets a specific GitHub Actions variable by name from an accessible repository.

Returns the configuration of an existing webhook for a given repository.

Retrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid.

Retrieves a specific review for a pull request using its owner, repository, pull request number, and review ID.

Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub Codespaces.

Gets a specific self-hosted runner for a repository by its unique ID.

Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization.

Retrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself.

Retrieves a GitHub team by its slug from a specific organization.

Retrieves a specific GitHub notification thread using its unique `thread_id`.

Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`.

Retrieves the public profile information for an existing GitHub user, specified by their username.

Returns the configuration for an existing webhook on the specified repository.

Retrieves the configuration for a specific webhook associated with a GitHub organization.

Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization.

Retrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename.

Gets a specific workflow run by its ID from a GitHub repository.

Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings.

Lists users, teams, and GitHub Apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions, otherwise expect a 404 or empty response.

Checks if repository administrators are subject to the branch protection rules on a specific branch.

Retrieves all officially supported, date-based (e.g., "2022-11-28") versions of the GitHub REST API from the /versions endpoint.

Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data.

Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.

Retrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`.

Gets a specific artifact for a repository by `artifact_id`. This action retrieves the details of a specific artifact from a GitHub repository using the artifact's unique identifier. It allows users to access information about artifacts stored in the repository.

Retrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom.

Retrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique ID; requires administrator access to the repository.

Retrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status.

Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions.

Retrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. Note: The actual secret value is never returned by this API for security reasons.

Retrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name.

Retrieves detailed information about a specific issue in a repository using the owner, repository name, and issue number.

Action to get an issue comment.

Fetches details of a specific issue event for a given repository and event ID.

Get an organization

Action for `GetAnOrganizationPublicKey`.

Retrieves a specific GitHub organization role by its ID.

Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value.

Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization.

Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook.

Retrieves all grades for an existing GitHub Classroom assignment.

Retrieves the billing usage report for a specified GitHub user. Use when you need to analyze billing costs and usage patterns.

Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan.

Tool to retrieve the list of AI models available in the GitHub Models catalog. Use when you need to discover available models, their capabilities, token limits, and supported modalities.

Retrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user.

Retrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom.

Retrieves the full details of a specific GitHub code of conduct using its unique key.

Tool to look up a code of conduct by its key using GitHub's GraphQL API. Use when you need to fetch code of conduct details as part of a GraphQL workflow.

Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository.

Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`.

Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.

Gets an existing CodeQL database (including a download URL) for a specified language in an accessible repository, if one has been successfully built for that language.

Call to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible.

Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier.

Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA.

Gets the commit signature protection status for a branch in a repository.

List all statuses for a commit reference (SHA, branch, or tag) in reverse chronological order. Use when you need to check CI/CD status results from various systems for a specific commit.

Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE).

Gets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details.

Retrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given environment in a repository.

Get pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref.

Gets the default workflow permissions (`read` or `write`) for the GITHUB_TOKEN and whether it can approve pull request reviews in an existing and accessible repository.

Gets the default GITHUB_TOKEN workflow permissions and settings for a GitHub organization.

Gets the dependency diff between two Git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file.

Gets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`.

Gets a specific deployment by ID from a repository, provided the repository and deployment ID exist.

Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID.

Retrieves a specific deployment status by its ID for a given deployment within a GitHub repository.

Retrieves detailed information about a specific export of a codespace.

Fetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions.

Fetches a specific comment from a team discussion within a specific organization.

Lists all emojis available for use on GitHub, including custom and Unicode emojis.

Tool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. Use when you need to check the status of a specific invitation.

Fetches a list of available GitHub feed URLs for the authenticated user.

Fetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists.

Retrieves a specific Gist comment by its ID and the Gist's ID.

Retrieves a specific revision of a gist.

Retrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository.

Retrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories.

Gets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions.

Gets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies.

Tool to get billing premium request usage report for a GitHub user. Use when you need to retrieve usage data for premium features like Copilot or AI models.

Tool to retrieve billing usage summary for a GitHub user account. Use when tracking usage costs, monitoring billing details, or generating usage reports for a specific user. Note: This endpoint only returns data for the past 24 months and is currently in public preview.

Fetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing.

Retrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled.

Retrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection.

Retrieve a global GitHub security advisory by its GHSA identifier. Use this to get detailed information about vulnerabilities including severity, affected packages, CVSS scores, and references.

Tool to fetch any GitHub object by its global node ID. Use when you have a node_id and need to retrieve the corresponding object details.

Tool to retrieve the authenticated client's GitHub GraphQL API rate limit information. Use when you need to check remaining quota, current usage, or reset time for GraphQL requests.

Retrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format) upload for a repository, uniquely identified by its sarif_id.

Retrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull requests, and when these restrictions expire.

Retrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set.

Retrieves currently active interaction restrictions for the authenticated user's public repositories.

Retrieves a specific label by its name from a specified GitHub repository.

Retrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have at least one prior build.

Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key.

Tool to look up an open source license by its SPDX ID using GitHub's GraphQL API. Use when you need to fetch license details for compliance tracking or repository setup.

Fetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays.

Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository, which defines the `sub` claim structure in OIDC tokens for GitHub Actions workflows; returns the default configuration if no customization is applied.

Gets the list of allowed actions and reusable workflows for an organization when the 'allowed_actions' policy is set to 'selected'.

Retrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value.

Retrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens for workflows is constructed.

Tool to retrieve an organization's audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope.

Retrieves the definition (schema) of a specific, existing custom property for an organization.

Tool to get an item from an organization-owned GitHub Projects V2 project. Use when you need to retrieve details about a specific project item including its content, fields, timestamps, and creator information.

Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces.

Retrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope.

Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown.

Retrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes.

Retrieves information for a GitHub Pages site, which must be enabled for the repository.

Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.

Retrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and full user object for a collaborator on a GitHub project (classic). The permission returned can be admin, write, read, or none.

Retrieves a repository's public key for encrypting GitHub Codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories.

Retrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. The returned key must be used with libsodium sealed box encryption before creating or updating secrets via the API.

Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured.

Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories.

Tool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) — parsing and validation are the caller's responsibility. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools to avoid mismatched-ref errors.

Gets the settings for allowed actions and reusable workflows in a repository. Requires the repository's `allowed_actions` policy to be set to `selected` (returns 409 if set to `all` or `local_only`).

Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value.

Tool to retrieve attestations by subject digest from a GitHub repository. Use when you need to verify or check attestations for a specific artifact identified by its SHA256 digest.

Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days.

Tool to lookup a repository by owner and name using GitHub's GraphQL API. Use when you need comprehensive repository information.

Tool to lookup a repository owner (User or Organization) by login using GitHub's GraphQL API. Use when you need to determine whether a login is a user or organization and retrieve basic profile information.

Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'.

Gets a repository's public key, used to encrypt secrets for Dependabot.

Retrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value.

Tool to retrieve a repository security advisory using its GHSA identifier. Use when you need detailed information about a specific security vulnerability.

Retrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`.

Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status.

Gets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. Requires admin:org scope.

Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it.

Retrieves a user's role and membership status within a specific team in an organization. Returns membership details including role ('member' or 'maintainer') and state ('active' or 'pending'). If the user is not a member of the team, returns is_member=False with a descriptive message. Requires the authenticated user to be an organization member with visibility into the team.

Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise.

Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings.

Retrieves the aggregated commit status (e.g., success, failure, pending) from all checks for a specific reference (SHA, branch, or tag) in a GitHub repository.

Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository.

Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository.

Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release.

Retrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA).

Retrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments.

Retrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled.

Fetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits.

Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a 202 status or an empty response if statistics are being computed.

Retrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message.

Fetches the top 10 most viewed content paths for a repository from the last 14 days.

Fetches the top 10 websites that referred traffic to a repository within the last 14 days.

Retrieves a GitHub user's profile information by their unique numeric account ID. Use when you know the user's numeric ID rather than their username.

Tool to get an item from a user-owned project in GitHub Projects V2. Use when you need to retrieve details about a specific item (issue, pull request, or draft issue) in a user's project board.

Tool to get attestations by subject digest for a GitHub user. Use when you need to retrieve attestation data for a specific artifact or resource identified by its subject digest.

Tool to list GitHub Projects v2 for a specified user. Use when you need to retrieve all projects owned by a user with pagination support.

Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users.

Tool to retrieve the authenticated user's profile information via GitHub GraphQL. Use when working with GraphQL queries or need viewer details in GraphQL format.

Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.

Retrieves detailed information for a specific job within a GitHub Actions workflow run, given its `job_id` which must be valid for the specified repository's workflow.

Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems.

Gets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle.

Use to determine if the authenticated user has starred a specific GitHub repository, which is confirmed by an HTTP 204 status (resulting in an empty dictionary in the response data); the action fails (e.g., HTTP 404) if the repository is not starred or does not exist.

Lists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`.

Lists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDs

Lists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access.

Lists GitHub Apps with push access to a repository's protected branch.

Lists GitHub Actions workflow artifacts for a specified repository, which must exist.

Lists users who can be assigned to issues in a repository, typically those with push access.

Lists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible.

Tool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. Attestations provide verifiable metadata about software artifacts.

Lists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability and devcontainer configurations.

Lists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit.

Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines.

Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status.

Lists check suites for a Git reference (commit SHA, branch, or tag) in a repository, optionally filtering by GitHub App ID or check run name.

Lists the immediate child teams of a parent team within an organization.

Lists GitHub Classrooms to which the authenticated user has administrative access.

Lists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), Git reference, state, or severity.

Lists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both.

Lists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID.

Lists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref.

Lists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed.

Retrieves all available codes of conduct from GitHub, often used to select one for a repository.

Tool to fetch all available codes of conduct using GitHub's GraphQL API. Use when you need to retrieve the complete list of codes of conduct that can be applied to repositories.

Lists all GitHub Codespaces owned by a specified member of a given organization.

Lists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination.

Lists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own.

Tool to list issue and PR comment changes across an organization's repositories efficiently. Use when monitoring comment activity without per-PR/per-issue polling. Filters organization events to return only comment-related events (IssueCommentEvent, PullRequestReviewCommentEvent, CommitCommentEvent). Note: Events are limited to the past 30 days and up to 300 events per timeline. Use ETag header for efficient polling to avoid rate limits.

Lists all comments for a specific review on a GitHub pull request.

Retrieves all comments for a specific commit in a GitHub repository, supporting pagination.

Lists all commit comments for a specified repository, which must exist and be accessible.

Lists commits for a GitHub repository. Requires 'owner' (username/org) and 'repo' (repository name) parameters. Optionally filter by SHA/branch, path, author, committer, or date range.

Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.

Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary.

Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories.

Gets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. Returns an empty array if no custom properties are set.

Lists repositories in an organization with their custom property values. Requires 'Custom properties' organization permission (read).

Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists.

Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details.

Lists deploy SSH keys for a specified repository; the repository must exist.

Lists all deployment branch policies for a specified environment in a GitHub repository.

Lists all statuses for a given deployment in a repository.

Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility. This action retrieves the complete list of email addresses associated with the authenticated user, providing important details such as which email is primary and whether the emails are verified.

Lists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded.

Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository.

Lists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository.

Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.

Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order.

Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public.

Lists followers for a specified, existing GitHub user.

Lists users following the authenticated GitHub user, returning an empty list if the user has no followers.

Lists forks for a specified repository, which must exist, with options for sorting and pagination.

Lists comments for a specified GitHub Gist.

Lists all commits for a specified gist.

Lists all forks for a given GitHub gist ID.