Skip to main content
Server path: /github | Type: Application | PCID required: Yes

Tools

ToolDescription
github_get_repositoryGet information about a GitHub repository
github_list_repositoriesList repositories for the authenticated user. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_search_repositoriesSearch for repositories on GitHub. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_create_repositoryCreate a new GitHub repository
github_get_file_contentGet the content of a file from a GitHub repository
github_create_or_update_fileCreate or update a file in a GitHub repository
github_list_commitsList commits in a GitHub repository. This tool automatically fetches ALL matching commits across multiple pages — no manual pagination needed. Use the since/until parameters to scope by date range, author to filter by committer, and maxResults to cap the total (default 500). Results are complete unless truncatedAtMax is true.
github_get_current_userGet information about the authenticated user
github_create_branchCreate a new branch in a GitHub repository
github_list_branchesList branches in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_commitGet a specific commit by reference (SHA, branch, or tag)
github_delete_fileDelete a file from a GitHub repository
github_push_filesPush multiple files to a GitHub repository in a single atomic commit using the Git Tree API
github_fork_repositoryFork a GitHub repository to your account or an organization
github_create_issueCreate a new issue in a GitHub repository
github_list_issuesList issues in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_issueGet a specific issue by number
github_update_issueUpdate an existing GitHub issue
github_create_issue_commentAdd a comment to a GitHub issue
github_get_issue_commentsList comments on a GitHub issue
github_get_issue_labelsList labels on a GitHub issue
github_create_pull_requestCreate a new pull request in a GitHub repository
github_list_pull_requestsList pull requests in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_pull_requestGet a specific pull request by number
github_get_pull_request_diffGet the raw diff of a pull request
github_get_pull_request_filesList files changed in a pull request
github_get_pull_request_reviewsList reviews on a pull request
github_get_pull_request_review_commentsList review comments (inline comments on the diff) for a pull request
github_get_pull_request_commentsList conversation comments on a pull request (uses the issues API)
github_get_pull_request_check_runsGet CI check runs for a commit or branch reference
github_get_pull_request_statusGet the combined commit status for a reference
github_update_pull_requestUpdate an existing pull request
github_merge_pull_requestMerge a pull request
github_update_pull_request_branchUpdate a pull request branch with the latest changes from the base branch
github_create_pull_request_reviewCreate or submit a review on a pull request
github_add_pull_request_review_commentAdd a review comment on a pull request diff
github_reply_to_pull_request_commentReply to an existing review comment on a pull request
github_search_issuesSearch issues across GitHub repositories using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like repo:owner/name, state:open, label:bug, assignee:username, etc.
github_search_pull_requestsSearch pull requests across GitHub repositories using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like repo:owner/name, state:open, label:bug, author:username, is:pr, etc.
github_search_codeSearch code across GitHub repositories using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like repo:owner/name, language:javascript, filename:test, extension:ts, etc.
github_search_usersSearch users on GitHub using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like type:user, type:org, location:city, language:javascript, followers:>100, etc.
github_list_workflowsList all workflows in a GitHub repository (GitHub Actions workflow files). IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_workflowGet a specific workflow by ID or filename
github_list_workflow_runsList workflow runs for a repository, optionally filtered by workflow, actor, branch, event, or status. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_workflow_runGet a specific workflow run by ID
github_list_workflow_jobsList jobs for a specific workflow run. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_workflow_jobGet a specific workflow job by ID
github_run_workflowTrigger a workflow dispatch event to run a GitHub Actions workflow. The workflow must have a workflow_dispatch trigger configured.
github_get_job_logsDownload logs for a specific workflow job
github_cancel_workflow_runCancel a workflow run that is in progress or queued
github_rerun_workflowRe-run an entire workflow run
github_rerun_failed_jobsRe-run only the failed jobs in a workflow run (instead of the entire run)
github_list_workflow_run_artifactsList artifacts produced by a workflow run. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_download_workflow_run_artifactGet a download URL for a workflow run artifact. Returns a redirect URL to download the artifact archive (ZIP).
github_get_labelGet a specific label by name from a GitHub repository
github_list_labelsList all labels in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_create_labelCreate a new label in a GitHub repository
github_update_labelUpdate an existing label in a GitHub repository. Can change name, color, and/or description.
github_delete_labelDelete a label from a GitHub repository
github_list_releasesList releases in a GitHub repository, ordered by creation date. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_latest_releaseGet the latest published release in a GitHub repository (excludes drafts and pre-releases)
github_get_release_by_tagGet a specific release by its tag name
github_list_tagsList tags in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore.
github_get_tagGet an annotated tag object by its SHA. Use this to get details like the tag message and tagger information.
github_get_repository_treeGet a repository tree (directory listing) recursively or non-recursively. Use HEAD as the treeSha to get the default branch tree, or provide a specific branch name or tree SHA.
github_list_trigger_capabilitiesList available trigger types that can be created for GitHub webhooks
github_create_triggerCreate a GitHub webhook that will send events
github_update_triggerUpdate an existing GitHub webhook (only supports updating events list)
github_delete_triggerDelete a GitHub webhook

