github_toolsets_permissions.json

{
  "version": "2.4",
  "description": "GitHub MCP server toolsets and their required permissions (synced to github/github-mcp-server main: restored semantic search, advisory, and secret scanning tools; search tools remain redistributed to repos/orgs/users/issues; experiments toolset removed; list_org_repository_security_advisories moved orgs->security_advisories; get_label dual-registered in issues; create_pull_request_with_copilot added)",
  "toolsets": {
    "actions": {
      "description": "GitHub Actions workflows",
      "read_permissions": ["actions"],
      "write_permissions": ["actions"],
      "tools": ["actions_get", "actions_list", "actions_run_trigger", "get_job_logs"]
    },
    "code_quality": {
      "description": "Code quality findings",
      "read_permissions": ["security-events"],
      "write_permissions": [],
      "tools": ["get_code_quality_finding"]
    },
    "code_security": {
      "description": "Code scanning alerts",
      "read_permissions": ["security-events"],
      "write_permissions": ["security-events"],
      "tools": ["get_code_scanning_alert", "list_code_scanning_alerts"]
    },
    "context": {
      "description": "GitHub context and environment (current user, teams)",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["get_me", "get_team_members", "get_teams"]
    },
    "copilot": {
      "description": "GitHub Copilot assignment, review, and coding agent tools",
      "read_permissions": [],
      "write_permissions": ["issues", "pull-requests"],
      "tools": ["assign_copilot_to_issue", "create_pull_request_with_copilot", "request_copilot_review"]
    },
    "copilot_spaces": {
      "description": "GitHub Copilot Spaces (remote-only)",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["get_copilot_space", "list_copilot_spaces"]
    },
    "dependabot": {
      "description": "Dependabot alerts",
      "read_permissions": ["security-events", "vulnerability-alerts"],
      "write_permissions": [],
      "tools": ["get_dependabot_alert", "list_dependabot_alerts"]
    },
    "discussions": {
      "description": "GitHub Discussions",
      "read_permissions": ["discussions"],
      "write_permissions": ["discussions"],
      "tools": ["discussion_comment_write", "get_discussion", "get_discussion_comments", "list_discussion_categories", "list_discussions"]
    },
    "gists": {
      "description": "Gist operations",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["create_gist", "get_gist", "list_gists", "update_gist"]
    },
    "git": {
      "description": "Git API operations (tree, refs)",
      "read_permissions": ["contents"],
      "write_permissions": [],
      "tools": ["get_repository_tree"]
    },
    "github_support_docs_search": {
      "description": "GitHub support documentation search (remote-only)",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["github_support_docs_search"]
    },
    "issues": {
      "description": "Issue management (get_label is also registered here alongside labels)",
      "read_permissions": ["issues"],
      "write_permissions": ["issues"],
      "tools": [
        "add_issue_comment",
        "get_label",
        "issue_dependency_read",
        "issue_dependency_write",
        "issue_read",
        "issue_write",
        "list_issue_fields",
        "list_issue_types",
        "list_issues",
        "search_issues",
        "semantic_issue_similarity_search",
        "semantic_issues_search",
        "sub_issue_write"
      ]
    },
    "labels": {
      "description": "Label management",
      "read_permissions": ["issues"],
      "write_permissions": ["issues"],
      "tools": ["get_label", "label_write", "list_label"]
    },
    "notifications": {
      "description": "Notification management",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["dismiss_notification", "get_notification_details", "list_notifications", "manage_notification_subscription", "manage_repository_notification_subscription", "mark_all_notifications_read"]
    },
    "orgs": {
      "description": "Organization operations (organization search)",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["search_orgs"]
    },
    "projects": {
      "description": "GitHub Projects (requires PAT - not supported by GITHUB_TOKEN)",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["projects_get", "projects_list", "projects_write"]
    },
    "pull_requests": {
      "description": "Pull request operations",
      "read_permissions": ["pull-requests"],
      "write_permissions": ["pull-requests"],
      "tools": [
        "add_comment_to_pending_review",
        "add_reply_to_pull_request_comment",
        "create_pull_request",
        "list_pull_requests",
        "merge_pull_request",
        "pull_request_read",
        "pull_request_review_write",
        "search_pull_requests",
        "update_pull_request",
        "update_pull_request_branch"
      ]
    },
    "repos": {
      "description": "Repository operations (includes repository/code/commit search)",
      "read_permissions": ["contents"],
      "write_permissions": ["contents"],
      "tools": [
        "create_branch",
        "create_or_update_file",
        "create_repository",
        "delete_file",
        "fork_repository",
        "get_commit",
        "get_file_blame",
        "get_file_contents",
        "get_latest_release",
        "get_release_by_tag",
        "get_tag",
        "list_branches",
        "list_commits",
        "list_releases",
        "list_repository_collaborators",
        "list_tags",
        "push_files",
        "search_code",
        "search_commits",
        "search_repositories"
      ]
    },
    "secret_protection": {
      "description": "Secret scanning",
      "read_permissions": ["security-events"],
      "write_permissions": [],
      "tools": ["get_secret_scanning_alert", "list_secret_scanning_alerts", "run_secret_scanning"]
    },
    "security_advisories": {
      "description": "Security advisories",
      "read_permissions": ["security-events"],
      "write_permissions": ["security-events"],
      "tools": ["check_dependency_vulnerabilities", "get_global_security_advisory", "list_global_security_advisories", "list_org_repository_security_advisories", "list_repository_security_advisories"]
    },
    "stargazers": {
      "description": "Repository stars",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["list_starred_repositories", "star_repository", "unstar_repository"]
    },
    "users": {
      "description": "User information (user search)",
      "read_permissions": [],
      "write_permissions": [],
      "tools": ["search_users"]
    }
  }
}