# GitHub — MCP server on mcp.ai
> GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features

By: mcp.ai · official
Page: https://mcp.ai/github

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_github?ms=1784578800000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/github/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/github/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/github/skill.md
Postman collection (v2.1): https://mcp.ai/github/postman.json

## Tools
- github_accept_a_repository_invitation(invitation_id: integer) — Accepts a pending repository invitation that has been issued to the authenticated user.
- github_activity_list_repo_s_starred_by_authenticated_user(page?: integer, sort?: string, per_page?: integer, direction?: string) — Deprecated: lists repositories starred by the authenticated user, including star creation timestamps; use 'list repositories starred by the authenticated user' instead.
- github_activity_list_stargazers_for_repo(page?: integer, repo: string, owner: string, per_page?: integer) — Deprecated: lists users who have starred a repository; use `list stargazers` instead.
- github_activity_star_repo_for_authenticated_user(repo: string, owner: string) — Deprecated: stars a repository for the authenticated user; use `star a repository for the authenticated user` instead.
- github_add_a_repository_collaborator(repo: string, owner: string, username: string, permission?: string) — Adds a github user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ign
- github_add_a_repository_to_an_app_installation(repository_id: integer, installation_id: integer) — 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.
- github_add_a_selected_repository_to_a_user_secret(secret_name: string, repository_id: integer) — Grants a specified repository access to an authenticated user's existing codespaces secret, enabling codespaces created for that repository to use the secret.
- github_add_an_email_address_for_the_authenticated_user(emails: string[]) — Adds one or more email addresses (which will be initially unverified) to the authenticated user's github account; use this to associate new emails, noting an email verified for another account will er
- github_add_app_access_restrictions(repo: string, owner: string, branch: string) — Replaces github app access restrictions for an existing protected branch; requires a json array of app slugs in the request body, where apps must be installed and have 'contents' write permissions.
- github_add_assignees_to_an_issue(repo: string, owner: string, assignees?: string[], issue_number: integer) — Adds or removes assignees for a github issue; changes are silently ignored if the authenticated user lacks push access to the repository.
- github_add_labels_to_an_issue(repo: string, owner: string, issue_number: integer) — Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created.
- github_add_or_update_team_membership_for_a_user(org: string, role?: string, username: string, team_slug: string) — Adds a github user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made.
- github_add_or_update_team_project_permissions(org: string, team_slug: string, permission?: string, project_id: integer) — Grants or updates a team's permissions ('read', 'write', or 'admin') for a specific project, which must exist within the specified organization and be linked to it.
- github_add_or_update_team_repository_permissions(org: string, repo: string, owner: string, team_slug: string, permission?: string) — Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.
- github_add_org_runner_labels(org: string, labels: string[], runner_id: integer) — Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added.
- github_add_project_collaborator(username: string, permission?: string, project_id: integer) — Adds a specified github user as a collaborator to an existing organization project with a given permission level.
- github_add_repo_to_org_secret_with_selected_access(org: string, secret_name: string, repository_id: integer) — Adds a repository to an existing organization-level github actions secret that is configured for 'selected' repository access.
- github_add_repo_to_org_secret_with_selected_visibility(org: string, secret_name: string, repository_id: integer) — Grants an existing repository access to an existing organization-level dependabot secret; the repository must belong to the organization, and the call succeeds without change if access already exists.
- github_add_runner_labels(repo: string, owner: string, labels: string[], runner_id: integer) — Adds and appends custom labels to a self-hosted repository runner, which must be registered and active.
- github_add_selected_repository_to_an_organization_secret(org: string, secret_name: string, repository_id: integer) — Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent.
- github_add_selected_repository_to_an_organization_variable(org: string, name: string, repository_id: integer) — Grants a repository access to an organization-level github actions variable, if that variable's visibility is set to 'selected repositories'.
- github_add_social_accounts_for_the_authenticated_user(account_urls: string[]) — 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.
- github_add_status_check_contexts(repo: string, owner: string, branch: string) — Adds status check contexts (provided in the request body, e.g., `{"contexts": ["new-context"]}`) to a protected branch, requiring these contexts to have been previously reported.
- github_add_team_access_restrictions(repo: string, owner: string, branch: string) — Overwrites the list of teams (and their child teams) granted push access to a protected branch; the list of team slugs must be provided in the http post request body.
- github_add_user_access_restrictions(repo: string, owner: string, branch: string) — Sets/replaces list of users allowed to push to a protected branch; usernames (e.g., `["user1"]`) must be a json array in request body (not schema parameters), an empty array `[]` removes all restricti
- github_add_users_to_codespaces_access_for_an_organization(org: string, selected_usernames: string[]) — Sets or replaces the list of organization members granted codespaces access billed to the organization; ensure the organization's billing settings allow access for selected members.
- github_approve_a_workflow_run_for_a_fork_pull_request(repo: string, owner: string, run_id: integer) — Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration.
- github_assign_an_organization_role_to_a_team(org: string, role_id: integer, team_slug: string) — 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 exis
- github_assign_an_organization_role_to_a_user(org: string, role_id: integer, username: string) — 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.
- github_auth_user_docker_conflict_packages_list() — Lists docker packages for the authenticated user that encountered conflicts during the docker migration process.
- github_block_a_user(username: string) — Blocks an existing individual github user (not an organization or your own account), preventing them from interacting with your account and repositories.
- github_block_a_user_from_an_organization(org: string, username: string) — Blocks an existing github user from an existing organization, preventing their contributions, collaboration, and forking of the organization's repositories.
- github_cancel_a_github_pages_deployment(repo: string, owner: string, pages_deployment_id: integer) — Cancels an existing, ongoing or queued github pages deployment for a repository using its `pages deployment id`.
- github_cancel_a_workflow_run(repo: string, owner: string, run_id: integer) — Cancels a workflow run in a github repository if it is in a cancellable state (e.g., 'in progress' or 'queued').
- github_check_a_token(client_id: string, access_token: string) — 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.
- github_check_if_a_gist_is_starred(gist_id: string) — Checks if a gist, identified by `gist id`, is starred by the authenticated user, returning an empty response (204) if starred, or a 404 error if not starred or not found.
- github_check_if_a_person_is_followed_by_the_authenticated_user(username: string) — Checks if the authenticated github user follows a target github user; an http 204 status indicates the user is followed, while an http 404 status indicates the user is not followed or the target user 
- github_check_if_a_pull_request_has_been_merged(repo: string, owner: string, pull_number: integer) — Checks if a specified github pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found).
- github_check_if_a_repository_is_starred_by_the_authenticated_user(repo: string, owner: string) — 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 
- github_check_if_a_user_can_be_assigned(repo: string, owner: string, assignee: string) — 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.
- github_check_if_a_user_can_be_assigned_to_a_issue(repo: string, owner: string, assignee: string, issue_number: integer) — Checks if a specified github user can be assigned to a given issue within a repository.
- github_check_if_a_user_follows_another_user(username: string, target_user: string) — Checks if a github user `username` follows `target user`; returns a 204 http status if true, 404 if not or if users are invalid.
- github_check_if_a_user_is_a_repository_collaborator(repo: string, owner: string, username: string) — 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.
- github_check_if_a_user_is_blocked_by_an_organization(org: string, username: string) — Checks if a github user is blocked by an organization; a successful response (204 no content) indicates the user is blocked, while a 404 not found error indicates the user is not blocked.
- github_check_if_a_user_is_blocked_by_the_authenticated_user(username: string) — 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.
- github_check_private_vulnerability_reporting_status(repo: string, owner: string) — Checks if private vulnerability reporting is enabled for the specified repository.
- github_check_team_permissions_for_a_project(org: string, team_slug: string, project_id: integer) — 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.
- github_check_team_permissions_for_a_repository(org: string, repo: string, owner: string, team_slug: string) — Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.
- github_clear_repository_cache_by_key(key: string, ref?: string, repo: string, owner: string) — 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 
- github_clear_self_hosted_runner_org_labels(org: string, runner_id: integer) — Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain.
- github_compare_two_commits(page?: integer, repo: string, owner: string, basehead: string, per_page?: integer) — Compares two commit points (commits, branches, tags, or shas) within a repository or across forks, using `base...head` or `owner:ref...owner:ref` format for the `basehead` parameter.
- github_configure_jitrunner_for_org(org: string, name: string, labels: string[], work_folder?: string, runner_group_id: integer) — Generates a jit configuration for a github organization's new self-hosted runner to run a single job then unregister; the runner group id must exist.
- github_configure_oidcsubject_claim_template(org: string, include_claim_keys: string[]) — 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`).
- github_convert_an_organization_member_to_outside_collaborator(org: string, async?: boolean, username: string) — Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories.
- github_create_a_blob(repo: string, owner: string, content: string, encoding?: string) — Creates a git blob in a repository, requiring content and encoding ('utf-8' or 'base64').
- github_create_a_check_run(name: string, repo: string, owner: string, status?: string, actions?: object[], head_sha: string, conclusion?: string, started_at?: string, details_url?: string, external_id?: string, completed_at?: string, output__text?: string, output__title?: string, output__images?: object[], output__summary?: string, output__annotations?: object[]) — 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.
- github_create_a_check_suite(repo: string, owner: string, head_sha: string) — Creates a new check suite for a specific commit (`head sha`) in an original repository (not a fork); github dispatches a `check suite` webhook event with the `requested` action upon success.
- github_create_a_codespace_for_the_authenticated_user(ref?: string, pull_request?: object, repository_id?: integer) — 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 `r
- github_create_a_codespace_from_a_pull_request(geo?: string, repo: string, owner: string, machine?: string, location?: string, client_ip?: string, pull_number: integer, display_name?: string, devcontainer_path?: string, working_directory?: string, idle_timeout_minutes?: integer, retention_period_minutes?: integer, multi_repo_permissions_opt_out?: boolean) — Creates a github codespace for an open pull request in a codespaces-enabled repository, with options to customize its configuration.
- github_create_a_codespace_in_a_repository(geo?: string, ref?: string, repo: string, owner: string, machine?: string, location?: string, client_ip?: string, display_name?: string, devcontainer_path?: string, working_directory?: string, idle_timeout_minutes?: integer, retention_period_minutes?: integer, multi_repo_permissions_opt_out?: boolean) — 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.
- github_create_a_commit(repo: string, tree: string, owner: string, message: string, parents?: string[], signature?: string, author__date?: string, author__name?: string, author__email?: string, committer__date?: string, committer__name?: string, committer__email?: string) — Creates a new commit in a github repository; the `tree` sha and any `parents` shas must already exist in the repository.
- github_create_a_commit_comment(body: string, line?: integer, path?: string, repo: string, owner: string, position?: integer, commit_sha: string) — Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided.
- github_create_a_commit_status(sha: string, repo: string, owner: string, state: string, context?: string, target_url?: string, description?: string) — Sets a commit's status (e.g., error, failure, pending, success from ci/cd) for a given sha; max 1000 statuses per sha/context.
- github_create_a_custom_organization_role(org: string, name: string, description?: string, permissions: string[]) — Creates a custom role with defined permissions within a github organization.
- github_create_a_deploy_key(key: string, repo: string, owner: string, title?: string, read_only?: boolean) — 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.
- github_create_a_deployment(ref: string, repo: string, task?: string, owner: string, payload?: string, auto_merge?: boolean, description?: string, environment?: string, required_contexts?: string[], transient_environment?: boolean, production_environment?: boolean) — Creates a github deployment for an existing repository, targeting a specific ref (branch, tag, or sha) that must also exist within the repository.
- github_create_a_deployment_branch_policy(name: string, repo: string, type?: string, owner: string, environment_name: string) — 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 depl
- github_create_a_deployment_status(repo: string, owner: string, state: string, log_url?: string, target_url?: string, description?: string, environment?: string, auto_inactive?: boolean, deployment_id: integer, environment_url?: string) — Creates a status for an existing deployment, updating its operational state, associated urls, and description.
- github_create_a_discussion(org: string, body: string, title: string, private?: boolean, team_slug: string) — Creates a new discussion post on a specific team's page within an organization.
- github_create_a_discussion_comment(org: string, body: string, team_slug: string, discussion_number: integer) — Creates a new comment on an existing team discussion within a github organization.
- github_create_a_fork(name?: string, repo: string, owner: string, organization?: string, default_branch_only?: boolean) — Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.
- github_create_a_gist(files: object, public?: boolean, description?: string) — Creates a new gist on github with provided files, an optional description, and public/secret visibility.
- github_create_a_gist_comment(body: string, gist_id: string) — Creates a new comment on a specified github gist.
- github_create_a_github_app_from_a_manifest(code: string) — Use this action to finalize a github app's creation by exchanging the temporary `code` (received as a url parameter during the app manifest setup redirection) for the app's full configuration details.
- github_create_a_github_pages_deployment(repo: string, owner: string, oidc_token: string, artifact_id?: integer, environment?: string, artifact_url?: string, pages_build_version?: string) — 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.
- github_create_a_github_pages_site(repo: string, owner: string, build_type?: string, source__path?: string, source__branch?: string) — 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 `b
- github_create_a_label(name: string, repo: string, color?: string, owner: string, description?: string) — Creates a new label in a specified github repository, provided the repository exists and the user has write permissions.
- github_create_a_milestone(repo: string, owner: string, state?: string, title: string, due_on?: string, description?: string) — Creates a milestone in a github repository for tracking progress on issues or pull requests; requires repository existence and user write permissions.
- github_create_a_project_card(column_id: integer) — Creates a project card in a github project column; the request body must contain either a `note` for a note-only card, or both `content id` (id of an issue or pull request) and `content type` (e.g., '
- github_create_a_project_column(name: string, project_id: integer) — Creates a new column in a github project (classic).
- github_create_a_pull_request(base: string, body?: string, head: string, repo: string, draft?: boolean, issue?: integer, owner: string, title?: string, head_repo?: string, maintainer_can_modify?: boolean) — Creates a pull request in a github repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.
- github_create_a_reference(ref: string, sha: string, repo: string, owner: string) — Creates a git reference (e.g., a branch or tag) in a repository; the repository must not be empty prior to this operation.
- github_create_a_registration_token_for_a_repository(repo: string, owner: string) — Generates a time-limited token required to register a new self-hosted runner with a specific repository.
- github_create_a_registration_token_for_an_organization(org: string) — Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for github actions.
- github_create_a_release(body?: string, name?: string, repo: string, draft?: boolean, owner: string, tag_name: string, prerelease?: boolean, make_latest?: string, target_commitish?: string, generate_release_notes?: boolean, discussion_category_name?: string) — 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.
- github_create_a_remove_token_for_a_repository(repo: string, owner: string) — Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.
- github_create_a_remove_token_for_an_organization(org: string) — Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.
- github_create_a_reply_for_a_review_comment(body: string, repo: string, owner: string, comment_id: integer, pull_number: integer) — 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.
- github_create_a_repository_dispatch_event(repo: string, owner: string, event_type: string, client_payload?: object) — 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.
- github_create_a_repository_for_the_authenticated_user(name: string, private?: boolean, team_id?: integer, has_wiki?: boolean, homepage?: string, auto_init?: boolean, has_issues?: boolean, description?: string, is_template?: boolean, has_projects?: boolean, has_downloads?: boolean, has_discussions?: boolean, allow_auto_merge?: boolean, license_template?: string, allow_merge_commit?: boolean, allow_rebase_merge?: boolean, allow_squash_merge?: boolean, gitignore_template?: string, merge_commit_title?: string, merge_commit_message?: string, delete_branch_on_merge?: boolean, squash_merge_commit_title?: string, squash_merge_commit_message?: string) — Creates a new repository for the authenticated user, optionally within an organization if `team id` is specified.
- github_create_a_repository_from_an_unpublished_codespace(name?: string, private?: boolean, codespace_name: string) — Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit.
- github_create_a_repository_project(body?: string, name: string, repo: string, owner: string) — Creates a new classic project board within a specified repository; classic projects must be enabled for the target repository.
- github_create_a_repository_ruleset(name: string, repo: string, owner: string, rules?: object[], target?: string, enforcement: string, bypass_actors?: object[], conditions__ref__name__exclude?: string[], conditions__ref__name__include?: string[]) — Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.
- github_create_a_repository_using_a_template(name: string, owner?: string, private?: boolean, description?: string, template_repo: string, template_owner: string, include_all_branches?: boolean) — 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.
- github_create_a_repository_variable(name: string, repo: string, owner: string, value: string) — Creates a new, unencrypted variable in a repository for github actions workflows; fails if a variable with the same name already exists.
- github_create_a_repository_webhook(name?: string, repo: string, owner: string, active?: boolean, events?: string[], config__url?: string, config__secret?: string, config__content__type?: string, config__insecure__ssl?: string) — Creates a webhook for a specified repository; requires admin permissions on the repository.
- github_create_a_review_comment_for_a_pull_request(body: string, line?: integer, path: string, repo: string, side?: string, owner: string, position?: integer, commit_id: string, start_line?: integer, start_side?: string, in_reply_to?: integer, pull_number: integer, subject_type?: string) — 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.
- github_create_a_review_for_a_pull_request(body?: string, repo: string, event?: string, owner: string, comments?: object[], commit_id?: string, pull_number: integer) — 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`.
- github_create_a_scoped_access_token(target?: string, client_id: string, target_id?: integer, access_token: string, repositories?: string[], repository_ids?: integer[], permissions__pages?: string, permissions__checks?: string, permissions__issues?: string, permissions__actions?: string, permissions__members?: string, permissions__profile?: string, permissions__secrets?: string, permissions__contents?: string, permissions__metadata?: string, permissions__packages?: string, permissions__starring?: string, permissions__statuses?: string, permissions__followers?: string, permissions__gpg__keys?: string, permissions__workflows?: string, permissions__codespaces?: string, permissions__deployments?: string, permissions__environments?: string, permissions__single__file?: string, permissions__administration?: string, permissions__git__ssh__keys?: string, permissions__pull__requests?: string, permissions__email__addresses?: string, permissions__security__events?: string, permissions__repository__hooks?: string, permissions__team__discussions?: string, permissions__organization__plan?: string, permissions__dependabot__secrets?: string, permissions__interaction__limits?: string, permissions__organization__hooks?: string, permissions__organization__events?: string, permissions__repository__projects?: string, permissions__organization__secrets?: string, permissions__vulnerability__alerts?: string, permissions__organization__packages?: string, permissions__organization__projects?: string, permissions__secret__scanning__alerts?: string, permissions__organization__custom__roles?: string, permissions__organization__administration?: string, permissions__organization__user__blocking?: string, permissions__repository__custom__properties?: string, permissions__organization__custom__org__roles?: string, permissions__organization__custom__properties?: string, permissions__organization__announcement__banners?: string, permissions__organization__self__hosted__runners?: string, permissions__organization__personal__access__tokens?: string, permissions__organization__copilot__seat__management?: string, permissions__organization__personal__access__token__requests?: string) — 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 r
- github_create_a_snapshot_of_dependencies_for_a_repository(ref: string, sha: string, repo: string, owner: string, job__id?: string, scanned: string, version: integer, metadata?: object, manifests?: object, detector__url?: string, detector__name?: string, job__html__url?: string, job__correlator?: string, detector__version?: string) — 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
- github_create_a_tag_object(tag: string, repo: string, type: string, owner: string, object: string, message: string, tagger__date?: string, tagger__name?: string, tagger__email?: string) — 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.
- github_create_a_tag_protection_state_for_a_repository(repo: string, owner: string, pattern: string) — Creates a tag protection rule for a repository using a glob pattern; note: tag protections are deprecated (sunset august 30, 2024), migrate to repository rulesets.
- github_create_a_team(org: string, name: string, privacy?: string, permission?: string, repo_names?: string[], description?: string, maintainers?: string[], parent_team_id?: integer, notification_setting?: string) — 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'.
- github_create_a_temporary_private_fork(repo: string, owner: string, ghsa_id: string) — 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 
- github_create_a_tree(repo: string, tree: object[], owner: string, base_tree?: string) — 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.
- github_create_a_user_project(body?: string, name: string) — Creates a new github project board for the authenticated user to organize and track issues, pull requests, and notes.
- github_create_a_workflow_dispatch_event(ref: string, repo: string, owner: string, inputs?: object, workflow_id: integer) — Manually triggers a github actions workflow identified by `workflow id` at a given `ref`, if the workflow is configured to accept `workflow dispatch` events.
- github_create_an_autolink_reference_for_a_repository(repo: string, owner: string, key_prefix: string, url_template: string, is_alphanumeric?: boolean) — 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>`.
- github_create_an_environment_variable(name: string, repo: string, owner: string, value: string, environment_name: string) — Creates an encrypted environment variable for a pre-existing environment within a github repository; will fail if the variable name already exists.
- github_create_an_issue(body?: string, repo: string, owner: string, title: string, labels?: string[], assignee?: string, assignees?: string[], milestone?: string) — 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.
- github_create_an_issue_comment(body: string, repo: string, owner: string, issue_number: integer) — Creates a new comment on an existing github issue or pull request within the specified repository.
- github_create_an_organization_project(org: string, body?: string, name: string) — Creates a new classic project board within a specified github organization.
- github_create_an_organization_repository(org: string, name: string, private?: boolean, team_id?: integer, has_wiki?: boolean, homepage?: string, auto_init?: boolean, has_issues?: boolean, visibility?: string, description?: string, is_template?: boolean, has_projects?: boolean, has_downloads?: boolean, allow_auto_merge?: boolean, license_template?: string, custom_properties?: object, allow_merge_commit?: boolean, allow_rebase_merge?: boolean, allow_squash_merge?: boolean, gitignore_template?: string, merge_commit_title?: string, merge_commit_message?: string, delete_branch_on_merge?: boolean, squash_merge_commit_title?: string, squash_merge_commit_message?: string, use_squash_pr_title_as_default?: boolean) — Creates a new repository within a specified github organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates.
- github_create_an_organization_variable(org: string, name: string, value: string, visibility: string, selected_repository_ids?: integer[]) — Creates a new, uniquely named github actions variable for an organization, with configurable repository access visibility (all, private, or selected).
- github_create_an_organization_webhook(org: string, name: string, active?: boolean, events?: string[], config__url?: string, config__secret?: string, config__password?: string, config__username?: string, config__content__type?: string, config__insecure__ssl?: string) — Creates a webhook for a github organization to deliver event notifications to a configured url.
- github_create_commit_signature_protection(repo: string, owner: string, branch: string) — Enables commit signature protection for a specified branch, requiring all new commits to be signed.
- github_create_deployment_protection_rule(repo: string, owner: string, integration_id?: integer, environment_name: string) — 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.
- github_create_jit_runner_config(name: string, repo: string, owner: string, labels: string[], work_folder?: string, runner_group_id: integer) — 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 access
- github_create_or_update_a_custom_property_for_an_organization(org: string, required?: boolean, value_type: string, description?: string, default_value?: string, allowed_values?: string[], custom_property_name: string) — 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.
- github_create_or_update_a_repository_secret(repo: string, owner: string, key_id?: string, secret_name: string, encrypted_value?: string) — Creates or updates a github actions secret within a specific repository; use `encrypted value` and `key id` to set or change its value.
- github_create_or_update_a_secret_for_the_authenticated_user(key_id: string, secret_name: string, encrypted_value?: string, selected_repository_ids?: integer[]) — 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' endp
- github_create_or_update_an_environment(repo: string, owner: string, reviewers?: object[], wait_timer?: integer, environment_name: string, prevent_self_review?: boolean, deployment__branch__policy__protected__branches?: boolean, deployment__branch__policy__custom__branch__policies?: boolean) — 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-e
- github_create_or_update_an_environment_secret(repo: string, owner: string, key_id: string, secret_name: string, encrypted_value: string, environment_name: string) — 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.
- github_create_or_update_an_organization_secret(org: string, key_id?: string, visibility: string, secret_name: string, encrypted_value?: string, selected_repository_ids?: integer[]) — Creates or updates an organization secret for github actions, requiring its value to be pre-encrypted via libsodium using the organization's public key.
- github_create_or_update_custom_properties_for_an_organization(org: string, properties: object[]) — 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`.
- github_create_or_update_custom_property_values_for_a_repository(repo: string, owner: string, properties: object[]) — Creates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level, and setting a property's value to `null` removes it.
- github_create_or_update_file_contents(sha?: string, path: string, repo: string, owner: string, branch?: string, content: string, message: string, author__date?: string, author__name?: string, author__email?: string, committer__date?: string, committer__name?: string, committer__email?: string) — Creates a new file or updates an existing file in a github repository; provide `sha` to update an existing file, otherwise a new file is created.
- github_create_or_update_repo_secret_with_encrypted_value(repo: string, owner: string, key_id?: string, secret_name: string, encrypted_value?: string) — 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`.
- github_create_reaction_for_a_commit_comment(repo: string, owner: string, content: string, comment_id: integer) — 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.
- github_create_reaction_for_a_pull_request_review_comment(repo: string, owner: string, content: string, comment_id: integer) — Adds a specified reaction to a pull request review comment within a github repository.
- github_create_reaction_for_a_release(repo: string, owner: string, content: string, release_id: integer) — Creates an emoji reaction for a specific, existing release in a github repository.
- github_create_reaction_for_a_team_discussion(org: string, content: string, team_slug: string, discussion_number: integer) — Creates a reaction for a team discussion within a github organization.
- github_create_reaction_for_a_team_discussion_comment(org: string, content: string, team_slug: string, comment_number: integer, discussion_number: integer) — Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.
- github_create_reaction_for_an_issue(repo: string, owner: string, content: string, issue_number: integer) — Creates a reaction for a specified issue within a github repository.
- github_create_reaction_for_an_issue_comment(repo: string, owner: string, content: string, comment_id: integer) — Creates a reaction for a specific comment on an issue within a github repository.
- github_create_update_org_secret_with_lib_sodium(org: string, key_id?: string, visibility: string, secret_name: string, encrypted_value?: string, selected_repository_ids?: string[]) — 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
- github_custom_oidcsubject_claim_template(org: string) — 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.
- github_custom_oidcsubject_claim_template_setter(repo: string, owner: string, use_default: boolean, include_claim_keys?: string[]) — Sets the openid connect (oidc) subject claim template for a github repository, allowing use of the default template or a custom one defined by `include claim keys` if `use default` is `false`.
- github_customize_oidc_subject_claim_template(repo: string, owner: string) — 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 conf
- github_decline_a_repository_invitation(invitation_id: integer) — Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation id`.
- github_delete_a_code_scanning_analysis_from_a_repository(repo: string, owner: string, analysis_id: integer, confirm_delete?: string) — 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.
- github_delete_a_codespace_for_the_authenticated_user(codespace_name: string) — Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.
- github_delete_a_codespace_from_the_organization(org: string, username: string, codespace_name: string) — Permanently deletes a specific codespace belonging to a member of the specified organization.
- github_delete_a_commit_comment(repo: string, owner: string, comment_id: integer) — Deletes a specific commit comment, identified by its `comment id`, from the specified repository; the comment must exist.
- github_delete_a_commit_comment_reaction(repo: string, owner: string, comment_id: integer, reaction_id: integer) — Deletes a reaction from a commit comment in a github repository.
- github_delete_a_custom_organization_role(org: string, role_id: integer) — Deletes a custom organization role (which should not be actively assigned) by its id; a 204 no content response indicates success.
- github_delete_a_deploy_key(repo: string, owner: string, key_id: integer) — 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.
- github_delete_a_deployment(repo: string, owner: string, deployment_id: integer) — Permanently deletes a specified *inactive* deployment from a repository.
- github_delete_a_deployment_branch_policy(repo: string, owner: string, branch_policy_id: integer, environment_name: string) — Deletes a specific deployment branch or tag policy, identified by its id, from a given environment within a repository.
- github_delete_a_discussion(org: string, team_slug: string, discussion_number: integer) — Deletes a specific team discussion, identified by its number, from an organization's team.
- github_delete_a_discussion_comment(org: string, team_slug: string, comment_number: integer, discussion_number: integer) — Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist.
- github_delete_a_file(sha: string, path: string, repo: string, owner: string, branch?: string, message: string, author__name?: string, author__email?: string, committer__name?: string, committer__email?: string) — Deletes a file by path from a github repository, requiring a commit message and the file's current blob sha to confirm the deletion.
- github_delete_a_gist(gist_id: string) — Permanently deletes an existing github gist, specified by its `gist id`; this action is destructive and cannot be undone.
- github_delete_a_gist_comment(gist_id: string, comment_id: integer) — Deletes a specific comment from a github gist using its `gist id` and `comment id`.
- github_delete_a_github_pages_site(repo: string, owner: string) — Deletes the github pages site for the specified repository; completes without error if no site is currently enabled.
- github_delete_a_label(name: string, repo: string, owner: string) — Permanently removes an existing label from a repository.
- github_delete_a_milestone(repo: string, owner: string, milestone_number: integer) — Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.
- github_delete_a_package_for_a_user(username: string, package_name: string, package_type: string) — 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.
- github_delete_a_package_for_an_organization(org: string, package_name: string, package_type: string) — Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads.
- github_delete_a_package_for_the_authenticated_user(package_name: string, package_type: string) — Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this api.
- github_delete_a_package_version_for_the_authenticated_user(package_name: string, package_type: string, package_version_id: integer) — Deletes an existing package version associated with the authenticated user.
- github_delete_a_pending_review_for_a_pull_request(repo: string, owner: string, review_id: integer, pull_number: integer) — Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted.
- github_delete_a_project(project_id: integer) — Deletes the github project specified by `project id` if the project exists and the projects feature is enabled for its repository or organization; a successful deletion results in a 204 no content res
- github_delete_a_project_card(card_id: integer) — Deletes a project card from a github 'project (classic)'; this operation is idempotent.
- github_delete_a_project_column(column_id: integer) — Deletes a project column by its id from a github project (classic); this is a destructive operation.
- github_delete_a_pull_request_comment_reaction(repo: string, owner: string, comment_id: integer, reaction_id: integer) — Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository.
- github_delete_a_reference(ref: string, repo: string, owner: string) — Deletes a git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag').
- github_delete_a_release(repo: string, owner: string, release_id: integer) — Permanently deletes a specific release, its assets, and potentially its associated git tag from a repository.
- github_delete_a_release_asset(repo: string, owner: string, asset_id: integer) — Deletes a specific release asset from a github repository; this action is idempotent.
- github_delete_a_release_reaction(repo: string, owner: string, release_id: integer, reaction_id: integer) — Deletes a reaction from a github release, provided the repository, release, and reaction exist.
- github_delete_a_repository(repo: string, owner: string) — Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository.
- github_delete_a_repository_invitation(repo: string, owner: string, invitation_id: integer) — Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository.
- github_delete_a_repository_ruleset(repo: string, owner: string, ruleset_id: integer) — Permanently deletes a repository ruleset.
- github_delete_a_repository_secret(repo: string, owner: string, secret_name: string) — Deletes a named github actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist.
- github_delete_a_repository_subscription(repo: string, owner: string) — Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it.
- github_delete_a_repository_variable(name: string, repo: string, owner: string) — Deletes a named variable (e.g., for github actions workflows) from a repository; the repository and the variable must already exist.
- github_delete_a_repository_webhook(repo: string, owner: string, hook_id: integer) — Deletes a specific webhook from a repository.
- github_delete_a_review_comment_for_a_pull_request(repo: string, owner: string, comment_id: integer) — Deletes a specific pull request review comment.
- github_delete_a_secret_for_the_authenticated_user(secret_name: string) — Deletes an existing codespaces secret for the authenticated user by `secret name`; this is a destructive, irreversible, and idempotent operation.
- github_delete_a_self_hosted_runner_from_a_repository(repo: string, owner: string, runner_id: integer) — Removes a specific self-hosted runner (by `runner id`) from a repository, if registered there; this is idempotent.
- github_delete_a_self_hosted_runner_from_an_organization(org: string, runner_id: integer) — Deletes an existing and registered self-hosted runner from an organization, typically returning 204 no content on success.
- github_delete_a_tag_protection_state_for_a_repository(repo: string, owner: string, tag_protection_id: integer) — Permanently deletes a specific tag protection rule, identified by its id, from the given repository.
- github_delete_a_team(org: string, team_slug: string) — Deletes a team (and any child teams) from an organization.
- github_delete_a_thread_subscription(thread_id: integer) — 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.
- github_delete_a_workflow_run(repo: string, owner: string, run_id: integer) — Deletes a specific workflow run from a repository.
- github_delete_access_restrictions(repo: string, owner: string, branch: string) — Removes all user, team, and app-based access restrictions from a protected branch.
- github_delete_admin_branch_protection(repo: string, owner: string, branch: string) — Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository.
- github_delete_an_app_authorization(client_id: string, access_token: string) — Revokes a single, specific oauth access token for an oauth app, not all authorizations for the app.
- github_delete_an_app_token(client_id: string, access_token: string) — Revokes an oauth access token for a github app, if the app exists and the token was issued to it.
- github_delete_an_artifact(repo: string, owner: string, artifact_id: integer) — Deletes a github artifact by its id within a repository, typically resulting in an empty response (http 204 no content) on success.
- github_delete_an_autolink_reference_from_a_repository(repo: string, owner: string, autolink_id: integer) — Deletes a specific autolink reference (which automatically links external resource ids like jira-123 to urls) from the specified repository.
- github_delete_an_email_address_for_the_authenticated_user(emails: string[]) — 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.
- github_delete_an_environment(repo: string, owner: string, environment_name: string) — Deletes an existing deployment environment from an existing repository.
- github_delete_an_environment_secret(repo: string, owner: string, secret_name: string, environment_name: string) — Deletes an existing and accessible secret from a specified environment within a github repository, returning an empty dictionary on success or error details otherwise.
- github_delete_an_environment_variable(name: string, repo: string, owner: string, environment_name: string) — Deletes a named environment variable from a specified, existing environment within a github repository.
- github_delete_an_issue_comment(repo: string, owner: string, comment_id: integer) — Permanently deletes a specific comment by its id from an issue or pull request, if the repository exists and the comment id is valid.
- github_delete_an_issue_comment_reaction(repo: string, owner: string, comment_id: integer, reaction_id: integer) — Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.
- github_delete_an_issue_reaction(repo: string, owner: string, reaction_id: integer, issue_number: integer) — Permanently removes a specific reaction from an issue in a github repository.
- github_delete_an_organization(org: string) — 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.
- github_delete_an_organization_secret(org: string, secret_name: string) — Permanently deletes a secret from a github organization, making it inaccessible to github actions workflows or other tools.
- github_delete_an_organization_variable(org: string, name: string) — Deletes a named github actions variable from a specified organization.
- github_delete_an_organization_webhook(org: string, hook_id: integer) — Deletes a specific webhook, identified by `hook id`, from an existing organization.
- github_delete_branch_protection(repo: string, owner: string, branch: string) — Removes all protection rules from a specific branch in a github repository; the branch must currently have protection rules enabled.
- github_delete_commit_signature_protection(repo: string, owner: string, branch: string) — Disables gpg commit signature protection for a specific branch in a github repository, meaning commits pushed to this branch no longer require gpg signing.
- github_delete_dependebot_secret_by_name(repo: string, owner: string, secret_name: string) — Deletes a specific dependabot secret, identified by its name, from a given repository if both the repository and secret exist.
- github_delete_github_actions_cache_by_id(repo: string, owner: string, cache_id: integer) — Deletes a specific github actions cache from a repository using its unique `cache id`.
- github_delete_package_version_for_a_user(username: string, package_name: string, package_type: string, package_version_id: integer) — Permanently and irreversibly deletes a specific version of a package owned by the specified user.
- github_delete_package_version_for_an_organization(org: string, package_name: string, package_type: string, package_version_id: integer) — Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.
- github_delete_pull_request_review_protection(repo: string, owner: string, branch: string) — 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 cur
- github_delete_repo_codespace_secret_by_name(repo: string, owner: string, secret_name: string) — 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.
- github_delete_social_accounts_for_the_authenticated_user(account_urls: string[]) — Deletes currently linked social media account urls from the authenticated user's github profile.
- github_delete_team_discussion_comment_reaction(org: string, team_slug: string, reaction_id: integer, comment_number: integer, discussion_number: integer) — Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction id.
- github_delete_team_discussion_reaction(org: string, team_slug: string, reaction_id: integer, discussion_number: integer) — Permanently deletes a specific reaction from a team discussion within an organization.
- github_delete_workflow_run_logs(repo: string, owner: string, run_id: integer) — Deletes all logs for a specific workflow run in a github repository, provided the repository and run exist.
- github_disable_a_custom_protection_rule_for_an_environment(repo: string, owner: string, environment_name: string, protection_rule_id: integer) — Disables a specific, currently active custom deployment protection rule for an existing environment within a github repository.
- github_disable_a_workflow(repo: string, owner: string, workflow_id: integer) — Disables a specified workflow (by id or filename) in a given github repository, preventing new automatic triggers; any in-progress runs will continue.
- github_disable_private_vulnerability_reporting_for_a_repository(repo: string, owner: string) — Disables private vulnerability reporting for an existing github repository, preventing direct private vulnerability reports to maintainers via github's interface for this repository.
- github_disable_repository_actions_in_org(org: string, repository_id: integer) — Disables github actions for a specific repository within an organization; this action is only effective if the organization's github actions `enabled repositories` setting is configured to `selected`.
- github_dismiss_a_review_for_a_pull_request(repo: string, event?: string, owner: string, message: string, review_id: integer, pull_number: integer) — Dismisses a review on a pull request with a mandatory explanatory message.
- github_download_a_repository_archive_tar(ref: string, repo: string, owner: string) — Downloads a repository's source code as a tarball (.tar.gz) archive for a specific git reference, if the repository is accessible.
- github_download_a_repository_archive_zip(ref: string, repo: string, owner: string) — Downloads a repository's source code as a zip archive for a specific git reference (branch, tag, or commit sha).
- github_download_an_artifact(repo: string, owner: string, artifact_id: integer, archive_format: string) — Downloads a specific github repository artifact, returning a temporary url to its 'zip' archive, valid for one minute.
- github_download_job_logs_for_a_workflow_run(repo: string, owner: string, job_id: integer) — 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.
- github_download_workflow_run_attempt_logs(repo: string, owner: string, run_id: integer, attempt_number: integer) — Downloads a zip archive of logs for a specific workflow run attempt.
- github_download_workflow_run_logs(repo: string, owner: string, run_id: integer) — Downloads logs for a specific github actions workflow run, typically archived as a zip file, if logs are available (e.g., not expired and the workflow has produced output).
- github_emo_j_is_get() — Lists all emojis available for use on github; deprecated, use `get emojis` instead.
- github_enable_a_workflow(repo: string, owner: string, workflow_id: integer) — Reactivates a currently disabled github actions workflow within a repository using its numerical id.
- github_enable_github_actions_in_selected_repositories(org: string, selected_repository_ids: integer[]) — 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'.
- github_enable_private_vulnerability_reporting_for_a_repository(repo: string, owner: string) — Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.
- github_enable_repo_forgithub_actions(org: string, repository_id: integer) — Enables github actions for a repository if the organization's actions permissions are set to allow for 'selected repositories'.
- github_encrypt_and_update_dev_secret(repo: string, owner: string, key_id?: string, secret_name: string, encrypted_value?: string) — 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
- github_encrypt_org_dev_env_secret(org: string, key_id?: string, visibility: string, secret_name: string, encrypted_value?: string, selected_repository_ids?: integer[]) — Creates or updates an organization's github codespaces secret using an encrypted value and its corresponding public key id.
- github_encrypt_org_secrets_using_public_key(org: string) — Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for codespaces.
- github_export_a_codespace_for_the_authenticated_user(codespace_name: string) — Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download url.
- github_export_a_software_bill_of_materials_sbom_for_a_repository(repo: string, owner: string) — 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.
- github_fetch_public_key_for_secret_encryption(org: string) — Retrieves the public key for an existing github organization, required for encrypting dependabot secrets.
- github_find_pull_requests(page?: integer, repo?: string, sort?: string, label?: string, order?: string, owner?: string, query: string, state?: string, author?: string, assignee?: string, language?: string, mentions?: string, per_page?: integer, is_merged?: boolean, base_branch?: string, head_branch?: string, raw_response?: boolean, created_since?: string, updated_since?: string, for_authenticated_user?: boolean) — Ai-optimized pull request search with smart filtering by repo, author, state, labels, and merge status. builds intelligent search queries and returns clean, actionable pr data.
- github_find_repositories(page?: integer, sort?: string, order?: string, owner?: string, query: string, topic?: string, archived?: boolean, language?: string, per_page?: integer, max_stars?: integer, min_forks?: integer, min_stars?: integer, fork_filter?: string, raw_response?: boolean, for_authenticated_user?: boolean) — Ai-optimized repository search with smart filtering by language, stars, topics, and ownership. builds intelligent search queries and returns clean, actionable repository data.
- github_follow_a_user(username: string) — Allows the authenticated user to follow the github user specified by `username`; this action is idempotent and the user cannot follow themselves.
- github_force_cancel_a_workflow_run(repo: string, owner: string, run_id: integer) — Forcefully cancels an existing github actions workflow run, bypassing normal cancellation conditions; requires write permissions to the repository.
- github_fork_a_gist(gist_id: string) — Forks a specified public gist, creating a copy under the authenticated user's account.
- github_generate_release_notes_content_for_a_release(repo: string, owner: string, tag_name: string, target_commitish?: string, previous_tag_name?: string, configuration_file_path?: string) — Generates markdown release notes content (listing changes, pull requests, and contributors) for a github repository release, customizable via tags and a configuration file.
- github_get_a_blob(repo: string, owner: string, file_sha: string) — 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.
- github_get_a_branch(repo: string, owner: string, branch: string) — Retrieves detailed information for a specified branch within a github repository.
- github_get_a_check_run(repo: string, owner: string, check_run_id: integer) — Retrieves detailed information for a specific check run within a github repository.
- github_get_a_check_suite(repo: string, owner: string, check_suite_id: integer) — Retrieves a specific check suite (a collection of check runs) by its id from a repository accessible to the authenticated user.
- github_get_a_classroom(classroom_id: integer) — Retrieves details for a specific github classroom; the classroom id must correspond to an existing classroom.
- github_get_a_code_of_conduct(key: string) — Retrieves the full details of a specific github code of conduct using its unique key.
- github_get_a_code_ql_database_for_a_repository(repo: string, owner: string, language: string) — 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.
- github_get_a_code_scanning_alert(repo: string, owner: string, alert_number: integer) — Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified github repository.
- github_get_a_code_scanning_analysis_for_a_repository(repo: string, owner: string, analysis_id: integer) — Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis id`.
- github_get_a_code_scanning_default_setup_configuration(repo: string, owner: string) — Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.
- github_get_a_codespace_for_the_authenticated_user(codespace_name: string) — Call to retrieve detailed information for a `codespace name` belonging to the authenticated user, ensuring the codespace exists and is accessible.
- github_get_a_commit(ref: string, page?: integer, repo: string, owner: string, per_page?: integer) — 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.
- github_get_a_commit_comment(repo: string, owner: string, comment_id: integer) — Retrieves the full details of a specific commit comment in a github repository, using its unique identifier.
- github_get_a_commit_object(repo: string, owner: string, commit_sha: string) — Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a github repository, identified by its sha.
- github_get_a_custom_deployment_protection_rule(repo: string, owner: string, environment_name: string, protection_rule_id: integer) — 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.
- github_get_a_custom_property_for_an_organization(org: string, custom_property_name: string) — Retrieves the definition (schema) of a specific, existing custom property for an organization.
- github_get_a_delivery_for_a_repository_webhook(repo: string, owner: string, hook_id: integer, delivery_id: integer) — Retrieves a specific delivery for a repository webhook, identified by its `hook id` and `delivery id`.
- github_get_a_deploy_key(repo: string, owner: string, key_id: integer) — Gets a specific deploy key, identified by its `key id`, for the github repository specified by `owner` and `repo`.
- github_get_a_deployment(repo: string, owner: string, deployment_id: integer) — Gets a specific deployment by id from a repository, provided the repository and deployment id exist.
- github_get_a_deployment_branch_policy(repo: string, owner: string, branch_policy_id: integer, environment_name: string) — Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique id.
- github_get_a_deployment_status(repo: string, owner: string, status_id: integer, deployment_id: integer) — Retrieves a specific deployment status by its id for a given deployment within a github repository.
- github_get_a_diff_of_the_dependencies_between_commits(name?: string, repo: string, owner: string, basehead: string) — 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.
- github_get_a_discussion(org: string, team_slug: string, discussion_number: integer) — Fetches a specific discussion by its number from a team within an organization.
- github_get_a_discussion_comment(org: string, team_slug: string, comment_number: integer, discussion_number: integer) — Fetches a specific comment from a team discussion within a specific organization.
- github_get_a_dns_health_check_for_github_pages(repo: string, owner: string) — 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.
- github_get_a_gist(gist_id: string) — Fetches a specific github gist by its `gist id`, returning comprehensive details if the gist exists.
- github_get_a_gist_comment(gist_id: string, comment_id: integer) — Retrieves a specific gist comment by its id and the gist's id.
- github_get_a_gist_revision(sha: string, gist_id: string) — Retrieves a specific revision of a gist.
- github_get_a_github_pages_site(repo: string, owner: string) — Retrieves information for a github pages site, which must be enabled for the repository.
- github_get_a_gitignore_template(name: string) — Retrieves a specific .gitignore template from github by its name, which must be an existing template in github's collection.
- github_get_a_job_for_a_workflow_run(repo: string, owner: string, job_id: integer) — 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.
- github_get_a_label(name: string, repo: string, owner: string) — Retrieves a specific label by its name from a specified github repository.
- github_get_a_license(license: string) — Call this action to retrieve comprehensive details for a specific software license recognized by github, using its unique license key.
- github_get_a_milestone(repo: string, owner: string, milestone_number: integer) — Retrieves detailed information for a specific milestone within a github repository by its number.
- github_get_a_package_for_a_user(username: string, package_name: string, package_type: string) — Retrieves metadata for a specific package owned by a github user, using package type, name, and username as identifiers.
- github_get_a_package_for_an_organization(org: string, package_name: string, package_type: string) — Retrieves a specific package (by type and name) from an organization, if both the package and organization exist.
- github_get_a_package_for_the_authenticated_user(package_name: string, package_type: string) — Retrieves detailed information for a specific package owned by the authenticated user.
- github_get_a_package_version_for_a_user(username: string, package_name: string, package_type: string, package_version_id: integer) — Retrieves a specific public package version associated with a github user.
- github_get_a_package_version_for_an_organization(org: string, package_name: string, package_type: string, package_version_id: integer) — Retrieves detailed information for a specific version of a package within an organization.
- github_get_a_package_version_for_the_authenticated_user(package_name: string, package_type: string, package_version_id: integer) — Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version id.
- github_get_a_project(project_id: integer) — Retrieves detailed information for a specific github project using its unique `project id`.
- github_get_a_project_card(card_id: integer) — Retrieves all details of a specific project card, given its unique `card id`.
- github_get_a_project_column(column_id: integer) — Retrieves detailed information for a specific project column; the column must exist.
- github_get_a_pull_request(repo: string, owner: string, pull_number: integer) — Retrieves a specific pull request from a github repository using its owner, repository name, and pull request number.
- github_get_a_reference(ref: string, repo: string, owner: string) — Retrieves a specific git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a github repository.
- github_get_a_release(repo: string, owner: string, release_id: integer) — Gets a specific release from a github repository, provided the repository is accessible and the release exists.
- github_get_a_release_asset(repo: string, owner: string, asset_id: integer) — Gets metadata for a specific release asset in a github repository, including a `browser download url` for downloading the asset.
- github_get_a_release_by_tag_name(tag: string, repo: string, owner: string) — Gets a release from a github repository by its tag name; the repository and a release with this tag must already exist.
- github_get_a_repository(repo: string, owner: string) — Retrieves detailed information about an existing and accessible github repository.
- github_get_a_repository_public_key(repo: string, owner: string) — Gets a repository's public key for encrypting secrets to be used in github actions, if the repository exists and is accessible.
- github_get_a_repository_readme(ref?: string, repo: string, owner: string) — Fetches the readme file (if it exists and is accessible) from a specified github repository, returning its base64-encoded content and metadata.
- github_get_a_repository_readme_for_a_directory(dir: string, ref?: string, repo: string, owner: string) — Retrieves the readme file from a specified directory within a github repository, optionally at a given commit, branch, or tag.
- github_get_a_repository_rule_suite(repo: string, owner: string, rule_suite_id: integer) — Gets detailed information for a specific repository rule suite by its id, including its evaluation status and the results of its individual rules.
- github_get_a_repository_ruleset(repo: string, owner: string, ruleset_id: integer, includes_parents?: boolean) — 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.
- github_get_a_repository_secret(repo: string, owner: string, secret_name: string) — Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.
- github_get_a_repository_subscription(repo: string, owner: string) — Gets the authenticated user's subscription details for a repository, indicating if they receive notifications.
- github_get_a_repository_variable(name: string, repo: string, owner: string) — Gets a specific github actions variable by name from an accessible repository.
- github_get_a_repository_webhook(repo: string, owner: string, hook_id: integer) — Returns the configuration of an existing webhook for a given repository.
- github_get_a_review_comment_for_a_pull_request(repo: string, owner: string, comment_id: integer) — Retrieves a specific pull request review comment by its id, provided the repository exists, is accessible, and the comment id is valid.
- github_get_a_review_for_a_pull_request(repo: string, owner: string, review_id: integer, pull_number: integer) — Retrieves a specific review for a pull request using its owner, repository, pull request number, and review id.
- github_get_a_secret_for_the_authenticated_user(secret_name: string) — Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's github codespaces.
- github_get_a_self_hosted_runner_for_a_repository(repo: string, owner: string, runner_id: integer) — Gets a specific self-hosted runner for a repository by its unique id.
- github_get_a_self_hosted_runner_for_an_organization(org: string, runner_id: integer) — Retrieves detailed information about a specific self-hosted runner registered within a github organization.
- github_get_a_tag(repo: string, owner: string, tag_sha: string) — Retrieves detailed information for a specific git tag object from a github repository, using the sha of the tag object itself.
- github_get_a_team_by_name(org: string, team_slug: string) — Retrieves a github team by its slug from a specific organization.
- github_get_a_thread(thread_id: integer) — Retrieves a specific github notification thread using its unique `thread id`.
- github_get_a_thread_subscription_for_the_authenticated_user(thread_id: integer) — Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread id`.
- github_get_a_tree(repo: string, owner: string, tree_sha: string, recursive?: string) — Retrieves a git tree (directory listing) from a github repository using its sha, branch name, or tag name, optionally fetching all nested items recursively.
- github_get_a_user(username: string) — Retrieves the public profile information for an existing github user, specified by their username.
- github_get_a_webhook_configuration_for_a_repository(repo: string, owner: string, hook_id: integer) — Returns the configuration for an existing webhook on the specified repository.
- github_get_a_webhook_configuration_for_an_organization(org: string, hook_id: integer) — Retrieves the configuration for a specific webhook associated with a github organization.
- github_get_a_webhook_delivery_for_an_organization_webhook(org: string, hook_id: integer, delivery_id: integer) — Returns detailed information for a specific delivery attempt of a webhook configured for the specified github organization.
- github_get_a_workflow(repo: string, owner: string, workflow_id?: integer, workflow_name?: string) — Retrieves detailed information for a specific github actions workflow in a repository, identified by either its numeric id or its filename.
- github_get_a_workflow_run(repo: string, owner: string, run_id: integer, exclude_pull_requests?: boolean) — Gets a specific workflow run by its id from a github repository.
- github_get_a_workflow_run_attempt(repo: string, owner: string, run_id: integer, attempt_number: integer, exclude_pull_requests?: boolean) — Retrieves detailed information for a specific attempt of a workflow run in a github repository, including its status, conclusion, and timings.
- github_get_access_restrictions(repo: string, owner: string, branch: string) — 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.
- github_get_admin_branch_protection(repo: string, owner: string, branch: string) — Checks if repository administrators are subject to the branch protection rules on a specific branch.
- github_get_all_api_versions() — Retrieves all officially supported, date-based (e.g., "2022-11-28") versions of the github rest api from the /versions endpoint.
- github_get_all_autolinks_of_a_repository(repo: string, owner: string) — Retrieves all autolinks (e.g., for jira issues) configured for a repository; requires admin permissions on the repository.
- github_get_all_codes_of_conduct() — Retrieves all available codes of conduct from github, often used to select one for a repository.
- github_get_all_commonly_used_licenses(page?: integer, featured?: boolean, per_page?: integer) — Retrieves a list of commonly used software licenses from github, optionally filtering for 'featured' licenses whose specific selection criteria by github may vary.
- github_get_all_contributor_commit_activity(repo: string, owner: string) — 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.
- github_get_all_custom_properties_for_an_organization(org: string) — Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories.
- github_get_all_custom_property_values_for_a_repository(repo: string, owner: string) — Gets all custom property values for a repository, which may include default values or be empty if no properties are explicitly set.
- github_get_all_deployment_protection_rules_for_an_environment(repo: string, owner: string, environment_name: string) — Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.
- github_get_all_gitignore_templates() — Retrieves all available .gitignore template names from github (e.g., 'python', 'node', 'java'), used for generating .gitignore files.
- github_get_all_organization_roles_for_an_organization(org: string) — Lists all custom organization roles for an existing github organization.
- github_get_all_repository_rulesets(page?: integer, repo: string, owner: string, per_page?: integer, includes_parents?: boolean) — Retrieves all rulesets for a github repository, which define conditions and actions for repository interactions (e.g., branch protections).
- github_get_all_repository_topics(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves all topics for a specified, existing, and accessible repository.
- github_get_all_requested_reviewers_for_a_pull_request(repo: string, owner: string, pull_number: integer) — Gets all users and teams requested to review a specific pull request in a repository.
- github_get_all_status_check_contexts(repo: string, owner: string, branch: string) — Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks.
- github_get_an_app(app_slug: string) — Retrieves publicly available information for an existing github app, identified by its unique url-friendly `app slug`.
- github_get_an_artifact(repo: string, owner: string, artifact_id: integer) — Gets a specific artifact for a repository by `artifact id`.
- github_get_an_assignment(assignment_id: integer) — Retrieves detailed information for a specific github classroom assignment if the authenticated user is an administrator of the classroom.
- github_get_an_autolink_reference_of_a_repository(repo: string, owner: string, autolink_id: integer) — 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 repositor
- github_get_an_environment(repo: string, owner: string, environment_name: string) — Get an environment
- github_get_an_environment_public_key(repo: string, owner: string, environment_name: string) — Retrieves the public key for a specified github repository environment, used to encrypt secrets for github actions.
- github_get_an_environment_secret(repo: string, owner: string, secret_name: string, environment_name: string) — Get an environment secret
- github_get_an_environment_variable(name: string, repo: string, owner: string, environment_name: string) — Get an environment variable
- github_get_an_issue(repo: string, owner: string, issue_number: integer) — Get an issue
- github_get_an_issue_comment(repo: string, owner: string, comment_id: integer) — Get an issue comment
- github_get_an_issue_event(repo: string, owner: string, event_id: integer) — Get an issue event
- github_get_an_organization(org: string) — Get an organization
- github_get_an_organization_public_key(org: string) — Get an organization public key
- github_get_an_organization_role(org: string, role_id: integer) — Retrieves a specific github organization role by its id.
- github_get_an_organization_secret(org: string, secret_name: string) — Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value.
- github_get_an_organization_variable(org: string, name: string) — Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing github organization.
- github_get_an_organization_webhook(org: string, hook_id: integer) — Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook.
- github_get_apps_with_access_to_the_protected_branch(repo: string, owner: string, branch: string) — Lists github apps with push access to a repository's protected branch.
- github_get_assignment_grades(assignment_id: integer) — Retrieves all grades for an existing github classroom assignment.
- github_get_branch_protection(repo: string, owner: string, branch: string) — Retrieves branch protection settings for a specific, existing, and accessible branch in a github repository; protection feature availability varies by github product plan.
- github_get_commit_authors(repo: string, owner: string, since?: integer) — Fetches commit authors identified during a repository import, used to map authors from an external vcs to github accounts.
- github_get_commit_signature_protection(repo: string, owner: string, branch: string) — Gets the commit signature protection status for a branch in a repository.
- github_get_community_profile_metrics(repo: string, owner: string) — Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., readme, license).
- github_get_contextual_information_for_a_user(username: string, subject_id?: string, subject_type?: string) — Gets contextual hovercard information for a github user; `subject type` and `subject id` can be jointly provided for more specific details.
- github_get_default_attributes_for_a_codespace(ref?: string, repo: string, owner: string, client_ip?: string) — 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.
- github_get_default_workflow_permissions_for_a_repository(repo: string, owner: string) — 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.
- github_get_default_workflow_permissions_for_an_organization(org: string) — Gets the default github token workflow permissions and settings for a github organization.
- github_get_details_about_a_codespace_export(export_id: string, codespace_name: string) — Retrieves detailed information about a specific export of a codespace.
- github_get_emojis() — Lists all emojis available for use on github, including custom and unicode emojis.
- github_get_feeds() — Fetches a list of available github feed urls for the authenticated user.
- github_get_github_actions_cache_usage_for_a_repository(repo: string, owner: string) — Retrieves the total count of active github actions caches and their combined size in bytes for a specified repository.
- github_get_github_actions_cache_usage_for_an_organization(org: string) — Retrieves total github actions cache usage statistics for an organization, including active cache count and size across all repositories.
- github_get_github_actions_permissions_for_a_repository(repo: string, owner: string) — Gets the github actions permissions policy for a repository, including its enabled status and the scope of allowed actions.
- github_get_github_actions_permissions_for_an_organization(org: string) — Gets the github actions permissions for a specified organization, detailing repository enablement and allowed actions policies.
- github_get_github_meta_information() — Fetches github's publicly available metadata, useful for configuring network security policies or ip allow-listing.
- github_get_github_pages_build(repo: string, owner: string, build_id: integer) — Retrieves detailed information about a specific github pages build for a repository, which must have github pages enabled.
- github_get_information_about_a_sarif_upload(repo: string, owner: string, sarif_id: string) — 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 sar
- github_get_interaction_restrictions_for_a_repository(repo: string, owner: string) — 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.
- github_get_interaction_restrictions_for_an_organization(org: string) — 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 restrict
- github_get_interaction_restrictions_for_your_public_repositories() — Retrieves currently active interaction restrictions for the authenticated user's public repositories.
- github_get_large_files(repo: string, owner: string) — Lists files larger than 100mb identified during a previous source import for the specified repository; this endpoint is deprecated and will be removed on april 12, 2024.
- github_get_latest_pages_build(repo: string, owner: string) — 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.
- github_get_octocat(s?: string) — Fetches an ascii art representation of github's octocat, suitable for text-based displays.
- github_get_org_allowed_actions(org: string) — Retrieves the github actions permissions policy, including allowed actions and reusable workflows, for a specified organization.
- github_get_org_dev_environment_secret_safely(org: string, secret_name: string) — Retrieves metadata for a specific secret available to an organization's github codespaces without exposing its encrypted value.
- github_get_page_views(per?: string, repo: string, owner: string) — Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown.
- github_get_pending_deployments_for_a_workflow_run(repo: string, owner: string, run_id: integer) — Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.
- github_get_project_permission_for_a_user(username: string, project_id: integer) — Retrieves a collaborator's permission level (admin, write, read, or none) for an existing github project.
- github_get_public_key_for_secret_encryption(repo: string, owner: string) — Retrieves a repository's public key for encrypting github codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories.
- github_get_public_key_for_the_authenticated_user() — Retrieves the authenticated user's public github key, used to encrypt secrets for github codespaces.
- github_get_pull_request_review_protection(repo: string, owner: string, branch: string) — Retrieves the pull request review protection settings for a specific branch in a github repository, if such protection is configured.
- github_get_rate_limit_status_for_the_authenticated_user() — Retrieves the authenticated user's current github api rate limit status, including usage and limits across different resource categories.
- github_get_repo_dev_env_secret(repo: string, owner: string, secret_name: string) — Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (codespaces secret) in a repository, without exposing its value.
- github_get_repository_clones(per?: string, repo: string, owner: string) — Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days.
- github_get_repository_content(ref?: string, path: string, repo: string, owner: string) — Retrieves a file's base64 encoded content or a directory's metadata (but not a listing of its contents) from a github repository path.
- github_get_repository_permissions_for_a_user(repo: string, owner: string, username: string) — 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'.
- github_get_repository_secret_securely(repo: string, owner: string, secret_name: string) — Retrieves metadata for an existing dependabot secret in a repository, without exposing its encrypted value.
- github_get_rules_for_a_branch(page?: integer, repo: string, owner: string, branch: string, per_page?: integer) — Retrieves all active rules for a specific branch in a github repository, excluding rules in 'evaluate' or 'disabled' status.
- github_get_single_org_secret_without_decryption(org: string, secret_name: string) — Retrieves metadata (e.g., name, creation/update timestamps, visibility) for an organization's dependabot secret, without its encrypted value.
- github_get_status_checks_protection(repo: string, owner: string, branch: string) — Retrieves the status check protection settings for a specific branch in a github repository, if status check protection is enabled for it.
- github_get_team_membership_for_a_user(org: string, username: string, team_slug: string) — Retrieves a user's role and membership status within a specific team in an organization.
- github_get_teams_with_access_to_the_protected_branch(repo: string, owner: string, branch: string) — 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.
- github_get_the_authenticated_user() — Gets the profile information for the currently authenticated github user, including potentially private details based on user settings.
- github_get_the_combined_status_for_a_specific_reference(ref: string, page?: integer, repo: string, owner: string, per_page?: integer) — 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.
- github_get_the_hourly_commit_count_for_each_day(repo: string, owner: string) — Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository.
- github_get_the_last_year_of_commit_activity(repo: string, owner: string) — Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified github repository.
- github_get_the_latest_release(repo: string, owner: string) — Fetches the latest official (non-prerelease, non-draft) release for a github repository; requires at least one such published release.
- github_get_the_license_for_a_repository(ref?: string, repo: string, owner: string) — Retrieves the license file and its details for a repository, optionally from a specific git reference (branch, tag, or commit sha).
- github_get_the_review_history_for_a_workflow_run(repo: string, owner: string, run_id: integer) — 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 workfl
- github_get_the_status_of_a_github_pages_deployment(repo: string, owner: string, pages_deployment_id: integer) — Retrieves the status of a specific github pages deployment for a repository, which must have github pages enabled.
- github_get_the_weekly_commit_activity(repo: string, owner: string) — 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.
- github_get_the_weekly_commit_count(repo: string, owner: string) — 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 be
- github_get_the_zen_of_github() — 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
- github_get_top_referral_paths(repo: string, owner: string) — Fetches the top 10 most viewed content paths for a repository from the last 14 days.
- github_get_top_referral_sources(repo: string, owner: string) — Fetches the top 10 websites that referred traffic to a repository within the last 14 days.
- github_get_users_with_access_to_the_protected_branch(repo: string, owner: string, branch: string) — Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users.
- github_get_workflow_external_access(repo: string, owner: string) — Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.
- github_get_workflow_run_usage(repo: string, owner: string, run_id: integer) — Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems.
- github_get_workflow_usage(repo: string, owner: string, workflow_id: integer) — Gets the billable time (in milliseconds, broken down by runner os) for a specific workflow within a repository for the current billing cycle.
- github_gist_s_create(files: object, public?: boolean, description?: string) — Deprecated: use `create a gist` instead. creates a new github gist with specified files, content, an optional description, and public visibility.
- github_gist_s_list_public(page?: integer, since?: string, per_page?: integer) — (deprecated: use `list public gists` instead) lists public gists from github, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.
- github_github_api_root() — Retrieves a map of all top-level github rest api resource urls and their templates.
- github_github_get_repo_allowed_actions(repo: string, owner: string) — Gets the settings for allowed actions and reusable workflows that can be run in the specified repository.
- github_github_set_repo_runner_labels(repo: string, owner: string, labels: string[], runner_id: integer) — Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels.
- github_issues_create(body?: string, repo: string, owner: string, title: string, labels?: string[], assignee?: string, assignees?: string[], milestone?: string) — (deprecated: use `create an issue` instead) creates a new issue in a github repository, provided issues are enabled and the user has sufficient permissions.
- github_issues_create_comment(body: string, repo: string, owner: string, issue_number: integer) — Deprecated: use `create an issue comment` to create a comment on an existing github issue or pull request.
- github_issues_get(repo: string, owner: string, issue_number: integer) — Deprecated: use the `get an issue` action instead to retrieve details for a specific issue in a repository.
- github_issues_list_assign_ees(page?: integer, repo: string, owner: string, per_page?: integer) — Deprecated: use `list assignees`. lists users who can be assigned to issues in a repository, typically those with push access.
- github_issues_list_events_for_repo(page?: integer, repo: string, owner: string, per_page?: integer) — Lists all issue events for a specified repository. <<deprecated: this action is deprecated. use `list issue events for a repository` instead.>>
- github_issues_list_for_repo(page?: integer, repo: string, sort?: string, owner: string, since?: string, state?: string, labels?: string, creator?: string, assignee?: string, per_page?: integer, direction?: string, mentioned?: string, milestone?: string) — Lists all issues (including pull requests) in a github repository; deprecated: use list repository issues.
- github_list_accepted_assignments_for_an_assignment(page?: integer, per_page?: integer, assignment_id: integer) — Lists accepted assignments (student repositories created after acceptance) for an existing github classroom assignment, identified by its unique `assignment id`.
- github_list_app_installations_accessible_to_the_user_access_token(page?: integer, per_page?: integer) — Lists github app installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access.
- github_list_artifacts_for_a_repository(name?: string, page?: integer, repo: string, owner: string, per_page?: integer) — Lists github actions workflow artifacts for a specified repository, which must exist.
- github_list_assigned_issues(page?: integer, sort?: string, since?: string, state?: string, filter?: string, labels?: string, per_page?: integer, direction?: string) — Lists github issues for the authenticated user, defaulting to 'assigned' but filterable by other interactions, state, labels, and time, with sorting and pagination.
- github_list_assignees(page?: integer, repo: string, owner: string, per_page?: integer) — Lists users who can be assigned to issues in a repository, typically those with push access.
- github_list_assignments_for_a_classroom(page?: integer, per_page?: integer, classroom_id: integer) — Lists all assignments for a given github classroom `classroom id`; the classroom must exist and be accessible.
- github_list_available_machine_types_for_a_repository(ref?: string, repo: string, owner: string, location?: string, client_ip?: string) — 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.
- github_list_branches(page?: integer, repo: string, owner: string, per_page?: integer, protected?: boolean) — Lists branches for an existing github repository, with an option to filter by protection status.
- github_list_branches_for_head_commit(repo: string, owner: string, commit_sha: string) — Lists branches in an accessible repository where the provided commit sha is the head, useful for identifying development lines based on that commit.
- github_list_check_run_annotations(page?: integer, repo: string, owner: string, per_page?: integer, check_run_id: integer) — Lists annotations for a specific check run in a github repository, detailing issues like errors or warnings on particular code lines.
- github_list_check_runs_for_a_git_reference(ref: string, page?: integer, repo: string, owner: string, app_id?: integer, filter?: string, status?: string, per_page?: integer, check_name?: string) — Lists check runs for a given git reference within a repository; ensure the reference exists and the repository is accessible.
- github_list_check_runs_in_a_check_suite(page?: integer, repo: string, owner: string, filter?: string, status?: string, per_page?: integer, check_name?: string, check_suite_id: integer) — Lists check runs for a specific check suite in a github repository, optionally filtering by check name or status.
- github_list_check_suites_for_a_git_reference(ref: string, page?: integer, repo: string, owner: string, app_id?: integer, per_page?: integer, check_name?: string) — 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.
- github_list_child_teams(org: string, page?: integer, per_page?: integer, team_slug: string) — Lists the immediate child teams of a parent team within an organization.
- github_list_classrooms(page?: integer, per_page?: integer) — Lists github classrooms to which the authenticated user has administrative access.
- github_list_code_ql_databases_for_a_repository(repo: string, owner: string) — Lists all codeql databases for a repository where codeql analysis has been previously run and completed.
- github_list_code_scanning_alerts_for_a_repository(ref?: string, page?: integer, repo: string, sort?: string, owner: string, state?: string, per_page?: integer, severity?: string, direction?: string, tool_guid?: string, tool_name?: string) — 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.
- github_list_code_scanning_alerts_for_an_organization(org: string, page?: integer, sort?: string, after?: string, state?: string, before?: string, per_page?: integer, severity?: string, direction?: string, tool_guid?: string, tool_name?: string) — Lists code scanning alerts for a github organization; use either `tool name` or `tool guid` if filtering by tool, not both.
- github_list_code_scanning_analyses_for_a_repository(ref?: string, page?: integer, repo: string, sort?: string, owner: string, per_page?: integer, sarif_id?: string, direction?: string, tool_guid?: string, tool_name?: string) — Lists code scanning analyses for an existing repository, optionally filtering by tool (name or guid), git reference, or sarif id.
- github_list_codeowners_errors(ref?: string, repo: string, owner: string) — Lists syntax errors in a repository's codeowners file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref.
- github_list_codespaces_for_a_user_in_organization(org: string, page?: integer, per_page?: integer, username: string) — Lists all github codespaces owned by a specified member of a given organization.
- github_list_codespaces_for_the_authenticated_user(page?: integer, per_page?: integer, repository_id?: integer) — Lists github codespaces for the authenticated user, optionally filtering by repository id and supporting pagination.
- github_list_codespaces_for_the_organization(org: string, page?: integer, per_page?: integer) — Lists active/pending github codespaces for an existing organization; admins list all, members list their own.
- github_list_comments_for_a_pull_request_review(page?: integer, repo: string, owner: string, per_page?: integer, review_id: integer, pull_number: integer) — Lists all comments for a specific review on a github pull request.
- github_list_commit_comments(page?: integer, repo: string, owner: string, per_page?: integer, commit_sha: string) — Retrieves all comments for a specific commit in a github repository, supporting pagination.
- github_list_commit_comments_for_a_repository(page?: integer, repo: string, owner: string, per_page?: integer) — Lists all commit comments for a specified repository, which must exist and be accessible.
- github_list_commit_statuses_for_a_reference(ref: string, page?: integer, repo: string, owner: string, per_page?: integer) — Lists commit statuses for a specific reference (commit sha, branch, or tag) in a repository, useful for tracking ci/test outcomes.
- github_list_commits(sha?: string, page?: integer, path?: string, repo: string, owner: string, since?: string, until?: string, author?: string, per_page?: integer, committer?: string) — Retrieves commits for a repository, optionally filtering by sha (must be valid commit sha or existing branch), path, author, committer, or date range.
- github_list_commits_on_a_pull_request(page?: integer, repo: string, owner: string, per_page?: integer, pull_number: integer) — Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.
- github_list_custom_property_values_for_organization_repositories(org: string, page?: integer, per_page?: integer, repository_query?: string) — Lists custom property values for repositories in a specified, existing organization, optionally filtered by a repository query.
- github_list_deliveries_for_a_repository_webhook(repo: string, owner: string, cursor?: string, hook_id: integer, per_page?: integer, redelivery?: boolean) — Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook id exists.
- github_list_deliveries_for_an_organization_webhook(org: string, cursor?: string, hook_id: integer, per_page?: integer, redelivery?: boolean) — Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details.
- github_list_deploy_keys(page?: integer, repo: string, owner: string, per_page?: integer) — Lists deploy ssh keys for a specified repository; the repository must exist.
- github_list_deployment_branch_policies(page?: integer, repo: string, owner: string, per_page?: integer, environment_name: string) — Lists all deployment branch policies for a specified environment in a github repository.
- github_list_deployment_statuses(page?: integer, repo: string, owner: string, per_page?: integer, deployment_id: integer) — Lists all statuses for a given deployment in a repository.
- github_list_deployments(ref?: string, sha?: string, page?: integer, repo: string, task?: string, owner: string, per_page?: integer, environment?: string) — Lists deployments for a specified repository; repository must exist.
- github_list_discussion_comments(org: string, page?: integer, per_page?: integer, direction?: string, team_slug: string, discussion_number: integer) — Lists all comments for a specific team discussion within an organization.
- github_list_discussions(org: string, page?: integer, pinned?: string, per_page?: integer, direction?: string, team_slug: string) — Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status.
- github_list_email_addresses_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility.
- github_list_environment_custom_deployment_rules(page?: integer, repo: string, owner: string, per_page?: integer, environment_name: string) — Lists all custom deployment protection rule integrations for a repository environment; the `environment name` must be url-encoded.
- github_list_environment_secrets(page?: integer, repo: string, owner: string, per_page?: integer, environment_name: string) — Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing github repository.
- github_list_environment_variables(page?: integer, repo: string, owner: string, per_page?: integer, environment_name: string) — Lists all environment variables, which are plaintext key-value pairs for github actions workflows, for a specified environment within a github repository.
- github_list_environments(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.
- github_list_events_for_the_authenticated_user(page?: integer, per_page?: integer, username: string) — Lists public events for the specified github user, or private events if authenticated as that user, in reverse chronological order.
- github_list_events_received_by_the_authenticated_user(page?: integer, per_page?: integer, username: string) — Lists events a specific github user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public.
- github_list_followers_of_a_user(page?: integer, per_page?: integer, username: string) — Lists followers for a specified, existing github user.
- github_list_followers_of_the_authenticated_user(page?: integer, per_page?: integer) — Lists users following the authenticated github user, returning an empty list if the user has no followers.
- github_list_forks(page?: integer, repo: string, sort?: string, owner: string, per_page?: integer) — Lists forks for a specified repository, which must exist, with options for sorting and pagination.
- github_list_gist_comments(page?: integer, gist_id: string, per_page?: integer) — Lists comments for a specified github gist.
- github_list_gist_commits(page?: integer, gist_id: string, per_page?: integer) — Lists all commits for a specified gist.
- github_list_gist_forks(page?: integer, gist_id: string, per_page?: integer) — Lists all forks for a given github gist id.
- github_list_gists_for_a_user(page?: integer, since?: string, per_page?: integer, username: string) — Lists public gists for a specified github user.
- github_list_gists_for_the_authenticated_user(page?: integer, since?: string, per_page?: integer) — Lists gists for the authenticated user, with optional filtering by update time and pagination.
- github_list_github_actions_caches_for_a_repository(key?: string, ref?: string, page?: integer, repo: string, sort?: string, owner: string, per_page?: integer, direction?: string) — Lists github actions caches for a repository, with options to filter by git reference or cache key, and to sort and paginate results.
- github_list_github_pages_builds(page?: integer, repo: string, owner: string, per_page?: integer) — Lists github pages builds for a repository; github pages must be enabled on the repository for builds to be listed.
- github_list_global_security_advisories(cwes?: string[], sort?: string, type?: string, after?: string, before?: string, cve_id?: string, affects?: string[], ghsa_id?: string, updated?: string, modified?: string, per_page?: integer, severity?: string, direction?: string, ecosystem?: string, published?: string, is_withdrawn?: boolean) — Lists github's global security advisories, filterable by various attributes including id, type, ecosystem, severity, and dates.
- github_list_installation_requests_for_the_authenticated_app(page?: integer, per_page?: integer) — Lists pending installation requests made by users or organizations for the authenticated github app.
- github_list_instances_of_a_code_scanning_alert(ref?: string, page?: integer, repo: string, owner: string, per_page?: integer, alert_number: integer) — Lists all instances of a specific code scanning alert, optionally filtered by git ref; requires code scanning to be enabled on the repository.
- github_list_issue_comments(page?: integer, repo: string, owner: string, since?: string, per_page?: integer, issue_number: integer) — Lists comments for a specified issue in a github repository.
- github_list_issue_comments_for_a_repository(page?: integer, repo: string, sort?: string, owner: string, since?: string, per_page?: integer, direction?: string) — Lists issue comments, including those on pull requests, for an accessible repository.
- github_list_issue_events(page?: integer, repo: string, owner: string, per_page?: integer, issue_number: integer) — Retrieves a list of all events for a specific issue within a github repository.
- github_list_issue_events_for_a_repository(page?: integer, repo: string, owner: string, per_page?: integer) — Lists all issue events (e.g., closed, reopened, assigned) for a specified repository.
- github_list_issues_assigned_to_the_authenticated_user(orgs?: boolean, page?: integer, sort?: string, owned?: boolean, pulls?: boolean, since?: string, state?: string, collab?: boolean, filter?: string, labels?: string, per_page?: integer, direction?: string) — Lists github issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an iso 8601 `since` timestamp (yyyy-mm-ddthh:mm:ssz), and sorting option
- github_list_jobs_for_a_workflow_run(page?: integer, repo: string, owner: string, filter?: string, run_id: integer, per_page?: integer) — Lists jobs for a specific workflow run in a github repository.
- github_list_jobs_for_a_workflow_run_attempt(page?: integer, repo: string, owner: string, run_id: integer, per_page?: integer, attempt_number: integer) — Lists jobs, including details like id, status, and steps, for a specific attempt of a github actions workflow run.
- github_list_labels_for_a_repository(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves all labels for a specified, existing github repository.
- github_list_labels_for_a_self_hosted_runner_for_a_repository(repo: string, owner: string, runner_id: integer) — Lists all labels assigned to a specific self-hosted runner registered with the given repository.
- github_list_labels_for_a_self_hosted_runner_for_an_organization(org: string, runner_id: integer) — Lists all labels assigned to a specific self-hosted runner within a github organization, which are used to route workflows.
- github_list_labels_for_an_issue(page?: integer, repo: string, owner: string, per_page?: integer, issue_number: integer) — Lists all labels for a specified issue in a github repository.
- github_list_labels_for_issues_in_a_milestone(page?: integer, repo: string, owner: string, per_page?: integer, milestone_number: integer) — Lists all labels for issues within a specific milestone in a repository.
- github_list_machine_types_for_a_codespace(codespace_name: string) — Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration.
- github_list_matching_references(ref: string, repo: string, owner: string) — Lists all git references (branches or tags) in a repository that start with the provided partial reference path (e.g., `heads/my-feature` or `tags/v1.2`).
- github_list_milestones(page?: integer, repo: string, sort?: string, owner: string, state?: string, per_page?: integer, direction?: string) — Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting.
- github_list_notifications_for_the_authenticated_user(all?: boolean, page?: integer, since?: string, before?: string, per_page?: integer, participating?: boolean) — Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options.
- github_list_org_fine_grained_permissions(org: string) — Retrieves all fine-grained permissions for a specified github organization, essential for creating or updating custom roles.
- github_list_org_issues_for_user(org: string, page?: integer, sort?: string, since?: string, state?: string, filter?: string, labels?: string, per_page?: integer, direction?: string) — Lists issues for the authenticated user within a specified github organization, with options to filter by involvement type, state, labels, and to sort results.
- github_list_org_level_codespaces_secrets(org: string, page?: integer, per_page?: integer) — Lists all codespaces secrets available for a specified organization, which must exist.
- github_list_org_package_versions(org: string, page?: integer, state?: string, per_page?: integer, package_name: string, package_type: string) — Lists all versions for a specified package, if it exists and is owned by the given github organization.
- github_list_org_repos_withgithub_actions_enabled(org: string, page?: integer, per_page?: integer) — Lists repositories in an organization with github actions enabled, for use when the organization's policy restricts actions to a specific list of repositories rather than enabling it for all.
- github_list_org_resource_access_tokens(org: string, page?: integer, sort?: string, owner?: string[], per_page?: integer, direction?: string, permission?: string, repository?: string, last_used_after?: string, last_used_before?: string) — Lists approved fine-grained personal access tokens (pats) with access to resources in a github organization, optionally filtering by owner, repository, permissions, or last usage time.
- github_list_org_resources_with_personal_tokens(org: string, page?: integer, sort?: string, owner?: string[], per_page?: integer, direction?: string, permission?: string, repository?: string, last_used_after?: string, last_used_before?: string) — Retrieves a list of an organization's fine-grained personal access token requests (pending, approved, or denied), with options for filtering and sorting.
- github_list_org_secrets_without_values(org: string, page?: integer, per_page?: integer) — Lists all dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist.
- github_list_organization_events_for_the_authenticated_user(org: string, page?: integer, per_page?: integer, username: string) — Lists events within a specified organization that were performed by the authenticated user, whose `username` (path parameter) must match the api request credentials.
- github_list_organization_members(org: string, page?: integer, role?: string, filter?: string, per_page?: integer) — Lists public and concealed members of a github organization; viewing concealed members requires authenticated user to be an organization member.
- github_list_organization_projects(org: string, page?: integer, state?: string, per_page?: integer) — Lists projects for a specified github organization, optionally filtering by state and supporting pagination.
- github_list_organization_repositories(org: string, page?: integer, sort?: string, type?: string, per_page?: integer, direction?: string) — Retrieves a list of repositories for a specified github organization, allowing filtering by type and sorting.
- github_list_organization_secrets(org: string, page?: integer, per_page?: integer) — Lists github actions secrets available for a specified organization.
- github_list_organization_variables(org: string, page?: integer, per_page?: integer) — Lists all github actions variables for a specified organization.
- github_list_organization_webhooks(org: string, page?: integer, per_page?: integer) — Lists all webhooks for a specified github organization; the organization must exist.
- github_list_organizations(since?: integer, per_page?: integer) — Lists github organizations for the authenticated user, sorted by id in ascending order.
- github_list_organizations_for_a_user(page?: integer, per_page?: integer, username: string) — Lists public organizations for a specified github user; the `username` must be a valid github handle.
- github_list_organizations_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists organizations the authenticated github user is a member of, returning details for each organization.
- github_list_outside_collaborators_for_an_organization(org: string, page?: integer, filter?: string, per_page?: integer) — Lists outside collaborators for a github organization, with options to filter (e.g., by 2fa status) and paginate results.
- github_list_owned_package_versions(page?: integer, state?: string, per_page?: integer, package_name: string, package_type: string) — Lists all versions for an existing package owned by the authenticated user, identified by its type and name.
- github_list_package_versions_for_a_package_owned_by_a_user(username: string, package_name: string, package_type: string) — Lists all versions of a public package owned by a specific github user, identified by package type, package name, and username.
- github_list_packages_for_a_user(page?: integer, per_page?: integer, username: string, visibility?: string, package_type: string) — Lists packages for a specified github user, filterable by package type and visibility.
- github_list_packages_for_an_organization(org: string, page?: integer, per_page?: integer, visibility?: string, package_type: string) — Lists github packages for an organization, noting specific interpretations for package type and visibility parameters.
- github_list_packages_for_the_authenticated_user_s_namespace(page?: integer, per_page?: integer, visibility?: string, package_type: string) — Lists packages of a specific type and visibility within the authenticated user's namespace on github.
- github_list_pending_team_invitations(org: string, page?: integer, per_page?: integer, team_slug: string) — Lists all pending membership invitations for a specified team within an organization.
- github_list_project_cards(page?: integer, per_page?: integer, column_id: integer, archived_state?: string) — Lists all project cards for a given `column id`, which must correspond to an existing project column.
- github_list_project_collaborators(page?: integer, per_page?: integer, project_id: integer, affiliation?: string) — Fetches a list of collaborators for a specified, existing github project.
- github_list_project_columns(page?: integer, per_page?: integer, project_id: integer) — Lists all of a github project's columns (e.g., 'to do', 'in progress'); project id must identify a valid, accessible project.
- github_list_public_email_addresses_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists the public email addresses for the authenticated user.
- github_list_public_events(page?: integer, per_page?: integer) — Lists public github events, which may be delayed by up to 5 minutes, with support for pagination.
- github_list_public_events_for_a_network_of_repositories(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves public events (up to 90 days old, newest first) for a github repository network, including the repository and its forks.
- github_list_public_events_for_a_user(page?: integer, per_page?: integer, username: string) — Retrieves a list of public events for a specified github user, in reverse chronological order.
- github_list_public_events_received_by_a_user(page?: integer, per_page?: integer, username: string) — Lists public events for a specified github user (e.g., activities in repositories they watch or are involved in); the target user's profile must be public, and if blocked by the authenticated user, a 
- github_list_public_gists(page?: integer, since?: string, per_page?: integer) — Lists public gists from github, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.
- github_list_public_keys_for_a_user(page?: integer, per_page?: integer, username: string) — Lists the verified public ssh keys for a specified github user.
- github_list_public_organization_events(org: string, page?: integer, per_page?: integer) — Lists public events for a specified github organization, which must exist.
- github_list_public_organization_members(org: string, page?: integer, per_page?: integer) — Lists users who have publicly declared their membership in a specified, existing github organization.
- github_list_public_repositories(since?: integer) — Lists all public repositories on github; use the `since` parameter with a repository id from a previous result for pagination.
- github_list_pull_requests(base?: string, head?: string, page?: integer, repo: string, sort?: string, owner: string, state?: string, per_page?: integer, direction?: string) — Lists pull requests for a specified github repository with ai-friendly filtering.
- github_list_pull_requests_associated_with_a_commit(page?: integer, repo: string, owner: string, per_page?: integer, commit_sha: string) — Lists pull requests for a commit; returns merged prs that introduced the commit if on the default branch, or open prs including the commit if on other branches.
- github_list_pull_requests_files(page?: integer, repo: string, owner: string, per_page?: integer, pull_number: integer) — Lists all files (including additions, modifications, and removals) associated with a specific pull request in a github repository.
- github_list_reactions_for_a_commit_comment(page?: integer, repo: string, owner: string, content?: string, per_page?: integer, comment_id: integer) — Lists reactions for a specific commit comment; this is a read-only operation.
- github_list_reactions_for_a_pull_request_review_comment(page?: integer, repo: string, owner: string, content?: string, per_page?: integer, comment_id: integer) — Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type.
- github_list_reactions_for_a_release(page?: integer, repo: string, owner: string, content?: string, per_page?: integer, release_id: integer) — Lists all reactions, or optionally filters reactions by a specific content type, for a given github release.
- github_list_reactions_for_a_team_discussion(org: string, page?: integer, content?: string, per_page?: integer, team_slug: string, discussion_number: integer) — Lists reactions for an existing team discussion within an organization.
- github_list_reactions_for_a_team_discussion_comment(org: string, page?: integer, content?: string, per_page?: integer, team_slug: string, comment_number: integer, discussion_number: integer) — Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type.
- github_list_reactions_for_an_issue(page?: integer, repo: string, owner: string, content?: string, per_page?: integer, issue_number: integer) — Lists reactions for a specific, existing issue within an accessible github repository, optionally filtering by content type.
- github_list_reactions_for_an_issue_comment(page?: integer, repo: string, owner: string, content?: string, per_page?: integer, comment_id: integer) — Lists reactions for a specific issue comment in a github repository, optionally filtering by content type.
- github_list_release_assets(page?: integer, repo: string, owner: string, per_page?: integer, release_id: integer) — Lists assets (e.g., compiled binaries, source code archives) for a specific github release, identified by `release id` which must be valid for an existing release in the repository.
- github_list_releases(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves a list of all releases (published, draft, and prerelease) for a specified repository.
- github_list_repo_access_by_token(org: string, page?: integer, per_page?: integer, pat_request_id: integer) — Lists repositories in an organization that a fine-grained personal access token (`pat request id`) has requested access to; must be performed by a github app.
- github_list_repo_codespaces(page?: integer, repo: string, owner: string, per_page?: integer) — Lists codespaces the authenticated user can access within a specified, existing repository.
- github_list_repo_dev_container_configs_for_user(page?: integer, repo: string, owner: string, per_page?: integer) — Lists the `devcontainer.json` configurations available in a specified repository for use with github codespaces.
- github_list_repo_secrets_without_values(page?: integer, repo: string, owner: string, per_page?: integer) — Lists all codespaces secrets available in a specific repository, without their encrypted values.
- github_list_repos_with_ghactions_cache_usage(org: string, page?: integer, per_page?: integer) — Retrieves a paginated list of github actions cache usage statistics for repositories within an existing github organization.
- github_list_repositories_accessible_to_the_app_installation(page?: integer, per_page?: integer) — Lists repositories an app installation can access; 'total count' in response is zero if none are accessible.
- github_list_repositories_accessible_to_the_user_access_token(page?: integer, per_page?: integer, installation_id: integer) — Lists repositories accessible to the authenticated user through a specific github app installation (identified by `installation id`).
- github_list_repositories_for_a_user(page?: integer, sort?: string, type?: string, per_page?: integer, username: string, direction?: string) — Lists public repositories for a specified github user, who must have an existing account.
- github_list_repositories_for_the_authenticated_user(page?: integer, sort?: string, type?: string, since?: string, before?: string, per_page?: integer, direction?: string, raw_response?: boolean) — Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' api parameters (not in this model) can cause a 422 error.
- github_list_repositories_starred_by_a_user(page?: integer, sort?: string, per_page?: integer, username: string, direction?: string) — Lists repositories a valid and existing github user has starred.
- github_list_repositories_starred_by_the_authenticated_user(page?: integer, sort?: string, per_page?: integer, direction?: string) — Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.github.star+json' media type.
- github_list_repositories_watched_by_a_user(page?: integer, per_page?: integer, username: string) — Lists repositories a given github user is watching; the username must be a valid and existing github user handle.
- github_list_repositories_watched_by_the_authenticated_user(page?: integer, per_page?: integer) — Lists repositories the authenticated user is watching (subscribed to for notifications).
- github_list_repository_activities(ref?: string, repo: string, actor?: string, after?: string, owner: string, before?: string, per_page?: integer, direction?: string, time_period?: string, activity_type?: string) — Lists activities for a github repository, ensuring the repository exists and is accessible.
- github_list_repository_collaborators(page?: integer, repo: string, owner: string, per_page?: integer, permission?: string, affiliation?: string) — Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user.
- github_list_repository_contributors(anon?: string, page?: integer, repo: string, owner: string, per_page?: integer) — Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible.
- github_list_repository_events(page?: integer, repo: string, owner: string, per_page?: integer) — Lists chronological events (e.g., code pushes, issue activities, pr actions, forks) for a specified, existing github repository.
- github_list_repository_invitations(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified github repository.
- github_list_repository_invitations_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists all pending repository invitations for the authenticated user.
- github_list_repository_issues(page?: integer, repo: string, sort?: string, owner: string, since?: string, state?: string, labels?: string, creator?: string, assignee?: string, per_page?: integer, direction?: string, mentioned?: string, milestone?: string) — Lists issues (which include pull requests) for a specified, existing github repository, with options for filtering, sorting, and pagination.
- github_list_repository_languages(repo: string, owner: string) — Lists the programming languages used in a github repository, returning a byte count for each language.
- github_list_repository_notifications_for_the_authenticated_user(all?: boolean, page?: integer, repo: string, owner: string, since?: string, before?: string, per_page?: integer, participating?: boolean) — Retrieves notifications for the authenticated user from a specified repository, to which the user must have access.
- github_list_repository_organization_secrets(page?: integer, repo: string, owner: string, per_page?: integer) — Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access.
- github_list_repository_organization_variables(page?: integer, repo: string, owner: string, per_page?: integer) — Lists organization variables accessible to a specific repository; the repository must exist.
- github_list_repository_projects(page?: integer, repo: string, owner: string, state?: string, per_page?: integer) — Lists projects associated with a specific repository.
- github_list_repository_rule_suites(ref?: string, page?: integer, repo: string, owner: string, per_page?: integer, actor_name?: string, time_period?: string, rule_suite_result?: string) — Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result.
- github_list_repository_secrets(page?: integer, repo: string, owner: string, per_page?: integer) — Lists metadata for all secrets in a github repository, excluding their encrypted values.
- github_list_repository_secrets_without_decrypting(page?: integer, repo: string, owner: string, per_page?: integer) — Lists metadata (e.g., name, creation/update dates) for all dependabot secrets in a repository; secret values are not included.
- github_list_repository_tags(page?: integer, repo: string, owner: string, per_page?: integer) — Lists tags for a specified github repository.
- github_list_repository_teams(page?: integer, repo: string, owner: string, per_page?: integer) — Lists all teams with explicit permission to access the specified repository; the repository must exist.
- github_list_repository_variables(page?: integer, repo: string, owner: string, per_page?: integer) — Lists plain text key-value variables for github actions workflows within a specific, accessible repository.
- github_list_repository_webhooks(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves a list of webhooks for a repository, which must exist and be accessible.
- github_list_repository_workflows(page?: integer, repo: string, owner: string, per_page?: integer) — Lists all github actions workflows for a specified repository, which must exist and be accessible.
- github_list_review_comments_in_a_repository(page?: integer, repo: string, sort?: string, owner: string, since?: string, per_page?: integer, direction?: string) — Lists all review comments on all pull requests within a specified repository.
- github_list_review_comments_on_a_pull_request(page?: integer, repo: string, sort?: string, owner: string, since?: string, per_page?: integer, direction?: string, pull_number: integer) — Lists all review comments on a specific pull request within a github repository.
- github_list_reviews_for_a_pull_request(page?: integer, repo: string, owner: string, per_page?: integer, pull_number: integer) — Lists submitted reviews chronologically for a specific pull request within a github repository.
- github_list_runner_applications_for_a_repository(repo: string, owner: string) — Lists available self-hosted runner application binaries for a specific repository, including their os, architecture, and download url.
- github_list_runner_applications_for_an_organization(org: string) — Lists downloadable github actions runner application binaries, used for setting up self-hosted runners, for an existing github organization.
- github_list_secrets_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists all codespaces secrets accessible to the authenticated user for use within github codespaces.
- github_list_selected_repos_for_secret_access(org: string, page?: integer, per_page?: integer, secret_name: string) — Lists repositories within a specified organization that have been granted access to a particular dependabot secret.
- github_list_selected_repositories_for_a_user_secret(secret_name: string) — Lists repositories that have access to the specified user secret for the authenticated user's codespaces, provided the user has codespaces access.
- github_list_selected_repositories_for_an_organization_secret(org: string, page?: integer, per_page?: integer, secret_name: string) — Lists repositories within an organization that have explicit access to a specific organization secret, which must have its visibility set to 'selected'.
- github_list_selected_repositories_for_an_organization_variable(org: string, name: string, page?: integer, per_page?: integer) — Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access.
- github_list_self_hosted_runners_for_a_repository(name?: string, page?: integer, repo: string, owner: string, per_page?: integer) — Lists all self-hosted runners configured for a repository.
- github_list_self_hosted_runners_for_an_organization(org: string, name?: string, page?: integer, per_page?: integer) — Lists self-hosted runners for a github organization, optionally filtering by name and paginating results, providing details for each runner such as os, status, and labels.
- github_list_social_accounts_for_a_user(page?: integer, per_page?: integer, username: string) — Lists social media accounts publicly linked to an existing github user's profile.
- github_list_social_accounts_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists all social media accounts linked to the authenticated user's github profile.
- github_list_stargazers(page?: integer, repo: string, owner: string, per_page?: integer) — Lists users who have starred the specified github repository, which must exist.
- github_list_starred_gists(page?: integer, since?: string, per_page?: integer) — Retrieves a list of gists starred by the authenticated user.
- github_list_subscriptions_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists the authenticated user's active github marketplace subscriptions.
- github_list_subscriptions_for_the_authenticated_user_stubbed(page?: integer, per_page?: integer) — Lists the authenticated user's stubbed (test/example data, not live) github marketplace subscriptions, useful for development or testing.
- github_list_tag_protection_states_for_a_repository(repo: string, owner: string) — Lists all active tag protection rules for a repository, defining patterns to prevent matching tags from being created or deleted; requires repository admin permissions.
- github_list_team_members(org: string, page?: integer, role?: string, per_page?: integer, team_slug: string) — Lists members of a specific team within an organization, including members of child teams.
- github_list_team_projects(org: string, page?: integer, per_page?: integer, team_slug: string) — Lists github projects accessible to a specific team within an organization.
- github_list_team_repositories(org: string, page?: integer, per_page?: integer, team_slug: string) — Lists repositories accessible to a specific team within a github organization.
- github_list_teams(org: string, page?: integer, per_page?: integer) — Lists teams for a specified github organization.
- github_list_teams_for_the_authenticated_user(page?: integer, per_page?: integer) — Lists all teams across all organizations to which the authenticated user belongs, supporting pagination.
- github_list_teams_that_are_assigned_to_an_organization_role(org: string, page?: integer, role_id: integer, per_page?: integer) — Lists teams assigned to a specific role within a github organization.
- github_list_the_people_a_user_follows(page?: integer, per_page?: integer, username: string) — Lists github users that a valid github `username` is following, supporting pagination.
- github_list_the_people_the_authenticated_user_follows(page?: integer, per_page?: integer) — Lists people the authenticated user follows.
- github_list_timeline_events_for_an_issue(page?: integer, repo: string, owner: string, per_page?: integer, issue_number: integer) — Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a github repository.
- github_list_token_access_repositories(org: string, page?: integer, pat_id: integer, per_page?: integer) — Lists repositories in an organization accessible by a specific fine-grained personal access token; this action is for github apps.
- github_list_user_projects(page?: integer, state?: string, per_page?: integer, username: string) — Retrieves a list of projects for a specified github user, optionally filtering by state and supporting pagination; the username must be a valid github handle.
- github_list_users(since?: integer, per_page?: integer) — Retrieves all github users (individuals and organizations) in chronological order of their sign-up date.
- github_list_users_blocked_by_an_organization(org: string, page?: integer, per_page?: integer) — Lists users blocked by a specified github organization.
- github_list_users_blocked_by_the_authenticated_user(page?: integer, per_page?: integer) — Lists users blocked by the authenticated user, returning an empty list if no users are blocked.
- github_list_users_that_are_assigned_to_an_organization_role(org: string, page?: integer, role_id: integer, per_page?: integer) — Lists users assigned to a specific role within a github organization.
- github_list_watchers(page?: integer, repo: string, owner: string, per_page?: integer) — Retrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user.
- github_list_workflow_run_artifacts(name?: string, page?: integer, repo: string, owner: string, run_id: integer, per_page?: integer) — Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a github repository.
- github_list_workflow_runs_for_a_repository(page?: integer, repo: string, actor?: string, event?: string, owner: string, branch?: string, status?: string, created?: string, head_sha?: string, per_page?: integer, check_suite_id?: integer, exclude_pull_requests?: boolean) — Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite id, or head sha; the repository must exist and be accessible.
- github_list_workflow_runs_for_a_workflow(page?: integer, repo: string, actor?: string, event?: string, owner: string, branch?: string, status?: string, created?: string, head_sha?: string, per_page?: integer, workflow_id: integer, check_suite_id?: integer, exclude_pull_requests?: boolean) — Lists runs for a specified, existing workflow (identified by id or filename like `main.yml`) in a github repository, with filtering options.
- github_lock_an_issue(repo: string, owner: string, lock_reason?: string, issue_number: integer) — Locks an existing github issue's conversation, preventing further comments; an optional reason can be specified.
- github_manage_access_control_for_organization_codespaces(org: string, visibility: string, selected_usernames?: string[]) — Sets the codespaces access control policy for a github organization, determining which members can use them.
- github_manage_custom_properties_for_org_repos(org: string, properties: object[], repository_names: string[]) — Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30).
- github_manage_secrets_in_selected_repositories_with_proper_access(org: string, page?: integer, per_page?: integer, secret_name: string) — Lists repositories within an organization that have been explicitly granted access to a specific organization secret.
- github_map_a_commit_author(name?: string, repo: string, email?: string, owner: string, author_id: integer) — Updates git author information (name and/or email) for an `author id` obtained during a repository import, to correctly attribute commits.
- github_mark_a_thread_as_done(thread_id: integer) — Marks the github notification thread (identified by `thread id`) as done or read for the authenticated user, effectively archiving it.
- github_mark_a_thread_as_read(thread_id: integer) — Marks an existing github notification thread, identified by its `thread id`, as read.
- github_mark_notifications_as_read(read?: boolean, last_read_at?: string) — Marks notifications as read or unread, optionally for those updated at or before a `last read at` timestamp.
- github_mark_repository_notifications_as_read(repo: string, owner: string, last_read_at?: string) — Marks notifications in a repository as read; if 'last read at' is specified, notifications updated after this timestamp are not marked as read.
- github_merge_a_branch(base: string, head: string, repo: string, owner: string, commit_message?: string) — Merges a head branch or commit sha into a base branch in a repository; fails if there are merge conflicts requiring manual resolution.
- github_merge_a_pull_request(sha?: string, repo: string, owner: string, pull_number: integer, commit_title?: string, merge_method?: string, commit_message?: string) — Merges an open and mergeable pull request in a repository, optionally specifying merge commit details, a merge method, and a required head sha for safety.
- github_meta_root() — Deprecated: retrieves github rest api root endpoint details; use `github api root` instead.
- github_move_a_project_card(card_id: integer, position: string, column_id?: integer) — Moves a project card to a specified position, optionally into a new column.
- github_move_a_project_column(position: string, column_id: integer) — Moves a column within a github project (classic) to a new position; `position` can be 'first', 'last', or 'after:<target column id>', where `target column id` must reference an existing column in the 
- github_ping_a_repository_webhook(repo: string, owner: string, hook_id: integer) — Pings an existing webhook on a repository to test its configuration and reachability by github.
- github_ping_an_organization_webhook(org: string, hook_id: integer) — Sends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events.
- github_privately_report_a_security_vulnerability(repo: string, owner: string, cwe_ids?: string[], summary: string, severity?: string, description: string, vulnerabilities?: object[], cvss_vector_string?: string, start_private_fork?: boolean) — Privately reports a security vulnerability for a repository; specify either `severity` or `cvss vector string`, but not both.
- github_pulls_check_if_merged(repo: string, owner: string, pull_number: integer) — Deprecated: use `check if a pull request has been merged` instead. checks if a github pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found).
- github_pulls_create(base: string, body?: string, head: string, repo: string, draft?: boolean, issue?: integer, owner: string, title?: string, head_repo?: string, maintainer_can_modify?: boolean) — Deprecated: use `create a pull request` instead. creates a pull request, requiring existing `base` and `head` branches.
- github_pulls_create_review(body?: string, repo: string, event?: string, owner: string, comments?: object[], commit_id?: string, pull_number: integer) — Deprecated: use `create a review for a pull request` for creating pull request reviews; supports `pending` for drafts and comment positioning.
- github_pulls_create_review_comment(body: string, line?: integer, path: string, repo: string, side?: string, owner: string, position?: integer, commit_id: string, start_line?: integer, start_side?: string, in_reply_to?: integer, pull_number: integer, subject_type?: string) — Deprecated: creates a review comment on a pull request's diff. use `create a review comment for a pull request` instead.
- github_pulls_get(repo: string, owner: string, pull_number: integer) — Deprecated: retrieves details of a specific pull request; prefer using the `get a pull request` action.
- github_pulls_list(base?: string, head?: string, page?: integer, repo: string, sort?: string, owner: string, state?: string, per_page?: integer, direction?: string) — (deprecated: use `list pull requests`) lists pull requests for a specified github repository with ai-friendly filtering.
- github_re_run_a_job_from_a_workflow_run(repo: string, owner: string, job_id: integer, enable_debug_logging?: boolean) — Re-runs a specific job and any dependent jobs from a github actions workflow run in the specified repository, optionally enabling debug logging.
- github_re_run_a_workflow(repo: string, owner: string, run_id: integer, enable_debug_logging?: boolean) — Re-runs a specific github actions workflow run identified by its owner, repository, and run id, optionally enabling debug logging.
- github_re_run_failed_jobs_from_a_workflow_run(repo: string, owner: string, run_id: integer, enable_debug_logging?: boolean) — Re-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs.
- github_redeliver_a_delivery_for_a_repository_webhook(repo: string, owner: string, hook_id: integer, delivery_id: integer) — Redelivers a specific, previously made webhook delivery (`delivery id`) for a repository's webhook (`hook id`).
- github_redeliver_a_delivery_for_an_organization_webhook(org: string, hook_id: integer, delivery_id: integer) — Redelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed.
- github_remove_a_custom_property_for_an_organization(org: string, custom_property_name: string) — Deletes a custom property, specified by `custom property name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories.
- github_remove_a_label_from_an_issue(name: string, repo: string, owner: string, issue_number: integer) — Removes a label currently applied to a specific issue in a repository.
- github_remove_a_project_from_a_team(org: string, team_slug: string, project_id: integer) — Removes a project from a team within an organization; this action requires the project to be currently associated with the team.
- github_remove_a_repository_collaborator(repo: string, owner: string, username: string) — Removes a collaborator from a specified github repository, provided the repository exists and the user is an existing collaborator.
- github_remove_a_repository_from_a_team(org: string, repo: string, owner: string, team_slug: string) — Disassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted.
- github_remove_a_repository_from_an_app_installation(repository_id: integer, installation_id: integer) — Removes a repository from a github app installation for the authenticated user, given a valid `installation id` and the `repository id` of a repository currently linked to that installation; this oper
- github_remove_a_selected_repository_from_a_user_secret(secret_name: string, repository_id: integer) — Removes a selected repository's access to a user's codespaces secret; the secret must exist and the repository must have previously been granted access.
- github_remove_all_labels_from_an_issue(repo: string, owner: string, issue_number: integer) — Removes all labels from a specified issue in a github repository; this operation is idempotent.
- github_remove_all_organization_roles_for_a_team(org: string, team_slug: string) — Revokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles.
- github_remove_all_organization_roles_for_a_user(org: string, username: string) — Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a github organization, without removing the user from the organization or affectin
- github_remove_an_organization_member(org: string, username: string) — Removes a user, who must currently be a member, from a github organization, revoking their membership and access rights.
- github_remove_an_organization_role_from_a_team(org: string, role_id: integer, team_slug: string) — Revokes an organization role that a team currently possesses within an organization.
- github_remove_an_organization_role_from_a_user(org: string, role_id: integer, username: string) — Removes a custom organization role from a user within a github organization, provided the organization exists, the user is a member, and the role id corresponds to a valid custom role in that organiza
- github_remove_app_access_restrictions(repo: string, owner: string, branch: string) — Removes all github app access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action does not alter user or team restrictions.
- github_remove_assignees_from_an_issue(repo: string, owner: string, assignees?: string[], issue_number: integer) — Removes specified assignees from a github issue; requires push access, and invalid removal attempts are silently ignored.
- github_remove_custom_label_from_repo_runner(name: string, repo: string, owner: string, runner_id: integer) — Removes a custom label from a repository's self-hosted runner; this operation is idempotent.
- github_remove_custom_label_from_self_hosted_runner(org: string, name: string, runner_id: integer) — Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner id`) in an organization (`org`).
- github_remove_custom_labels_from_self_hosted_repository_runner(repo: string, owner: string, runner_id: integer) — Removes all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization.
- github_remove_interaction_restrictions_for_a_repository(repo: string, owner: string) — Removes all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits.
- github_remove_interaction_restrictions_for_an_organization(org: string) — Removes all interaction restrictions from public repositories in the specified github organization, allowing all users to resume interactions.
- github_remove_interaction_restrictions_from_your_public_repositories() — Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user.
- github_remove_org_dev_env_secret_by_name(org: string, secret_name: string) — Deletes a github codespaces secret from an organization by its name; this operation is idempotent.
- github_remove_org_secret_by_name(org: string, secret_name: string) — Permanently removes a specific dependabot secret, by its `secret name`, from the github `org`, making it unavailable to dependabot for that organization.
- github_remove_outside_collaborator_from_an_organization(org: string, username: string) — Removes a user, who must be an outside collaborator, from the specified github organization, revoking their access to all its repositories.
- github_remove_public_org_membership(org: string, username: string) — Makes an authenticated user's public membership in an organization private (without removing them from the organization); the user must currently be a public member of that organization.
- github_remove_repo_from_org_dev_env_secret(org: string, secret_name: string, repository_id: integer) — Removes a repository's access to an organization-level codespaces secret, if it was previously granted.
- github_remove_repo_from_org_secret_with_selected_visibility(org: string, secret_name: string, repository_id: integer) — Revokes a specific repository's access to an organization-level dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access.
- github_remove_requested_reviewers_from_a_pull_request(repo: string, owner: string, reviewers: string[], pull_number: integer, team_reviewers?: string[]) — Removes currently assigned user logins and/or team slugs from a github pull request's list of requested reviewers.
- github_remove_selected_repository_from_an_organization_secret(org: string, secret_name: string, repository_id: integer) — Removes a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret.
- github_remove_selected_repository_from_an_organization_variable(org: string, name: string, repository_id: integer) — Removes a repository's access to an organization variable, if the variable's visibility is 'selected' and the repository is in its access list.
- github_remove_status_check_contexts(repo: string, owner: string, branch: string) — Removes specified status check contexts (passed in the request body as an array of strings) from a protected branch in a repository.
- github_remove_status_check_protection(repo: string, owner: string, branch: string) — Removes status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch.
- github_remove_team_access_restrictions(repo: string, owner: string, branch: string) — Removes all team-based access restrictions from a specified protected branch; the branch must be protected and have existing team restrictions for this action to change settings.
- github_remove_team_membership_for_a_user(org: string, username: string, team_slug: string) — Removes a user from a specific team within an organization; this action fails if team synchronization with an identity provider (idp) is enabled, and may delete the team if the user is its last member
- github_remove_user_access_restrictions(repo: string, owner: string, branch: string) — Removes active user-level access restrictions from a specified protected branch, enabling users with repository write access to push or merge if no other team or app restrictions apply.
- github_remove_user_as_a_collaborator(username: string, project_id: integer) — Removes a user as a collaborator from an organization project; the user must already be a collaborator on the specified project.
- github_remove_users_from_codespaces_access_for_an_organization(org: string, selected_usernames: string[]) — Removes selected users from github codespaces billing access for an existing organization.
- github_rename_a_branch(repo: string, owner: string, branch: string, new_name: string) — Renames an existing branch in a github repository; the new name must be unique and adhere to github's naming conventions, and the current branch name cannot contain wildcard characters.
- github_render_a_markdown_document(mode?: string, text: string, context?: string) — Renders markdown to html; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions.
- github_replace_all_repository_topics(repo: string, names: string[], owner: string) — Replaces all topics of a repository.
- github_replace_org_secret_visibility_to_selected(org: string, secret_name: string, selected_repository_ids: integer[]) — Sets an existing dependabot organization secret's visibility to 'selected' and replaces the full list of repositories that can access it with the ids provided.
- github_replace_repo_access_on_org_dev_env_secret_set(org: string, secret_name: string, selected_repository_ids: integer[]) — Replaces the list of repositories that can access an existing organization-level codespaces secret with the provided valid repository ids owned by the organization.
- github_repo_s_create_for_authenticated_user(name: string, private?: boolean, team_id?: integer, has_wiki?: boolean, homepage?: string, auto_init?: boolean, has_issues?: boolean, description?: string, is_template?: boolean, has_projects?: boolean, has_downloads?: boolean, has_discussions?: boolean, allow_auto_merge?: boolean, license_template?: string, allow_merge_commit?: boolean, allow_rebase_merge?: boolean, allow_squash_merge?: boolean, gitignore_template?: string, merge_commit_title?: string, merge_commit_message?: string, delete_branch_on_merge?: boolean, squash_merge_commit_title?: string, squash_merge_commit_message?: string) — Deprecated: use 'create a repository for the authenticated user' instead. creates a new repository for the authenticated user.
- github_repo_s_create_fork(name?: string, repo: string, owner: string, organization?: string, default_branch_only?: boolean) — (deprecated: use `create a fork` instead) creates a fork of a specified repository.
- github_repo_s_create_in_org(org: string, name: string, private?: boolean, team_id?: integer, has_wiki?: boolean, homepage?: string, auto_init?: boolean, has_issues?: boolean, visibility?: string, description?: string, is_template?: boolean, has_projects?: boolean, has_downloads?: boolean, allow_auto_merge?: boolean, license_template?: string, custom_properties?: object, allow_merge_commit?: boolean, allow_rebase_merge?: boolean, allow_squash_merge?: boolean, gitignore_template?: string, merge_commit_title?: string, merge_commit_message?: string, delete_branch_on_merge?: boolean, squash_merge_commit_title?: string, squash_merge_commit_message?: string, use_squash_pr_title_as_default?: boolean) — Deprecated: use `create an organization repository` instead. creates a new repository in the specified organization.
- github_repo_s_create_or_update_file_contents(sha?: string, path: string, repo: string, owner: string, branch?: string, content: string, message: string, author__date?: string, author__name?: string, author__email?: string, committer__date?: string, committer__name?: string, committer__email?: string) — Deprecated: use `create or update file contents` instead; creates or replaces a file in a repository.
- github_repo_s_get_code_frequency_stats(repo: string, owner: string) — Deprecated: use `get the weekly commit activity` instead. fetches weekly commit statistics (additions/deletions) for a repository; less reliable for over 10,000 commits.
- github_repo_s_get_commit(ref: string, page?: integer, repo: string, owner: string, per_page?: integer) — Deprecated: use `get a commit`. 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.
- github_repo_s_get_content(ref?: string, path: string, repo: string, owner: string) — Deprecated: gets repository file content or directory metadata; use `get repository content` instead.
- github_repo_s_get_contributors_stats(repo: string, owner: string) — (deprecated: use `getallcontributorcommitactivity`) fetches commit activity (total commits, weekly additions/deletions/commits) for all repository contributors; retry if github returns 202.
- github_repo_s_list_branches(page?: integer, repo: string, owner: string, per_page?: integer, protected?: boolean) — (deprecated: use 'list branches' instead) lists branches for an existing github repository, with an option to filter by protection status.
- github_repo_s_list_collaborators(page?: integer, repo: string, owner: string, per_page?: integer, permission?: string, affiliation?: string) — (deprecated: use `listrepositorycollaborators`) lists repository collaborators, especially for organization-owned repositories including team members from child teams; requires repository access and p
- github_repo_s_list_commits(sha?: string, page?: integer, path?: string, repo: string, owner: string, since?: string, until?: string, author?: string, per_page?: integer, committer?: string) — Deprecated: use `list commits` instead; lists repository commits, including gpg/s/mime signature verification details if available.
- github_repo_s_list_contributors(anon?: string, page?: integer, repo: string, owner: string, per_page?: integer) — Deprecated: use `list repository contributors`. lists repository contributors, sorted by contributions; repository must exist and be accessible.
- github_repo_s_list_for_authenticated_user(page?: integer, sort?: string, type?: string, since?: string, before?: string, per_page?: integer, direction?: string, raw_response?: boolean) — Deprecated: use `list repositories for the authenticated user` to list the authenticated user's repositories.
- github_repo_s_list_for_org(org: string, page?: integer, sort?: string, type?: string, per_page?: integer, direction?: string) — Deprecated: lists repositories for a github organization; use `list organization repositories` instead.
- github_repo_s_list_for_user(page?: integer, sort?: string, type?: string, per_page?: integer, username: string, direction?: string) — Deprecated: lists public repositories for the specified github user; use `list repositories for a user` instead.
- github_request_a_github_pages_build(repo: string, owner: string) — Manually triggers a github pages build for a repository if github pages is enabled, useful for deployments not automatically built or for retrying failed builds.
- github_request_reviewers_for_a_pull_request(repo: string, owner: string, reviewers?: string[], pull_number: integer, team_reviewers?: string[]) — Requests user and/or team reviewers for an open pull request in a repository; requires `owner`, `repo`, `pull number`, and at least one of `reviewers` or `team reviewers`.
- github_rerequest_a_check_run(repo: string, owner: string, check_run_id: integer) — Triggers a re-run of a specific check run in a github repository, which resets its status to 'queued', clears its conclusion, and triggers the `check run` webhook with `rerequested`.
- github_rerequest_a_check_suite(repo: string, owner: string, check_suite_id: integer) — Triggers a new run of an existing check suite within a repository, useful for re-running checks without new code.
- github_reset_a_token(client_id: string, access_token: string) — Invalidates the provided oauth `access token` and generates a new one for the github oauth app identified by `client id`, used for token compromise or security rotation.
- github_restore_a_package_for_a_user(token?: string, username: string, package_name: string, package_type: string) — Restores a user-owned package previously deleted from github packages, if restorable under github's data retention policy (typically within 30 days of deletion).
- github_restore_a_package_for_an_organization(org: string, token?: string, package_name: string, package_type: string) — Restores a package in an organization, provided it was deleted within the last 30 days.
- github_restore_a_package_for_the_authenticated_user(token?: string, package_name: string, package_type: string) — Restores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available.
- github_restore_a_package_version_for_the_authenticated_user(package_name: string, package_type: string, package_version_id: integer) — Restores a package version that was deleted by the authenticated user within the last 30 days.
- github_restore_package_version_for_a_user(username: string, package_name: string, package_type: string, package_version_id: integer) — Restores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available.
- github_restore_package_version_for_an_organization(org: string, package_name: string, package_type: string, package_version_id: integer) — Restores a package version for an organization, provided it was deleted within the last 30 days.
- github_retrieve_repo_public_key_for_encryption(repo: string, owner: string) — Gets a repository's public key, used to encrypt secrets for dependabot.
- github_review_access_with_personal_token(org: string, action: string, reason?: string, pat_request_id: integer) — Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a github app.
- github_review_deployment_protection_rules(repo: string, owner: string, run_id: integer) — Approves or rejects pending custom deployment protection rules for a workflow run by posting a review with `environment name` (str), `state` (str: 'approved'/'rejected'), and optional `comment` (str) 
- github_review_pending_deployments_for_a_workflow_run(repo: string, owner: string, state: string, run_id: integer, comment: string, environment_ids: integer[]) — Approves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments.
- github_review_resource_requests_with_fine_grained_tokens(org: string, action: string, reason?: string, pat_request_ids?: integer[]) — Approves or denies fine-grained personal access token requests for an organization; any specified `pat request ids` must refer to currently pending requests.
- github_revoke_an_installation_access_token() — Revokes the github app's current installation access token, immediately invalidating it for api authentication.
- github_search_code(q: string, page?: integer, sort?: string, order?: string, per_page?: integer) — Searches code file contents and paths on the default branch of github repositories using a query string; searches only files under 384kb, returns max 1000 results by best match, and is optimized for p
- github_search_commits(q: string, page?: integer, sort?: string, order?: string, per_page?: integer) — Finds commits on github using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination.
- github_search_issues_and_pull_requests(q: string, page?: integer, sort?: string, order?: string, per_page?: integer, raw_response?: boolean) — Searches github for issues and pull requests. use qualifiers to scope searches: `repo:owner/name` for specific repos, `org:orgname` for organizations, `user:username` for personal repos, `assignee:@me
- github_search_labels(q: string, page?: integer, sort?: string, order?: string, per_page?: integer, repository_id: integer) — Searches for labels within a github repository by keywords in their names or descriptions.
- github_search_repo_s(q: string, page?: integer, sort?: string, order?: string, per_page?: integer) — Deprecated: use `search repositories`; this version finds repositories by criteria, including text match metadata and pagination. example: `q="tetris language:assembly", sort="stars"`
- github_search_repositories(q: string, page?: integer, sort?: string, order?: string, per_page?: integer) — Searches github repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination.
- github_search_topics(q: string, page?: integer, per_page?: integer) — Finds topics on github using keywords and qualifiers with github's search syntax, supporting pagination.
- github_search_users(q: string, page?: integer, sort?: string, order?: string, per_page?: integer) — Searches for users on github by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`.
- github_security_advisories_list_global_advisories(cwes?: string[], sort?: string, type?: string, after?: string, before?: string, cve_id?: string, affects?: string[], ghsa_id?: string, updated?: string, modified?: string, per_page?: integer, severity?: string, direction?: string, ecosystem?: string, published?: string, is_withdrawn?: boolean) — tags = ["openworldhint", "readonlyhint", "mcpignore"] the text describes how to find global security advisories with specific parameters. by default, it excludes malware advisories, which can be inclu
- github_set_a_repository_subscription(repo: string, owner: string, ignored?: boolean, subscribed?: boolean) — Sets the authenticated user's notification subscription for a repository.
- github_set_a_thread_subscription(ignored?: boolean, thread_id: integer) — Sets whether a github notification thread is ignored (muted) or unignored (unmuted), for a `thread id` that must identify an existing notification thread.
- github_set_admin_branch_protection(repo: string, owner: string, branch: string) — Enables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured.
- github_set_app_access_restrictions(repo: string, owner: string, branch: string) — Replaces the list of github apps permitted to push to a protected branch; the branch must already be protected and apps must be installed with 'contents' permission.
- github_set_default_workflow_permissions_for_a_repository(repo: string, owner: string, default_workflow_permissions?: string, can_approve_pull_request_reviews?: boolean) — Sets the default permissions for the github token within a repository and configures whether github actions can approve pull requests.
- github_set_default_workflow_permissions_for_an_organization(org: string, default_workflow_permissions?: string, can_approve_pull_request_reviews?: boolean) — Updates an organization's default github token permissions for workflows and whether github actions can approve pull requests; note that allowing actions to approve pull requests (`can approve pull re
- github_set_github_actions_permissions_for_a_repository(repo: string, owner: string, enabled: boolean, allowed_actions?: string) — Sets github actions permissions for a repository, enabling/disabling actions and defining the policy for allowed actions and reusable workflows.
- github_set_github_actions_permissions_for_an_organization(org: string, allowed_actions?: string, enabled_repositories: string) — Sets the github actions permissions policy for an organization, specifying which repositories can run actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the sp
- github_set_interaction_restrictions_for_a_repository(repo: string, limit: string, owner: string, expiry?: string) — Temporarily limits which github users (e.g., existing users, contributors only) can interact (comment, open issues, create pull requests) in a repository for a specified duration.
- github_set_interaction_restrictions_for_an_organization(org: string, limit: string, expiry?: string) — Limits interactions (comments, new issues, prs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity.
- github_set_interaction_restrictions_for_your_public_repositories(limit: string, expiry?: string) — Sets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits.
- github_set_labels_for_an_issue(repo: string, owner: string, labels: string[], issue_number: integer) — Replaces all existing labels on a github issue with a new set of labels.
- github_set_org_allowed_actions(org: string, patterns_allowed?: string[], verified_allowed?: boolean, github_owned_allowed?: boolean) — Sets the github actions permissions for an existing organization, specifying allowed github-owned actions, verified creator actions, and action/workflow patterns from public repositories.
- github_set_org_runner_labels(org: string, labels: string[], runner_id: integer) — Sets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., 'self-hosted', 'linux', 'x64').
- github_set_primary_email_visibility_for_the_authenticated_user(visibility: string) — Sets the visibility ('public' or 'private') of the authenticated user's primary email address on github, if one is configured.
- github_set_repo_allowed_actions(repo: string, owner: string, patterns_allowed?: string[], verified_allowed?: boolean, github_owned_allowed?: boolean) — Sets allowed github actions and reusable workflows for a repository, managing permissions for github-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns allowed` ap
- github_set_selected_repositories_for_a_user_secret(secret_name: string, selected_repository_ids: integer[]) — Defines the list of repositories permitted to access a specific codespaces secret for the authenticated user.
- github_set_selected_repositories_for_an_organization_secret(org: string, secret_name: string, selected_repository_ids: integer[]) — Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'.
- github_set_selected_repositories_for_an_organization_variable(org: string, name: string, selected_repository_ids: integer[]) — Replaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'.
- github_set_status_check_contexts(repo: string, owner: string, branch: string, contexts: string[]) — Replaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks.
- github_set_team_access_restrictions(repo: string, owner: string, branch: string) — Sets team push access for a protected branch by replacing all current teams with a new list of valid team slugs (provided in the request body); an empty list of slugs removes all team restrictions.
- github_set_user_access_restrictions(repo: string, owner: string, branch: string) — Replaces the list of users with push access to a protected branch using a request body (not in this schema) containing an array of github usernames; this enables branch protection if not already activ
- github_set_workflow_external_access(repo: string, owner: string, access_level: string) — Sets the access level for workflows outside a repository to use actions and reusable workflows within that repository.
- github_star_a_gist(gist_id: string) — Stars a github gist identified by `gist id`; this action is idempotent and returns a 204 no content status upon success, even if the gist is already starred.
- github_star_a_repository_for_the_authenticated_user(repo: string, owner: string) — Stars an existing and accessible repository for the authenticated user; this action is idempotent and succeeds even if the repository is already starred.
- github_start_a_codespace_for_the_authenticated_user(codespace_name: string) — Initiates the startup process for an existing github codespace (identified by `codespace name`) if it's in a startable state like 'available' or 'stopped'.
- github_stop_a_codespace_for_an_organization_user(org: string, username: string, codespace_name: string) — Stops a codespace, which must be currently running, for a specified member of an organization.
- github_stop_a_codespace_for_the_authenticated_user(codespace_name: string) — Stops a running or available codespace for the authenticated user, pausing its execution and billing.
- github_submit_a_review_for_a_pull_request(body?: string, repo: string, event: string, owner: string, review_id: integer, pull_number: integer) — Finalizes a pending pull request review (identified by `review id`) with a required `event` (approve, request changes, comment) and an optional `body`.
- github_sync_a_fork_branch_with_the_upstream_repository(repo: string, owner: string, branch: string) — Synchronizes a branch in a forked github repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free.
- github_test_the_push_repository_webhook(repo: string, owner: string, hook_id: integer) — Triggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 no content without sending 
- github_transfer_a_repository(repo: string, owner: string, new_name?: string, team_ids?: integer[], new_owner: string) — Initiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers.
- github_unblock_a_user(username: string) — Unblocks a github user, provided they are currently blocked by the authenticated user.
- github_unblock_a_user_from_an_organization(org: string, username: string) — Unblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur).
- github_unfollow_a_user(username: string) — Unfollows an existing github user; this action is idempotent, succeeding even if the authenticated user is not currently following them.
- github_unlock_a_user_repository(repo_name: string, migration_id: integer) — Unlocks a repository (`repo name`) that was locked as part of a user migration (`migration id`), making it usable or deletable; this action requires the repository to be currently locked.
- github_unlock_an_issue(repo: string, owner: string, issue_number: integer) — Unlocks a currently locked github issue in the specified repository, allowing new comments and interactions.
- github_unlock_an_organization_repository(org: string, repo_name: string, migration_id: integer) — Unlocks an organization repository previously locked by a github migration.
- github_unstar_a_gist(gist_id: string) — Removes a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user.
- github_unstar_a_repository_for_the_authenticated_user(repo: string, owner: string) — Removes the authenticated user's star from a specified repository, which must already be starred by the user.
- github_update_a_check_run(name?: string, repo: string, owner: string, status?: string, actions?: object[], conclusion?: string, started_at?: string, details_url?: string, external_id?: string, check_run_id: integer, completed_at?: string, output__text?: string, output__title?: string, output__images?: object[], output__summary?: string, output__annotations?: object[]) — Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details.
- github_update_a_code_scanning_alert(repo: string, owner: string, state: string, alert_number: integer, dismissed_reason?: string, dismissed_comment?: string) — Updates a specific code scanning alert in a github repository, primarily to change its state (e.g., 'open' or 'dismissed').
- github_update_a_code_scanning_default_setup_configuration(repo: string, owner: string, state?: string, languages?: string[], query_suite?: string) — Updates the default setup configuration for code scanning in a repository; github advanced security must be enabled for the repository.
- github_update_a_codespace_for_the_authenticated_user(machine?: string, display_name?: string, codespace_name: string, recent_folders?: string[]) — Updates an existing github codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start.
- github_update_a_commit_comment(body: string, repo: string, owner: string, comment_id: integer) — Changes the body of an existing commit comment.
- github_update_a_custom_organization_role(org: string, name?: string, role_id: integer, description?: string, permissions?: string[]) — Updates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided.
- github_update_a_deployment_branch_policy(name: string, repo: string, owner: string, branch_policy_id: integer, environment_name: string) — Updates the name pattern of an existing deployment branch policy for a specific environment in a repository.
- github_update_a_discussion(org: string, body?: string, title?: string, team_slug: string, discussion_number: integer) — Updates the title and/or body of a specific team discussion within an organization.
- github_update_a_discussion_comment(org: string, body: string, team_slug: string, comment_number: integer, discussion_number: integer) — Updates the body of a comment in a team's discussion within an organization.
- github_update_a_gist(files?: object, gist_id: string, description?: string) — Updates a gist's description, and/or its files (including content, filename changes, or deletion).
- github_update_a_gist_comment(body: string, gist_id: string, comment_id: integer) — Updates an existing comment on a specified gist.
- github_update_a_label(name: string, repo: string, color?: string, owner: string, new_name?: string, description?: string) — Updates an existing label's name, color, or description within a specified repository.
- github_update_a_milestone(repo: string, owner: string, state?: string, title?: string, due_on?: string, description?: string, milestone_number: integer) — Updates a milestone in a repository, identified by `owner`, `repo`, and `milestone number`, by allowing modification of its `title`, `state`, `description`, or `due on`; at least one of these four att
- github_update_a_project(body?: string, name?: string, state?: string, private?: boolean, project_id: integer, organization_permission?: string) — Updates an existing github project's attributes if the github projects feature is enabled and at least one modifiable field is provided.
- github_update_a_pull_request(base?: string, body?: string, repo: string, owner: string, state?: string, title?: string, pull_number: integer, maintainer_can_modify?: boolean) — Updates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings.
- github_update_a_pull_request_branch(repo: string, owner: string, pull_number: integer, expected_head_sha?: string) — Updates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously.
- github_update_a_reference(ref: string, sha: string, repo: string, force?: boolean, owner: string) — Updates a git reference (e.g., a branch or tag) to a specific commit sha, creating the reference if it doesn't exist; use `force` for non-fast-forward updates.
- github_update_a_release(body?: string, name?: string, repo: string, draft?: boolean, owner: string, tag_name?: string, prerelease?: boolean, release_id: integer, make_latest?: string, target_commitish?: string, discussion_category_name?: string) — Updates an existing release in a github repository, allowing modification of its attributes; if linking a discussion, the `discussion category name` must refer to an existing category in the repositor
- github_update_a_release_asset(name?: string, repo: string, label?: string, owner: string, state?: string, asset_id: integer) — Updates the name, label, or state of a release asset in a github repository, requiring at least one of these properties to be provided for modification.
- github_update_a_repository(name?: string, repo: string, owner: string, private?: boolean, archived?: boolean, has_wiki?: boolean, homepage?: string, has_issues?: boolean, visibility?: string, description?: string, is_template?: boolean, has_projects?: boolean, allow_forking?: boolean, default_branch?: string, allow_auto_merge?: boolean, allow_merge_commit?: boolean, allow_rebase_merge?: boolean, allow_squash_merge?: boolean, merge_commit_title?: string, allow_update_branch?: boolean, merge_commit_message?: string, delete_branch_on_merge?: boolean, squash_merge_commit_title?: string, squash_merge_commit_message?: string, web_commit_signoff_required?: boolean, use_squash_pr_title_as_default?: boolean, security__and__analysis__secret__scanning__status?: string, security__and__analysis__advanced__security__status?: string, security__and__analysis__secret__scanning__push__protection__status?: string) — Updates settings for an existing github repository, such as name, description, visibility, merge strategies, and security configurations.
- github_update_a_repository_invitation(repo: string, owner: string, permissions?: string, invitation_id: integer) — Updates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist.
- github_update_a_repository_ruleset(name?: string, repo: string, owner: string, rules?: object[], target?: string, ruleset_id: integer, enforcement?: string, bypass_actors?: object[], conditions__ref__name__exclude?: string[], conditions__ref__name__include?: string[]) — Updates an existing repository ruleset, identified by `ruleset id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, a
- github_update_a_repository_variable(name?: string, repo: string, owner: string, value?: string) — Updates the name and/or value of an existing github actions variable in a repository.
- github_update_a_repository_webhook(repo: string, owner: string, active?: boolean, events?: string[], hook_id: integer, add_events?: string[], config__url?: string, remove_events?: string[], config__secret?: string, config__content__type?: string, config__insecure__ssl?: string) — Updates the url, content type, secret, ssl verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook id`.
- github_update_a_review_comment_for_a_pull_request(body: string, repo: string, owner: string, comment_id: integer) — Updates the body of an existing review comment on a pull request.
- github_update_a_review_for_a_pull_request(body: string, repo: string, owner: string, review_id: integer, pull_number: integer) — Updates the body text of an existing pull request review.
- github_update_a_team(org: string, name?: string, privacy?: string, team_slug: string, permission?: string, description?: string, parent_team_id?: integer, notification_setting?: string) — Updates a team's settings (e.g., name, description, privacy, parent team) within a github organization, identified by its slug and organization name.
- github_update_a_webhook_configuration_for_a_repository(url?: string, repo: string, owner: string, secret?: string, hook_id: integer, content_type?: string, insecure_ssl?: string) — Updates the configuration (e.g., payload url, content type, secret, ssl verification) for an existing webhook in a specified repository.
- github_update_a_webhook_configuration_for_an_organization(org: string, url?: string, secret?: string, hook_id: integer, content_type?: string, insecure_ssl?: string) — Updates the configuration (url, content type, secret, ssl verification) for an existing webhook within a specified organization.
- github_update_an_environment_variable(name: string, repo: string, owner: string, value?: string, environment_name: string) — Updates an existing environment variable's name and/or value in a specific github repository environment; requires providing either a new name or a new value.
- github_update_an_existing_project_card(note?: string, card_id: integer, archived?: boolean) — Updates an existing project card's note and/or archived status, identified by its `card id`.
- github_update_an_existing_project_column(name: string, column_id: integer) — Updates the name of an existing column, identified by `column id`, in a github project (classic).
- github_update_an_issue(body?: string, repo: string, owner: string, state?: string, title?: string, labels?: string[], assignee?: string, assignees?: string[], milestone?: string, issue_number: integer, state_reason?: string) — Updates an existing github issue's title, body, state, milestone, labels, or assignees; `state reason` is only processed if `state` also changes, and use `null` or `[]` to clear applicable fields.
- github_update_an_issue_comment(body: string, repo: string, owner: string, comment_id: integer) — Updates an existing comment on an issue or pull request within a specified repository.
- github_update_an_organization(org: string, blog?: string, name?: string, email?: string, company?: string, location?: string, description?: string, billing_email?: string, twitter_username?: string, has_repository_projects?: boolean, members_can_create_pages?: boolean, has_organization_projects?: boolean, web_commit_signoff_required?: boolean, default_repository_permission?: string, members_can_create_public_pages?: boolean, members_can_create_repositories?: boolean, members_can_create_private_pages?: boolean, members_can_fork_private_repositories?: boolean, members_can_create_public_repositories?: boolean, members_can_create_private_repositories?: boolean, members_allowed_repository_creation_type?: string, members_can_create_internal_repositories?: boolean, secret_scanning_push_protection_custom_link?: string, secret_scanning_enabled_for_new_repositories?: boolean, dependency_graph_enabled_for_new_repositories?: boolean, advanced_security_enabled_for_new_repositories?: boolean, dependabot_alerts_enabled_for_new_repositories?: boolean, secret_scanning_push_protection_custom_link_enabled?: boolean, dependabot_security_updates_enabled_for_new_repositories?: boolean, secret_scanning_push_protection_enabled_for_new_repositories?: boolean) — Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions.
- github_update_an_organization_variable(org: string, name: string, value?: string, visibility?: string, selected_repository_ids?: integer[]) — Updates an existing github actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected repository ids` with valid repository ids if visibility is `se
- github_update_an_organization_webhook(org: string, name?: string, active?: boolean, events?: string[], hook_id: integer, config__url?: string, config__secret?: string, config__content__type?: string, config__insecure__ssl?: string) — Updates the configuration (url, content type, secret, ssl verification), subscribed events, active status, or name of an existing webhook for a specified organization.
- github_update_branch_protection(repo: string, owner: string, branch: string, lock_branch?: boolean, enforce_admins: boolean, allow_deletions?: boolean, block_creations?: boolean, allow_force_pushes?: boolean, allow_fork_syncing?: boolean, restrictions__apps?: string[], restrictions__teams?: string[], restrictions__users?: string[], required_linear_history?: boolean, required__status__checks__checks?: object[], required__status__checks__strict?: boolean, required_conversation_resolution?: boolean, required__status__checks__contexts?: string[], required__pull__request__reviews__dismiss__stale__reviews?: boolean, required__pull__request__reviews__dismissal__restrictions__apps?: string[], required__pull__request__reviews__require__code__owner__reviews?: boolean, required__pull__request__reviews__require__last__push__approval?: boolean, required__pull__request__reviews__dismissal__restrictions__teams?: string[], required__pull__request__reviews__dismissal__restrictions__users?: string[], required__pull__request__reviews__required__approving__review__count?: integer, required__pull__request__reviews__bypass__pull__request__allowances__apps?: string[], required__pull__request__reviews__bypass__pull__request__allowances__teams?: string[], required__pull__request__reviews__bypass__pull__request__allowances__users?: string[]) — Updates the protection settings for an existing branch in a repository, which must not contain wildcard characters.
- github_update_git_lfs_preference(repo: string, owner: string, use_lfs: string) — Sets the git large file storage (lfs) preference for a repository, typically before initiating a source import.
- github_update_information_about_a_github_pages_site(repo: string, cname?: string, owner: string, source?: string, build_type?: string, https_enforced?: boolean) — Updates the configuration for a github pages site (e.g., custom domain, https, build type, source); requires github pages to be enabled for the repository, and if `build type` is 'workflow', a corresp
- github_update_pull_request_review_protection(repo: string, owner: string, branch: string, dismiss_stale_reviews?: boolean, require_code_owner_reviews?: boolean, require_last_push_approval?: boolean, dismissal__restrictions__apps?: string[], dismissal__restrictions__teams?: string[], dismissal__restrictions__users?: string[], required_approving_review_count?: integer, bypass__pull__request__allowances__apps?: string[], bypass__pull__request__allowances__teams?: string[], bypass__pull__request__allowances__users?: string[]) — Updates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection features must be available for the repository.
- github_update_repository_preferences_for_check_suites(repo: string, owner: string, auto_trigger_checks?: object[]) — Updates repository preferences for automatic check suite creation on code pushes, allowing configuration for specific github apps that must be installed on the repository with `checks:write` permissio
- github_update_resource_access_with_tokens(org: string, action: string, pat_ids: integer[]) — Revokes organization access for the personal access tokens identified by `pat ids`; this action must be performed by a github app, and `pat ids` must be valid and associated with the organization.
- github_update_status_check_protection(repo: string, owner: string, branch: string, checks?: object[], strict?: boolean, contexts?: string[]) — Updates required status checks for a branch, optionally requiring it to be up-to-date before merging.
- github_update_the_authenticated_user(bio?: string, blog?: string, name?: string, email?: string, company?: string, hireable?: boolean, location?: string, twitter_username?: string) — Updates the authenticated user's github profile; a new public email must be verified, and existing private emails remain private even if specified.
- github_update_token_org_access(org: string, action: string, pat_id: integer) — Revokes a fine-grained personal access token's access to an organization, usable only by github apps when the token has existing access to that organization.
- github_upload_an_analysis_as_sarif_data(ref: string, repo: string, owner: string, sarif: string, validate?: boolean, tool_name?: string, commit_sha: string, started_at?: string, checkout_uri?: string) — Uploads a gzipped and base64 encoded sarif file to a github repository for a specific commit and reference; use `checkout uri` if sarif paths are absolute.
- github_users_get_authenticated() — [deprecated] retrieves the authenticated user's information; use `get the authenticated user` instead.
- github_users_get_by_username(username: string) — Deprecated: use the `getauser` action to retrieve a github user's public profile by username.
- github_users_get_context_for_user(username: string, subject_id?: string, subject_type?: string) — Retrieves contextual hovercard information for a github user. (deprecated: please use the `get contextual information for a user` action instead).
- github_users_list_followers_for_authenticated_user(page?: integer, per_page?: integer) — Deprecated: lists users following the authenticated github user; use `list followers of the authenticated user` instead.
- github_users_list_public_emails_for_authenticated_user(page?: integer, per_page?: integer) — Deprecated: use `listpublicemailaddressesfortheauthenticateduser` instead; lists public email addresses for the authenticated user.
- github_users_list_social_accounts_for_user(page?: integer, per_page?: integer, username: string) — Deprecated: lists social media accounts for an existing github user; use 'list social accounts for a user' instead.
- github_verify_dev_container_permissions_accepted(ref: string, repo: string, owner: string, devcontainer_path: string) — Verifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used.

## Links
Docs: https://mcp.ai/docs/mcps/github
Website: https://mcp.ai/mcps/github