github_get_repository

Get information about a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name

github_list_repositories

List repositories for the authenticated user. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
visibilitystringNo"all"Repository visibility filter
sortstringNo"created"Sort field
directionstringNo"desc"Sort direction
perPagenumberNo30Number of results per page
pagenumberNoPage number for pagination (default: 1)

github_search_repositories

Search for repositories on GitHub. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query (e.g., “language:javascript”, “user:octocat”)
sortstringNoSort field
orderstringNo"desc"Sort order
perPagenumberNo30Number of results per page
pagenumberNoPage number for pagination (default: 1)

github_create_repository

Create a new GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesRepository name
descriptionstringNoRepository description
privatebooleanNofalseWhether repository is private
autoInitbooleanNofalseInitialize with README
gitignoreTemplatestringNoGitignore template to use
licenseTemplatestringNoLicense template to use

github_get_file_content

Get the content of a file from a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pathstringYesFile path in repository
refstringNoBranch, tag, or commit SHA (defaults to default branch)

github_create_or_update_file

Create or update a file in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pathstringYesFile path in repository
messagestringYesCommit message
contentstringYesFile content (will be base64 encoded)
branchstringNoBranch to commit to (defaults to default branch)
shastringNoSHA of existing file (required for updates)

github_list_commits

List commits in a GitHub repository. This tool automatically fetches ALL matching commits across multiple pages — no manual pagination needed. Use the since/until parameters to scope by date range, author to filter by committer, and maxResults to cap the total (default 500). Results are complete unless truncatedAtMax is true. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
shastringNoSHA or branch to start listing from
pathstringNoFilter commits by file path
authorstringNoFilter commits by author
sincestringNoOnly commits after this date (ISO 8601)
untilstringNoOnly commits before this date (ISO 8601)
maxResultsnumberNo500Maximum number of commits to return (default 500). The tool fetches all pages automatically up to this limit.

github_get_current_user

Get information about the authenticated user

github_create_branch

Create a new branch in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
branchNamestringYesName for the new branch
fromBranchstringNo"main"Source branch to create from

github_list_branches

List branches in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
perPagenumberNo30Number of results per page
protectedbooleanNoFilter to only protected branches
pagenumberNoPage number for pagination (default: 1)

github_get_commit

Get a specific commit by reference (SHA, branch, or tag) Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
refstringYesCommit SHA, branch name, or tag

github_delete_file

Delete a file from a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pathstringYesFile path in repository
messagestringYesCommit message for the deletion
shastringYesSHA of the file being deleted (use github_get_file_content to get this)
branchstringNoBranch to delete from (defaults to default branch)

github_push_files

Push multiple files to a GitHub repository in a single atomic commit using the Git Tree API Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
branchstringYesBranch to push to
filesobject[]YesArray of files to push
messagestringYesCommit message

github_fork_repository

Fork a GitHub repository to your account or an organization Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
organizationstringNoOrganization to fork to (defaults to authenticated user)

github_create_issue

Create a new issue in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization). Tip: Use github_list_repositories to see repositories you have access to.
repostringYesRepository name. Tip: Use github_list_repositories or github_search_repositories to discover available repositories.
titlestringYesIssue title
bodystringNoIssue description/body
assigneesstring[]NoArray of usernames to assign. Tip: Use github_get_current_user to get your username.
labelsstring[]NoArray of label names to apply (label names, not IDs)
milestonenumberNoMilestone number to associate with issue

github_list_issues

List issues in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
statestringNo"open"Issue state filter
assigneestringNoFilter by assignee username
labelsstringNoComma-separated list of label names
sortstringNo"created"Sort field
directionstringNo"desc"Sort direction
perPagenumberNo30Number of results per page
pagenumberNoPage number for pagination (default: 1)

github_get_issue

Get a specific issue by number Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number

github_update_issue

Update an existing GitHub issue Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number to update
titlestringNoUpdated issue title
bodystringNoUpdated issue body
statestringNoUpdated issue state
assigneesstring[]NoUpdated assignees
labelsstring[]NoUpdated labels

github_create_issue_comment

Add a comment to a GitHub issue Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number to comment on
bodystringYesComment text

github_get_issue_comments

List comments on a GitHub issue Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number
perPagenumberNoNumber of results per page

github_get_issue_labels

