Skip to content

Add support for Repository Discussions #459

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 13 commits into
base: main
Choose a base branch
from
+1,057 −3
Open

Add support for Repository Discussions #459

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
e110366
feat: initial support for discussions - Minimal
xcorail May 31, 2025
6de3210
Add documentation
xcorail May 31, 2025
5a48389
Fix linting issues and improve naming consistency
xcorail May 31, 2025
647d0b3
Update README.md
xcorail May 31, 2025
2f90a60
Update README.md
xcorail May 31, 2025
e10d76a
Add missing pagination parameters to ListDiscussions
xcorail Jun 4, 2025
bc5abbd
Add answered parameter to ListDiscussions
xcorail Jun 4, 2025
ae5f1b2
Implement pagination for ListDiscussionCategories
xcorail Jun 4, 2025
58cd74d
Make ListDiscussions more user-friendly by using category name filter…
xcorail Jun 5, 2025
a77b2f4
Fix linting errors
xcorail Jun 5, 2025
0f608eb
Merge branch 'main' into main
xcorail Jun 5, 2025
4d26e31
Bump go-github to v72
xcorail Jun 5, 2025
ed76813
Merge branch 'main' into main
JoannaaKL Jul 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 66 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -269,6 +269,7 @@ The following sets of tools are available (all are on by default):
| `context` | **Strongly recommended**: Tools that provide context about the current user and GitHub context you are operating in |
| `actions` | GitHub Actions workflows and CI/CD operations |
| `code_security` | Code security related tools, such as GitHub Code Scanning |
| `discussions` | GitHub Discussions tools (list, get, comments, categories) |
| `experiments` | Experimental features that are not considered stable yet |
| `issues` | GitHub Issues related tools |
| `notifications` | GitHub Notifications related tools |
Expand Down Expand Up @@ -920,7 +921,71 @@ export GITHUB_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION="an alternative description

</details>

<details>
- **manage_repository_notification_subscription** – Manage a repository notification subscription (ignore, watch, or delete)
- `owner`: The account owner of the repository (string, required)
- `repo`: The name of the repository (string, required)
- `action`: Action to perform: `ignore`, `watch`, or `delete` (string, required)

### Discussions

- **list_discussions** - List discussions for a repository
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `category`: Filter by category name (string, optional)
- `since`: Filter by date (ISO 8601 timestamp) (string, optional)
- `first`: Pagination - Number of records to retrieve (number, optional)
- `last`: Pagination - Number of records to retrieve from the end (number, optional)
- `after`: Pagination - Cursor to start with (string, optional)
- `before`: Pagination - Cursor to end with (string, optional)
- `sort`: Sort by ('CREATED_AT', 'UPDATED_AT') (string, optional)
- `direction`: Sort direction ('ASC', 'DESC') (string, optional)
- `answered`: Filter by whether discussions have been answered or not (boolean, optional)

- **get_discussion** - Get a specific discussion by ID
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `discussionNumber`: Discussion number (required)

- **get_discussion_comments** - Get comments from a discussion
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `discussionNumber`: Discussion number (required)

- **list_discussion_categories** - List discussion categories for a repository, with their IDs and names
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `first`: Pagination - Number of categories to return per page (number, optional, min 1, max 100)
- `last`: Pagination - Number of categories to return from the end (number, optional, min 1, max 100)
- `after`: Pagination - Cursor to start with (string, optional)
- `before`: Pagination - Cursor to end with (string, optional)

## Resources

### Repository Content

- **Get Repository Content**
Retrieves the content of a repository at a specific path.

- **Template**: `repo://{owner}/{repo}/contents{/path*}`
- **Parameters**:
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `path`: File or directory path (string, optional)

- **Get Repository Content for a Specific Branch**
Retrieves the content of a repository at a specific path for a given branch.

- **Template**: `repo://{owner}/{repo}/refs/heads/{branch}/contents{/path*}`
- **Parameters**:
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `branch`: Branch name (string, required)
- `path`: File or directory path (string, optional)

- **Get Repository Content for a Specific Commit**
Retrieves the content of a repository at a specific path for a given commit.



<summary>Users</summary>

Expand Down
Loading
Loading