Content: Example List of Commands and Prompts

[D1M1TR10S]

Prompt and Command Examples Docs Page or Article

Right now, there’s no centralized list of the commands or tools supported by the GitHub MCP server (e.g., what an agent can do when connected). Users often discover them through trial and error, browsing the tool list, and submitting exploratory prompts. Got several asks for this on different social channels.

Possible solution

A simple markdown file, blog post, or docs page that lists supported commands, ideally grouped by use case (e.g., issues, PRs, repos). Specify which modes they work in (chat vs. agent). Could be auto-generated or hand-maintained.

Additional context

Example tools users often ask about:

• listRepos
• getIssue
• createPullRequest
• commentOnIssue

[tonytrg]

I think automating the doc process is the way to go for now, to have an updated list of available tooling set #223

[jadbox]

Not sure if this is helpful (@tonytrg @D1M1TR10S ), but maybe until the process is automated, I've generated this Markdown file of all the listed MCP interfaces just from using code search points.

This list is based on available information and may be incomplete. To view all MCP interface functions refer to the search results for mcp.NewTool.

# MCP Exposed Functions

This document lists the MCP interface functions ("tools") currently exposed by the `github-mcp-server`. Each function includes a name, arguments, and a description suitable for LLM consumption and developer reference. This list is based on code analysis and may not be exhaustive. For a complete/updated list, refer to the code search for MCP tools in the `github/github-mcp-server` repository.

---

## User Tools

### `get_me`
**Description:** Get details of the authenticated GitHub user. Use this when a request includes "me" or "my". The output will not change unless the user changes their profile, so only call this once per session if needed.
**Arguments:**
- `reason` (string, optional): The reason for requesting the user information.

---

## Issues Tools

### `get_issue`
**Description:** Get details of a specific issue in a GitHub repository.
**Arguments:**
- `owner` (string, required): The owner of the repository.
- `repo` (string, required): The name of the repository.
- `issue_number` (number, required): The number of the issue.

---

### `add_issue_comment`
**Description:** Add a comment to a specific issue in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `issue_number` (number, required): Issue number to comment on.
- `body` (string, required): Comment content.

---

### `search_issues`
**Description:** Search for issues in GitHub repositories using the GitHub issues search syntax.
**Arguments:**
- `q` (string, required): Search query.
- `sort` (string, optional): Sort field (e.g., "comments", "created", "updated").
- `order` (string, optional): Sort order ("asc", "desc").
- Pagination options (e.g., `page`, `perPage`).

---

### `create_issue`
**Description:** Create a new issue in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `title` (string, required): Issue title.
- `body` (string, optional): Issue body content.
- `assignees` (array of strings, optional): Usernames to assign.
- `labels` (array of strings, optional): Labels to apply.
- `milestone` (number, optional): Milestone number.

---

### `list_issues`
**Description:** List issues in a GitHub repository. Supports filtering and pagination.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `state` (string, optional): Filter by state ("open", "closed", "all"). Default: "open".
- `labels` (array of strings, optional): Filter by labels.
- `sort` (string, optional): Sort field (e.g., "created", "updated", "comments"). Default: "created".
- `direction` (string, optional): Sort direction ("asc", "desc"). Default: "desc".
- `since` (string, optional): ISO 8601 timestamp for filtering issues updated at or after this time.
- Pagination options (e.g., `page`, `perPage`).

---

### `update_issue`
**Description:** Update an existing issue in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `issue_number` (number, required): Issue number.
- `title` (string, optional): New title.
- `body` (string, optional): New description.
- `state` (string, optional): New state ("open", "closed").
- `labels` (array of strings, optional): New labels.
- `assignees` (array of strings, optional): New assignees.
- `milestone` (number, optional): New milestone number.

---

### `get_issue_comments`
**Description:** Get comments for a specific issue in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `issue_number` (number, required): Issue number.
- Pagination options (e.g., `page`, `perPage`).

---

## Pull Requests Tools

### `list_pull_requests`
**Description:** List and filter repository pull requests.
**Arguments:**
- `owner` (string, required): The owner of the repository.
- `repo` (string, required): The name of the repository.
- `state` (string, optional): Filter by state ("open", "closed", "all"). Default: "open".
- `head` (string, optional): Filter PRs by head user or head organization and branch name in the format `user:ref-name` or `organization:ref-name`.
- `base` (string, optional): Filter PRs by base branch name.
- `sort` (string, optional): Sort field ("created", "updated", "popularity", "long-running"). Default: "created".
- `direction` (string, optional): Sort direction ("asc", "desc"). Default: "desc".
- Pagination options (e.g., `page`, `perPage`).

---

## Repository Tools

### `get_commit`
**Description:** Get details for a commit from a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `sha` (string, required): Commit SHA, branch name, or tag name.
- Pagination options (e.g., `page`, `perPage` for comments if applicable).

---

### `list_commits`
**Description:** Get list of commits of a branch in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `sha` (string, optional): SHA or Branch name to start listing commits from.
- `path` (string, optional): Only commits containing this file path will be returned.
- `author` (string, optional): GitHub login or email address by which to filter commits.
- `since` (string, optional): ISO 8601 timestamp. Only commits after this date will be returned.
- `until` (string, optional): ISO 8601 timestamp. Only commits before this date will be returned.
- Pagination options (e.g., `page`, `perPage`).