List labels on a GitHub issue Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number

github_create_pull_request

Create a new pull request in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
titlestringYesPull request title
headstringYesBranch with changes (e.g., “feature-branch”)
basestringYesBase branch to merge into (e.g., “main”)
bodystringNoPull request description
draftbooleanNofalseCreate as draft PR
maintainerCanModifybooleanNotrueAllow maintainers to modify PR

github_list_pull_requests

List pull requests in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
statestringNo"open"PR state filter
headstringNoFilter by head branch
basestringNoFilter by base branch
sortstringNo"created"Sort field
directionstringNo"desc"Sort direction
perPagenumberNo30Number of results per page
pagenumberNoPage number for pagination (default: 1)

github_get_pull_request

Get a specific pull request by number Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_get_pull_request_diff

Get the raw diff of a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_get_pull_request_files

List files changed in a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_get_pull_request_reviews

List reviews on a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_get_pull_request_review_comments

List review comments (inline comments on the diff) for a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_get_pull_request_comments

List conversation comments on a pull request (uses the issues API) Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_get_pull_request_check_runs

Get CI check runs for a commit or branch reference Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
refstringYesCommit SHA or branch name

github_get_pull_request_status

Get the combined commit status for a reference Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
refstringYesCommit SHA or branch name

github_update_pull_request

Update an existing pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number
titlestringNoUpdated PR title
bodystringNoUpdated PR body
statestringNoUpdated PR state
basestringNoUpdated base branch
maintainerCanModifybooleanNoAllow maintainers to modify PR

github_merge_pull_request

Merge a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number
commitTitlestringNoTitle for the merge commit
commitMessagestringNoMessage for the merge commit
mergeMethodstringNoMerge method to use
shastringNoSHA that head must match to allow merge

github_update_pull_request_branch

Update a pull request branch with the latest changes from the base branch Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number
expectedHeadShastringNoExpected SHA of the head ref

github_create_pull_request_review

Create or submit a review on a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number
bodystringNoReview body text
eventstringYesReview action to perform
commentsobject[]NoArray of review comments to include

github_add_pull_request_review_comment

Add a review comment on a pull request diff Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number
bodystringYesComment body
commitIdstringYesThe SHA of the commit to comment on
pathstringYesThe relative path of the file to comment on
linenumberNoThe line of the blob to comment on
sidestringNoSide of the diff to comment on
subjectTypestringNoWhether the comment is on a line or file

github_reply_to_pull_request_comment

Reply to an existing review comment on a pull request Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number
commentIdnumberYesThe ID of the review comment to reply to
bodystringYesReply body

github_search_issues

Search issues across GitHub repositories using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like repo:owner/name, state:open, label:bug, assignee:username, etc. Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesGitHub search query string. Supports qualifiers like repo:owner/name, state:open, label:bug, assignee:username, is:issue
sortstringNoSort field for results
orderstringNo"desc"Sort order
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_search_pull_requests

Search pull requests across GitHub repositories using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like repo:owner/name, state:open, label:bug, author:username, is:pr, etc. Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesGitHub search query string. Supports qualifiers like repo:owner/name, state:open, label:bug, author:username, is:pr
sortstringNoSort field for results
orderstringNo"desc"Sort order
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_search_code

Search code across GitHub repositories using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like repo:owner/name, language:javascript, filename:test, extension:ts, etc. Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesGitHub search query string. Supports qualifiers like repo:owner/name, language:javascript, filename:test, extension:ts, path:src
sortstringNoSort field for results (only “indexed” is supported)
orderstringNo"desc"Sort order
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_search_users

Search users on GitHub using GitHub search syntax. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Use qualifiers like type:user, type:org, location:city, language:javascript, followers:>100, etc. Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesGitHub search query string. Supports qualifiers like type:user, type:org, location:city, language:javascript, followers:>100
sortstringNoSort field for results
orderstringNo"desc"Sort order
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_list_workflows

List all workflows in a GitHub repository (GitHub Actions workflow files). IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_get_workflow

Get a specific workflow by ID or filename Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
workflowIdstringYesWorkflow ID (number) or workflow file name (string, e.g. “ci.yml”)

github_list_workflow_runs

List workflow runs for a repository, optionally filtered by workflow, actor, branch, event, or status. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
workflowIdstringNoFilter by workflow ID (number) or workflow file name (string, e.g. “ci.yml”)
actorstringNoFilter by the user who triggered the run
branchstringNoFilter by branch name
eventstringNoFilter by event type (e.g. push, pull_request)
statusstringNoFilter by run status
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_get_workflow_run

Get a specific workflow run by ID Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
runIdnumberYesWorkflow run ID

github_list_workflow_jobs

List jobs for a specific workflow run. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
runIdnumberYesWorkflow run ID
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_get_workflow_job

