actions_get4 paramsGet details about specific GitHub Actions resources. Use this tool to get details about individual workflows, workflow runs, jobs, and ar…
Get details about specific GitHub Actions resources. Use this tool to get details about individual workflows, workflow runs, jobs, and artifacts by their unique IDs.
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
method | string | The method to execute |
resource_id | string | The unique identifier of the resource. This will vary based on the "method" provided, so ensure you provide the correct ID: - Provide a workflow ID or workflow file name (e.g. ci.yaml) for 'get_workfl |
actions_list8 paramsTools for listing GitHub Actions resources. Use this tool to list workflows in a repository, or list workflow runs, jobs, and artifacts f…
Tools for listing GitHub Actions resources. Use this tool to list workflows in a repository, or list workflow runs, jobs, and artifacts for a specific workflow or workflow run.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (default: 1) |
repo | string | Repository name |
owner | string | Repository owner |
method | string | The action to perform |
per_page | number | Results per page for pagination (default: 30, max: 100) |
resource_id | string | The unique identifier of the resource. This will vary based on the "method" provided, so ensure you provide the correct ID: - Do not provide any resource ID for 'list_workflows' method. - Provide a wo |
workflow_jobs_filter | object | Filters for workflow jobs. **ONLY** used when method is 'list_workflow_jobs' |
workflow_runs_filter | object | Filters for workflow runs. **ONLY** used when method is 'list_workflow_runs' |
actions_run_trigger7 paramsTrigger GitHub Actions workflow operations, including running, re-running, cancelling workflow runs, and deleting workflow run logs.
| Parameter | Type | Description |
|---|
ref | string | The git reference for the workflow. The reference can be a branch or tag name. Required for 'run_workflow' method. |
repo | string | Repository name |
owner | string | Repository owner |
inputs | object | Inputs the workflow accepts. Only used for 'run_workflow' method. |
method | string | The method to execute |
run_id | number | The ID of the workflow run. Required for all methods except 'run_workflow'. |
workflow_id | string | The workflow ID (numeric) or workflow file name (e.g., main.yml, ci.yaml). Required for 'run_workflow' method. |
add_comment_to_pending_review10 paramsAdd review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check wit…
Add review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).
| Parameter | Type | Description |
|---|
body | string | The text of the review comment |
line | number | The line of the blob in the pull request diff that the comment applies to. For multi-line comments, the last line of the range |
path | string | The relative path to the file that necessitates a comment |
repo | string | Repository name |
side | string | The side of the diff to comment on. LEFT indicates the previous state, RIGHT indicates the new state |
owner | string | Repository owner |
startLine | number | For multi-line comments, the first line of the range that the comment applies to |
startSide | string | For multi-line comments, the starting side of the diff that the comment applies to. LEFT indicates the previous state, RIGHT indicates the new state |
pullNumber | number | Pull request number |
subjectType | string | The level at which the comment is targeted |
add_issue_comment4 paramsAdd a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull …
Add a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull request number as issue_number), but only if user is not asking specifically to add review comments.
| Parameter | Type | Description |
|---|
body | string | Comment content |
repo | string | Repository name |
owner | string | Repository owner |
issue_number | number | Issue number to comment on |
add_reply_to_pull_request_comment5 paramsAdd a reply to an existing pull request comment. This creates a new comment that is linked as a reply to the specified comment.
| Parameter | Type | Description |
|---|
body | string | The text of the reply |
repo | string | Repository name |
owner | string | Repository owner |
commentId | number | The ID of the comment to reply to |
pullNumber | number | Pull request number |
assign_copilot_to_issue5 paramsAssign Copilot to a specific issue in a GitHub repository. This tool can help with the following outcomes: - a Pull Request created with …
Assign Copilot to a specific issue in a GitHub repository. This tool can help with the following outcomes: - a Pull Request created with source code changes to resolve the issue More information can be found at: - https://docs.github.com/en/copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/about-assigning-tasks-to-copilot
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
base_ref | string | Git reference (e.g., branch) that the agent will start its work from. If not specified, defaults to the repository's default branch |
issue_number | number | Issue number |
custom_instructions | string | Optional custom instructions to guide the agent beyond the issue body. Use this to provide additional context, constraints, or guidance that is not captured in the issue description |
create_branch4 paramsCreate a new branch in a GitHub repository
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
branch | string | Name for new branch |
from_branch | string | Source branch (defaults to repo default) |
create_gist4 paramsCreate a new gist
| Parameter | Type | Description |
|---|
public | boolean | Whether the gist is public |
content | string | Content for simple single-file gist creation |
filename | string | Filename for simple single-file gist creation |
description | string | Description of the gist |
create_or_update_file7 paramsCreate or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this t…
Create or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this tool to create or update a file in a GitHub repository remotely; do not use it for local file operations. In order to obtain the SHA of original file version before updating, use the following git command: git rev-parse <branch>:<path to file> SHA MUST be provided for existing file updates.
| Parameter | Type | Description |
|---|
sha | string | The blob SHA of the file being replaced. Required if the file already exists. |
path | string | Path where to create/update the file |
repo | string | Repository name |
owner | string | Repository owner (username or organization) |
branch | string | Branch to create/update the file in |
content | string | Content of the file |
message | string | Commit message |
create_pull_request8 paramsCreate a new pull request in a GitHub repository.
| Parameter | Type | Description |
|---|
base | string | Branch to merge into |
body | string | PR description |
head | string | Branch containing changes |
repo | string | Repository name |
draft | boolean | Create as draft PR |
owner | string | Repository owner |
title | string | PR title |
maintainer_can_modify | boolean | Allow maintainer edits |
create_pull_request_with_copilot5 paramsDelegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation…
Delegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation. You should use this tool if the user asks to create a pull request to perform a specific task, or if the user asks Copilot to do something.
| Parameter | Type | Description |
|---|
repo | string | Repository name. You can guess the repository name, but confirm it with the user before proceeding. |
owner | string | Repository owner. You can guess the owner, but confirm it with the user before proceeding. |
title | string | Title for the pull request that will be created |
base_ref | string | Git reference (e.g., branch) that the agent will start its work from. If not specified, defaults to the repository's default branch |
problem_statement | string | Detailed description of the task to be performed (e.g., 'Implement a feature that does X', 'Fix bug Y', etc.) |
create_repository5 paramsCreate a new GitHub repository in your account or specified organization
| Parameter | Type | Description |
|---|
name | string | Repository name |
private | boolean | Whether repo should be private |
autoInit | boolean | Initialize with README |
description | string | Repository description |
organization | string | Organization to create the repository in (omit to create in your personal account) |
delete_file5 paramsDelete a file from a GitHub repository
| Parameter | Type | Description |
|---|
path | string | Path to the file to delete |
repo | string | Repository name |
owner | string | Repository owner (username or organization) |
branch | string | Branch to delete the file from |
message | string | Commit message |
dismiss_notification2 paramsDismiss a notification by marking it as read or done
| Parameter | Type | Description |
|---|
state | string | The new state of the notification (read/done) |
threadID | string | The ID of the notification thread |
fork_repository3 paramsFork a GitHub repository to your account or specified organization
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
organization | string | Organization to fork to |
get_code_scanning_alert3 paramsGet details of a specific code scanning alert in a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
owner | string | The owner of the repository. |
alertNumber | number | The number of the alert. |
get_commit6 paramsGet details for a commit from a GitHub repository
| Parameter | Type | Description |
|---|
sha | string | Commit SHA, branch name, or tag name |
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
owner | string | Repository owner |
perPage | number | Results per page for pagination (min 1, max 100) |
include_diff | boolean | Whether to include file diffs and stats in the response. Default is true. |
get_copilot_job_status3 paramsGet the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull r…
Get the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull request URL once it's created. Provide the job ID (from create_pull_request_with_copilot) or pull request number (from assign_copilot_to_issue), or any pull request you want agent sessions for.
| Parameter | Type | Description |
|---|
id | string | Job ID or pull request number |
repo | string | Repository name |
owner | string | Repository owner |
get_copilot_space2 paramsThis tool can be used to provide additional context to the chat from a specific Copilot space. If the user mentions the keyword 'Copilot …
This tool can be used to provide additional context to the chat from a specific Copilot space. If the user mentions the keyword 'Copilot space' with the name and owner of the space, execute this tool. The response includes a table of contents (TOC) listing all documents in the space, followed by the full content of each document. Documents are separated by markers in the format: '--- Document N: path (size) ---'. When searching for specific information, use grep (or equivalent command) to search
| Parameter | Type | Description |
|---|
name | string | The name of the space |
owner | string | The owner of the space |
get_dependabot_alert3 paramsGet details of a specific dependabot alert in a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
owner | string | The owner of the repository. |
alertNumber | number | The number of the alert. |
get_discussion3 paramsGet a specific discussion by ID
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
discussionNumber | number | Discussion Number |
get_discussion_comments5 paramsGet comments from a discussion
| Parameter | Type | Description |
|---|
repo | string | Repository name |
after | string | Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. |
owner | string | Repository owner |
perPage | number | Results per page for pagination (min 1, max 100) |
discussionNumber | number | Discussion Number |
get_file_contents5 paramsGet the contents of a file or directory from a GitHub repository
| Parameter | Type | Description |
|---|
ref | string | Accepts optional git refs such as `refs/tags/{tag}`, `refs/heads/{branch}` or `refs/pull/{pr_number}/head` |
sha | string | Accepts optional commit SHA. If specified, it will be used instead of ref |
path | string | Path to file/directory |
repo | string | Repository name |
owner | string | Repository owner (username or organization) |
get_gist1 paramGet gist content of a particular gist, by gist ID
| Parameter | Type | Description |
|---|
gist_id | string | The ID of the gist |
get_global_security_advisory1 paramGet a global security advisory
| Parameter | Type | Description |
|---|
ghsaId | string | GitHub Security Advisory ID (format: GHSA-xxxx-xxxx-xxxx). |
get_job_logs7 paramsGet logs for GitHub Actions workflow jobs. Use this tool to retrieve logs for a specific job or all failed jobs in a workflow run. For si…
Get logs for GitHub Actions workflow jobs. Use this tool to retrieve logs for a specific job or all failed jobs in a workflow run. For single job logs, provide job_id. For all failed jobs in a run, provide run_id with failed_only=true.
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
job_id | number | The unique identifier of the workflow job. Required when getting logs for a single job. |
run_id | number | The unique identifier of the workflow run. Required when failed_only is true to get logs for all failed jobs in the run. |
tail_lines | number | Number of lines to return from the end of the log |
failed_only | boolean | When true, gets logs for all failed jobs in the workflow run specified by run_id. Requires run_id to be provided. |
return_content | boolean | Returns actual log content instead of URLs |
get_label3 paramsGet a specific label from a repository.
| Parameter | Type | Description |
|---|
name | string | Label name. |
repo | string | Repository name |
owner | string | Repository owner (username or organization name) |
get_latest_release2 paramsGet the latest release in a GitHub repository
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
get_meGet details of the authenticated GitHub user. Use this when a request is about the user's own profile for GitHub. Or when information is …
Get details of the authenticated GitHub user. Use this when a request is about the user's own profile for GitHub. Or when information is missing to build other tool calls.
get_notification_details1 paramGet detailed information for a specific GitHub notification, always call this tool when the user asks for details about a specific notifi…
Get detailed information for a specific GitHub notification, always call this tool when the user asks for details about a specific notification, if you don't know the ID list notifications first.
| Parameter | Type | Description |
|---|
notificationID | string | The ID of the notification |
get_release_by_tag3 paramsGet a specific release by its tag name in a GitHub repository
| Parameter | Type | Description |
|---|
tag | string | Tag name (e.g., 'v1.0.0') |
repo | string | Repository name |
owner | string | Repository owner |
get_repository_tree5 paramsGet the tree structure (files and directories) of a GitHub repository at a specific ref or SHA
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner (username or organization) |
tree_sha | string | The SHA1 value or ref (branch or tag) name of the tree. Defaults to the repository's default branch |
recursive | boolean | Setting this parameter to true returns the objects or subtrees referenced by the tree. Default is false |
path_filter | string | Optional path prefix to filter the tree results (e.g., 'src/' to only show files in the src directory) |
get_secret_scanning_alert3 paramsGet details of a specific secret scanning alert in a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
owner | string | The owner of the repository. |
alertNumber | number | The number of the alert. |
get_tag3 paramsGet details about a specific git tag in a GitHub repository
| Parameter | Type | Description |
|---|
tag | string | Tag name |
repo | string | Repository name |
owner | string | Repository owner |
get_team_members2 paramsGet member usernames of a specific team in an organization. Limited to organizations accessible with current credentials
| Parameter | Type | Description |
|---|
org | string | Organization login (owner) that contains the team. |
team_slug | string | Team slug |
get_teams1 paramGet details of the teams the user is a member of. Limited to organizations accessible with current credentials
| Parameter | Type | Description |
|---|
user | string | Username to get teams for. If not provided, uses the authenticated user. |
github_support_docs_search1 paramRetrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authent…
Retrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilot Spaces
| Parameter | Type | Description |
|---|
query | string | Input from the user about the question they need answered. This is the latest raw unedited user message. You should ALWAYS leave the user message as it is, you should never modify it. |
issue_read6 paramsGet information about a specific issue in a GitHub repository.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | The name of the repository |
owner | string | The owner of the repository |
method | string | The read operation to perform on a single issue. Options are: 1. get - Get details of a specific issue. 2. get_comments - Get issue comments. 3. get_sub_issues - Get sub-issues of the issue. 4. get_la |
perPage | number | Results per page for pagination (min 1, max 100) |
issue_number | number | The number of the issue |
issue_write12 paramsCreate a new or update an existing issue in a GitHub repository.
| Parameter | Type | Description |
|---|
body | string | Issue body content |
repo | string | Repository name |
type | string | Type of this issue. Only use if the repository has issue types configured. Use list_issue_types tool to get valid type values for the organization. If the repository doesn't support issue types, omit |
owner | string | Repository owner |
state | string | New state |
title | string | Issue title |
labels | array | Labels to apply to this issue |
method | string | Write operation to perform on a single issue. Options are: - 'create' - creates a new issue. - 'update' - updates an existing issue. |
assignees | array | Usernames to assign to this issue |
milestone | number | Milestone number |
duplicate_of | number | Issue number that this issue is a duplicate of. Only used when state_reason is 'duplicate'. |
issue_number | number | Issue number to update |
label_write7 paramsPerform write operations on repository labels. To set labels on issues, use the 'update_issue' tool.
| Parameter | Type | Description |
|---|
name | string | Label name - required for all operations |
repo | string | Repository name |
color | string | Label color as 6-character hex code without '#' prefix (e.g., 'f29513'). Required for 'create', optional for 'update'. |
owner | string | Repository owner (username or organization name) |
method | string | Operation to perform: 'create', 'update', or 'delete' |
new_name | string | New name for the label (used only with 'update' method to rename) |
description | string | Label description text. Optional for 'create' and 'update'. |
list_branches4 paramsList branches in a GitHub repository
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
owner | string | Repository owner |
perPage | number | Results per page for pagination (min 1, max 100) |
list_code_scanning_alerts6 paramsList code scanning alerts in a GitHub repository.
| Parameter | Type | Description |
|---|
ref | string | The Git reference for the results you want to list. |
repo | string | The name of the repository. |
owner | string | The owner of the repository. |
state | string | Filter code scanning alerts by state. Defaults to open |
severity | string | Filter code scanning alerts by severity |
tool_name | string | The name of the tool used for code scanning. |
list_commits6 paramsGet list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified…
Get list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified using the perPage parameter (up to 100).
| Parameter | Type | Description |
|---|
sha | string | Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch of the repository. If a commit SHA is provided, will list commits up to that SHA. |
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
owner | string | Repository owner |
author | string | Author username or email address to filter commits by |
perPage | number | Results per page for pagination (min 1, max 100) |
list_copilot_spacesRetrieves the list of Copilot Spaces accessible to the user, including their names and owners.
list_dependabot_alerts4 paramsList dependabot alerts in a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
owner | string | The owner of the repository. |
state | string | Filter dependabot alerts by state. Defaults to open |
severity | string | Filter dependabot alerts by severity |
list_discussion_categories2 paramsList discussion categories with their id and name, for a repository or organisation.
| Parameter | Type | Description |
|---|
repo | string | Repository name. If not provided, discussion categories will be queried at the organisation level. |
owner | string | Repository owner |
list_discussions7 paramsList discussions for a repository or organisation.
| Parameter | Type | Description |
|---|
repo | string | Repository name. If not provided, discussions will be queried at the organisation level. |
after | string | Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. |
owner | string | Repository owner |
orderBy | string | Order discussions by field. If provided, the 'direction' also needs to be provided. |
perPage | number | Results per page for pagination (min 1, max 100) |
category | string | Optional filter by discussion category ID. If provided, only discussions with this category are listed. |
direction | string | Order direction. |
list_gists4 paramsList gists for a user
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
since | string | Only gists updated after this time (ISO 8601 timestamp) |
perPage | number | Results per page for pagination (min 1, max 100) |
username | string | GitHub username (omit for authenticated user's gists) |
list_global_security_advisories11 paramsList global security advisories from GitHub.
| Parameter | Type | Description |
|---|
cwes | array | Filter by Common Weakness Enumeration IDs (e.g. ["79", "284", "22"]). |
type | string | Advisory type. |
cveId | string | Filter by CVE ID. |
ghsaId | string | Filter by GitHub Security Advisory ID (format: GHSA-xxxx-xxxx-xxxx). |
affects | string | Filter advisories by affected package or version (e.g. "package1,package2@1.0.0"). |
updated | string | Filter by update date or date range (ISO 8601 date or range). |
modified | string | Filter by publish or update date or date range (ISO 8601 date or range). |
severity | string | Filter by severity. |
ecosystem | string | Filter by package ecosystem. |
published | string | Filter by publish date or date range (ISO 8601 date or range). |
isWithdrawn | boolean | Whether to only return withdrawn advisories. |
list_issue_types1 paramList supported issue types for repository owner (organization).
| Parameter | Type | Description |
|---|
owner | string | The organization owner of the repository |
list_issues9 paramsList issues in a GitHub repository. For pagination, use the 'endCursor' from the previous response's 'pageInfo' in the 'after' parameter.
| Parameter | Type | Description |
|---|
repo | string | Repository name |
after | string | Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. |
owner | string | Repository owner |
since | string | Filter by date (ISO 8601 timestamp) |
state | string | Filter by state, by default both open and closed issues are returned when not provided |
labels | array | Filter by labels |
orderBy | string | Order issues by field. If provided, the 'direction' also needs to be provided. |
perPage | number | Results per page for pagination (min 1, max 100) |
direction | string | Order direction. If provided, the 'orderBy' also needs to be provided. |
list_label2 paramsList labels from a repository
| Parameter | Type | Description |
|---|
repo | string | Repository name - required for all operations |
owner | string | Repository owner (username or organization name) - required for all operations |
list_notifications7 paramsLists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and up…
Lists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and updates on issues or pull requests. Use this tool whenever the user asks what to work on next, requests a summary of their GitHub activity, wants to see pending reviews, or needs to check for new updates or tasks. This tool is the primary way to discover actionable items, reminders, and outstanding work on GitHub. Always call this tool when asked what to work on
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Optional repository name. If provided with owner, only notifications for this repository are listed. |
owner | string | Optional repository owner. If provided with repo, only notifications for this repository are listed. |
since | string | Only show notifications updated after the given time (ISO 8601 format) |
before | string | Only show notifications updated before the given time (ISO 8601 format) |
filter | string | Filter notifications to, use default unless specified. Read notifications are ones that have already been acknowledged by the user. Participating notifications are those that the user is directly invo |
perPage | number | Results per page for pagination (min 1, max 100) |
list_org_repository_security_advisories4 paramsList repository security advisories for a GitHub organization.
| Parameter | Type | Description |
|---|
org | string | The organization login. |
sort | string | Sort field. |
state | string | Filter by advisory state. |
direction | string | Sort direction. |
list_pull_requests9 paramsList pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests to…
List pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests tool instead.
| Parameter | Type | Description |
|---|
base | string | Filter by base branch |
head | string | Filter by head user/org and branch |
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
sort | string | Sort by |
owner | string | Repository owner |
state | string | Filter by state |
perPage | number | Results per page for pagination (min 1, max 100) |
direction | string | Sort direction |
list_releases4 paramsList releases in a GitHub repository
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
owner | string | Repository owner |
perPage | number | Results per page for pagination (min 1, max 100) |
list_repository_security_advisories5 paramsList repository security advisories for a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
sort | string | Sort field. |
owner | string | The owner of the repository. |
state | string | Filter by advisory state. |
direction | string | Sort direction. |
list_secret_scanning_alerts5 paramsList secret scanning alerts in a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
owner | string | The owner of the repository. |
state | string | Filter by state |
resolution | string | Filter by resolution |
secret_type | string | A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter. |
list_starred_repositories5 paramsList starred repositories
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
sort | string | How to sort the results. Can be either 'created' (when the repository was starred) or 'updated' (when the repository was last pushed to). |
perPage | number | Results per page for pagination (min 1, max 100) |
username | string | Username to list starred repositories for. Defaults to the authenticated user. |
direction | string | The direction to sort the results by. |
list_tags4 paramsList git tags in a GitHub repository
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
owner | string | Repository owner |
perPage | number | Results per page for pagination (min 1, max 100) |
manage_notification_subscription2 paramsManage a notification subscription: ignore, watch, or delete a notification thread subscription.
| Parameter | Type | Description |
|---|
action | string | Action to perform: ignore, watch, or delete the notification subscription. |
notificationID | string | The ID of the notification thread. |
manage_repository_notification_subscription3 paramsManage a repository notification subscription: ignore, watch, or delete repository notifications subscription for the provided repository.
| Parameter | Type | Description |
|---|
repo | string | The name of the repository. |
owner | string | The account owner of the repository. |
action | string | Action to perform: ignore, watch, or delete the repository notification subscription. |
mark_all_notifications_read3 paramsMark all notifications as read
| Parameter | Type | Description |
|---|
repo | string | Optional repository name. If provided with owner, only notifications for this repository are marked as read. |
owner | string | Optional repository owner. If provided with repo, only notifications for this repository are marked as read. |
lastReadAt | string | Describes the last point that notifications were checked (optional). Default: Now |
merge_pull_request6 paramsMerge a pull request in a GitHub repository.
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
pullNumber | number | Pull request number |
commit_title | string | Title for merge commit |
merge_method | string | Merge method |
commit_message | string | Extra detail for merge commit |
projects_get8 paramsGet details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project…
Get details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project items by their unique IDs.
| Parameter | Type | Description |
|---|
owner | string | The owner (user or organization login). The name is not case sensitive. |
fields | array | Specific list of field IDs to include in the response when getting a project item (e.g. ["102589", "985201", "169875"]). If not provided, only the title field is included. Only used for 'get_project_i |
method | string | The method to execute |
item_id | number | The item's ID. Required for 'get_project_item' method. |
field_id | number | The field's ID. Required for 'get_project_field' method. |
owner_type | string | Owner type (user or org). If not provided, will be automatically detected. |
project_number | number | The project's number. |
status_update_id | string | The node ID of the project status update. Required for 'get_project_status_update' method. |
projects_list9 paramsTools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items …
Tools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items for a specific project.
| Parameter | Type | Description |
|---|
after | string | Forward pagination cursor from previous pageInfo.nextCursor. |
owner | string | The owner (user or organization login). The name is not case sensitive. |
query | string | Filter/query string. For list_projects: filter by title text and state (e.g. "roadmap is:open"). For list_project_items: advanced filtering using GitHub's project filtering syntax. |
before | string | Backward pagination cursor from previous pageInfo.prevCursor (rare). |
fields | array | Field IDs to include when listing project items (e.g. ["102589", "985201"]). CRITICAL: Always provide to get field values. Without this, only titles returned. Only used for 'list_project_items' method |
method | string | The action to perform |
per_page | number | Results per page (max 50) |
owner_type | string | Owner type (user or org). If not provided, will automatically try both. |
project_number | number | The project's number. Required for 'list_project_fields', 'list_project_items', and 'list_project_status_updates' methods. |
projects_write12 paramsAdd, update, or delete project items, or create status updates in a GitHub Project.
| Parameter | Type | Description |
|---|
body | string | The body of the status update (markdown). Used for 'create_project_status_update' method. |
owner | string | The project owner (user or organization login). The name is not case sensitive. |
method | string | The method to execute |
status | string | The status of the project. Used for 'create_project_status_update' method. |
item_id | number | The project item ID. Required for 'update_project_item' and 'delete_project_item' methods. |
item_repo | string | The name of the repository containing the issue or pull request. Required for 'add_project_item' method. |
item_type | string | The item's type, either issue or pull_request. Required for 'add_project_item' method. |
item_owner | string | The owner (user or organization) of the repository containing the issue or pull request. Required for 'add_project_item' method. |
owner_type | string | Owner type (user or org). If not provided, will be automatically detected. |
start_date | string | The start date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. |
target_date | string | The target date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. |
issue_number | number | The issue number (use when item_type is 'issue' for 'add_project_item' method). Provide either issue_number or pull_request_number. |
pull_request_read6 paramsGet information on a specific pull request in GitHub repository.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Repository name |
owner | string | Repository owner |
method | string | Action to specify what pull request data needs to be retrieved from GitHub. Possible options: 1. get - Get details of a specific pull request. 2. get_diff - Get the diff of a pull request. 3. get_stat |
perPage | number | Results per page for pagination (min 1, max 100) |
pullNumber | number | Pull request number |
pull_request_review_write7 paramsCreate and/or submit, delete review of a pull request. Available methods: - create: Create a new review of a pull request. If "event" par…
Create and/or submit, delete review of a pull request. Available methods: - create: Create a new review of a pull request. If "event" parameter is provided, the review is submitted. If "event" is omitted, a pending review is created. - submit_pending: Submit an existing pending review of a pull request. This requires that a pending review exists for the current user on the specified pull request. The "body" and "event" parameters are used when submitting the review. - delete_pending: Delete an e
| Parameter | Type | Description |
|---|
body | string | Review comment text |
repo | string | Repository name |
event | string | Review action to perform. |
owner | string | Repository owner |
method | string | The write operation to perform on pull request review. |
commitID | string | SHA of commit to review |
pullNumber | number | Pull request number |
push_files5 paramsPush multiple files to a GitHub repository in a single commit
| Parameter | Type | Description |
|---|
repo | string | Repository name |
files | array | Array of file objects to push, each object with path (string) and content (string) |
owner | string | Repository owner |
branch | string | Branch to push to |
message | string | Commit message |
request_copilot_review3 paramsRequest a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a hu…
Request a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a human reviewer.
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |
pullNumber | number | Pull request number |
run_secret_scanning3 paramsScan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials. This tool is intended for target…
Scan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials. This tool is intended for targeted scans of specific files, snippets, or diffs provided directly as content. It accepts file contents or diffs and returns detected secrets with their locations and related secret scanning metadata. Content must not be empty. For full repository scanning, other mechanisms are available. Caveats: - Only files within the codebase should be scanned. Files outside
| Parameter | Type | Description |
|---|
repo | string | Repository name |
files | array | Array of file contents, snippets, or diff hunks to scan for secrets. These must be raw contents, not repository file paths. |
owner | string | Repository owner |
search_code5 paramsFast and precise code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, function…
Fast and precise code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, functions, classes, or specific code patterns.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
sort | string | Sort field ('indexed' only) |
order | string | Sort order for results |
query | string | Search query using GitHub's powerful code search syntax. Examples: 'content:Skill language:Java org:github', 'NOT is:archived language:Python OR language:go', 'repo:github/github-mcp-server'. Supports |
perPage | number | Results per page for pagination (min 1, max 100) |
search_issues7 paramsSearch for issues in GitHub repositories using issues search syntax already scoped to is:issue
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Optional repository name. If provided with owner, only issues for this repository are listed. |
sort | string | Sort field by number of matches of categories, defaults to best match |
order | string | Sort order |
owner | string | Optional repository owner. If provided with repo, only issues for this repository are listed. |
query | string | Search query using GitHub issues search syntax |
perPage | number | Results per page for pagination (min 1, max 100) |
search_orgs5 paramsFind GitHub organizations by name, location, or other organization metadata. Ideal for discovering companies, open source foundations, or…
Find GitHub organizations by name, location, or other organization metadata. Ideal for discovering companies, open source foundations, or teams.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
sort | string | Sort field by category |
order | string | Sort order |
query | string | Organization search query. Examples: 'microsoft', 'location:california', 'created:>=2025-01-01'. Search is automatically scoped to type:org. |
perPage | number | Results per page for pagination (min 1, max 100) |
search_pull_requests7 paramsSearch for pull requests in GitHub repositories using issues search syntax already scoped to is:pr
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
repo | string | Optional repository name. If provided with owner, only pull requests for this repository are listed. |
sort | string | Sort field by number of matches of categories, defaults to best match |
order | string | Sort order |
owner | string | Optional repository owner. If provided with repo, only pull requests for this repository are listed. |
query | string | Search query using GitHub pull request search syntax |
perPage | number | Results per page for pagination (min 1, max 100) |
search_repositories6 paramsFind GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or …
Find GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or locating specific repositories across GitHub.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
sort | string | Sort repositories by field, defaults to best match |
order | string | Sort order |
query | string | Repository search query. Examples: 'machine learning in:name stars:>1000 language:python', 'topic:react', 'user:facebook'. Supports advanced search syntax for precise filtering. |
perPage | number | Results per page for pagination (min 1, max 100) |
minimal_output | boolean | Return minimal repository information (default: true). When false, returns full GitHub API repository objects. |
search_users5 paramsFind GitHub users by username, real name, or other profile information. Useful for locating developers, contributors, or team members.
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (min 1) |
sort | string | Sort users by number of followers or repositories, or when the person joined GitHub. |
order | string | Sort order |
query | string | User search query. Examples: 'john smith', 'location:seattle', 'followers:>100'. Search is automatically scoped to type:user. |
perPage | number | Results per page for pagination (min 1, max 100) |
star_repository2 paramsStar a GitHub repository
| Parameter | Type | Description |
|---|
repo | string | Repository name |
owner | string | Repository owner |