- Notifications
You must be signed in to change notification settings - Fork1.4k
Description
I prepared this Issue with Claude Code and edited/reviewed it heavily, but did not audit its specific code references, so apologies if e.g. line numbers are not quite precise; consider it pseudocode but hopefully it's pretty actionable.
Related to:#670 (but I broke this out since it's perhaps a slightly more controversial design decision to make)
Describe the feature or problem you'd like to solve
Some GitHub organizations host their discussions at the organization level (e.g.,https://github.com/orgs/modelcontextprotocol/discussions), but the current GitHub MCP Server's discussions toolset cannot access these discussions.
Current limitation:
list_discussions
requires bothowner
andrepo
parameters- No way to query organization-level discussions
- Users must know the hidden implementation detail that org discussions live in the
.github
repository (and even then, it's not accessible via the MCP server)
Organization discussions appear to be stored in a special.github
repository within the organization. This can be queried via GraphQL:
query {repository(owner:"modelcontextprotocol",name:".github") {discussions(first:3,orderBy: {field: UPDATED_AT,direction: DESC}) {nodes {numbertitleurl } } }}
This successfully returns discussions like:
- 493: "Reconnection should re-send initialization"
- 492: "Order of Elicitation Parameters"
- 491: "Exclude tools?"
Proposed solution
Option 1: Makerepo
parameter optional inlist_discussions
Whenrepo
is omitted, automatically query the.github
repository:
// In list_discussions handlerifrepo=="" {repo=".github"// Default to org discussions repo}
Option 2: Create a dedicatedlist_organization_discussions
tool
A new tool specifically for organization-level discussions:
mcp.NewTool("list_organization_discussions",mcp.WithDescription("List discussions at the organization level"),mcp.WithString("org",mcp.Required(),mcp.Description("Organization name"), ),// ... other parameters like orderBy, direction, etc.)
Example prompts or workflows (for tools/toolsets only)
"Show me all discussions in the modelcontextprotocol organization"
- Query org-level discussions without needing to know about
.github
repo
- Query org-level discussions without needing to know about
"Monitor community discussions across our entire organization"
- Access centralized org discussions for community management
"Find unanswered questions in our organization's Q&A discussions"
- Filter org-level discussions by category and state
"Generate a report of most active organization-wide discussions"
- Sort org discussions by activity to identify hot topics
"Track discussions from external contributors across the organization"
- Monitor org-level discussions for community engagement metrics