Get a specific workflow job by ID Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
jobIdnumberYesJob ID

github_run_workflow

Trigger a workflow dispatch event to run a GitHub Actions workflow. The workflow must have a workflow_dispatch trigger configured. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
workflowIdstringYesWorkflow ID (number) or workflow file name (string, e.g. “ci.yml”)
refstringYesGit reference (branch or tag) to run the workflow on
inputsobjectNoInput key-value pairs for the workflow_dispatch event

github_get_job_logs

Download logs for a specific workflow job Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
jobIdnumberYesJob ID

github_cancel_workflow_run

Cancel a workflow run that is in progress or queued Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
runIdnumberYesWorkflow run ID to cancel

github_rerun_workflow

Re-run an entire workflow run Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
runIdnumberYesWorkflow run ID to re-run

github_rerun_failed_jobs

Re-run only the failed jobs in a workflow run (instead of the entire run) Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
runIdnumberYesWorkflow run ID to re-run failed jobs for

github_list_workflow_run_artifacts

List artifacts produced by a workflow run. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
runIdnumberYesWorkflow run ID
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_download_workflow_run_artifact

Get a download URL for a workflow run artifact. Returns a redirect URL to download the artifact archive (ZIP). Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
artifactIdnumberYesArtifact ID to download

github_get_label

Get a specific label by name from a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
namestringYesLabel name

github_list_labels

List all labels in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_create_label

Create a new label in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
namestringYesLabel name
colorstringYesLabel color as hex string without the # prefix (e.g. “ff0000” for red)
descriptionstringNoLabel description

github_update_label

Update an existing label in a GitHub repository. Can change name, color, and/or description. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
namestringYesCurrent label name
newNamestringNoNew label name
colorstringNoNew label color as hex string without the # prefix (e.g. “ff0000” for red)
descriptionstringNoNew label description

github_delete_label

Delete a label from a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
namestringYesLabel name to delete

github_list_releases

List releases in a GitHub repository, ordered by creation date. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_get_latest_release

Get the latest published release in a GitHub repository (excludes drafts and pre-releases) Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name

github_get_release_by_tag

Get a specific release by its tag name Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
tagstringYesTag name (e.g. “v1.0.0”)

github_list_tags

List tags in a GitHub repository. IMPORTANT: This tool paginates. Results may be incomplete. Always check pagination.hasMore in the response — if true, you MUST call again with the next page number to get all results. Do not report results as complete without checking pagination.hasMore. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
perPagenumberNo30Number of results per page (max 100)
pagenumberNoPage number for pagination (default: 1)

github_get_tag

Get an annotated tag object by its SHA. Use this to get details like the tag message and tagger information. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
tagShastringYesThe SHA of the annotated tag object

github_get_repository_tree

Get a repository tree (directory listing) recursively or non-recursively. Use HEAD as the treeSha to get the default branch tree, or provide a specific branch name or tree SHA. Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization)
repostringYesRepository name
treeShastringYesSHA of the tree or branch name (use HEAD for default branch)
recursivebooleanNofalseWhether to recursively list all files in subdirectories. Warning: large repos may be truncated.

github_list_trigger_capabilities

List available trigger types that can be created for GitHub webhooks

github_create_trigger

Create a GitHub webhook that will send events Parameters:
ParameterTypeRequiredDefaultDescription
triggerTypestringYesType of trigger to create
webhookUrlstringYesThe webhook URL where GitHub should send events
repositorystringYesRepository in owner/name format (e.g., “octocat/hello-world”). Tip: Use github_list_repositories to see repositories you have access to.
eventsanyYesEvent types to subscribe to. Common: push, pull_request, issues, issue_comment, release. Can be passed as JSON string array or array.
secretstringNoOptional webhook secret for signature verification (auto-generated if not provided)

github_update_trigger

Update an existing GitHub webhook (only supports updating events list) Parameters:
ParameterTypeRequiredDefaultDescription
webhookIdstringYesThe GitHub webhook ID to update
ownerstringYesRepository owner (username or organization). Tip: Use github_list_repositories to see repositories you have access to.
repostringYesRepository name. Tip: Use github_list_repositories to find the repository.
eventsanyYesArray of event types to subscribe to. Can be passed as JSON string array or array.
activebooleanNotrueWhether the webhook is active

github_delete_trigger

Delete a GitHub webhook Parameters:
ParameterTypeRequiredDefaultDescription
triggerIdstringYesThe ID of the webhook to delete
ownerstringNoRepository owner (required if not in metadata from trigger creation)
repostringNoRepository name (required if not in metadata from trigger creation)
webhookIdstringNoOptional webhook ID (if not provided, will use triggerId)