---

### `list_branches`
**Description:** List branches in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `protected` (boolean, optional): Filter by branch protection status.
- Pagination options (e.g., `page`, `perPage`).

---

### `create_or_update_file`
**Description:** Create or update a single file in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `path` (string, required): File path.
- `content` (string, required): File content (Base64 encoded).
- `message` (string, required): Commit message.
- `branch` (string, required): Branch to update.
- `sha` (string, optional): SHA blob of the file being replaced (required for updates).

---

### `create_repository`
**Description:** Create a new GitHub repository in your account or an organization you have permissions for.
**Arguments:**
- `name` (string, required): Repository name.
- `description` (string, optional): Repository description.
- `private` (boolean, optional): Whether repo should be private. Default: false.
- `autoInit` (boolean, optional): Initialize with README. Default: false.
- `org` (string, optional): The organization name if creating for an organization.

---

### `get_file_contents`
**Description:** Get the contents of a file or directory from a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `path` (string, required): Path to file/directory.
- `ref` (string, optional): Branch name, tag name, or commit SHA. Default: default branch.

---

### `fork_repository`
**Description:** Fork a GitHub repository to your account or specified organization.
**Arguments:**
- `owner` (string, required): Repository owner of the upstream repository.
- `repo` (string, required): Repository name of the upstream repository.
- `organization` (string, optional): Organization login name to fork to. If omitted, forks to the authenticated user.
- `name` (string, optional): The name of the new repository.
- `default_branch_only` (boolean, optional): When true, only the default branch is copied.

---

### `delete_file`
**Description:** Delete a file from a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `path` (string, required): Path to the file to delete.
- `message` (string, required): Commit message.
- `sha` (string, required): The blob SHA of the file being deleted.
- `branch` (string, required): Branch to delete the file from.

---

### `create_branch`
**Description:** Create a new branch in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `branch` (string, required): Name for new branch.
- `sha` (string, required): SHA of the commit to base the new branch on. (Often from `from_branch`).
- `from_branch` (string, optional): Source branch to get the SHA from if `sha` is not provided directly.

---

### `push_files` (Hypothetical - details might vary based on actual implementation)
**Description:** Push multiple files to a GitHub repository in a single commit. (This often involves creating a tree, a commit, and updating a ref).
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `branch` (string, required): Branch to push to (fully qualified ref e.g., `refs/heads/main`).
- `files` (array of objects, required): Each object with `path` (string) and `content` (string - plain text, will be converted to blob).
- `message` (string, required): Commit message.
- `base_tree_sha` (string, optional): SHA of the base tree (usually commit SHA of the branch head). If not provided, it might be fetched.

---

### `list_tags`
**Description:** List git tags in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- Pagination options (e.g., `page`, `perPage`).

---

### `get_tag`
**Description:** Get details about a specific git tag (both lightweight and annotated) in a GitHub repository.
**Arguments:**
- `owner` (string, required): Repository owner.
- `repo` (string, required): Repository name.
- `tag_sha` (string, required): The SHA of the tag object.

---

## Search Tools

### `search_code`
**Description:** Search for code across GitHub repositories using GitHub code search syntax.
**Arguments:**
- `q` (string, required): Search query using GitHub code search syntax.
- `sort` (string, optional): Sort field (e.g., "indexed").
- `order` (string, optional): Sort order ("asc", "desc").
- Pagination options (e.g., `page`, `perPage`).

---

## Code Scanning Tools

### `list_code_scanning_alerts`
**Description:** List code scanning alerts in a GitHub repository.
**Arguments:**
- `owner` (string, required): The owner of the repository.
- `repo` (string, required): The name of the repository.
- `state` (string, optional): Filter code scanning alerts by state ("open", "closed", "dismissed", "fixed"). Defaults to "open".
- `ref` (string, optional): The Git reference for the results (e.g., `refs/heads/main`).
- `severity` (string, optional): Filter by severity ("critical", "high", "medium", "low", "warning", "note", "error").
- `tool_name` (string, optional): The name of the tool used for code scanning.
- Pagination options (e.g., `page`, `perPage`).

---

## Notifications Tools

### `dismiss_notification`
**Description:** Dismiss a notification by marking it as read or done by its thread ID.
**Arguments:**
- `thread_id` (string, required): The ID of the notification thread.
- `repo` (string, optional): The repository name (if dismissing a repository notification).
- `owner` (string, optional): The repository owner (if dismissing a repository notification).

---

## Toolset Management Tools

### `enable_toolset`
**Description:** Enable one of the sets of tools the GitHub MCP server provides. Use `list_available_toolsets` and `get_toolset_tools` first to see what this will enable.
**Arguments:**
- `toolset` (string, required): The name of the toolset to enable.

---

### `list_available_toolsets`
**Description:** List all available toolsets this GitHub MCP server can offer, providing the enabled status of each. Use this when a task could be achieved with a GitHub tool and the currently available tools aren't enough.
**Arguments:** None.