MCP server for GitHub API operations including repository management, file operations, issues, pull requests, branches, commits, and search functionality
This server has 26 tools with basic descriptions but critical gaps in schema documentation and parameter clarity. Tool names follow verb_noun convention (good), but descriptions are minimal (avg ~50 chars, well below the 194-char baseline). Most critically: input schemas are NOT visible in the provided source code, only tool names and descriptions appear in the TOOLS list. The server.py excerpt shows tool invocation logic but no explicit JSON Schema definitions for parameters. Error handling exists (GitHubError decorator) but lacks recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite 8 WRITE and 1 IRREVERSIBLE tool. No pagination metadata in responses. Composition is reasonable (26 focused tools), but parameter descriptions are absent from the visible schema.
Add a comment to an existing issue
Create a new branch in a GitHub repository
Create a new issue in a GitHub repository
Create or update a single file in a GitHub repository
Create a new pull request in a GitHub repository
Create a review on a pull request
Create a new GitHub repository in your account
No JSON Schema definitions visible for any tool parameters. This affects all 26 tools.
Tool descriptions are minimal (avg ~50 chars vs 194-char baseline). Descriptions like 'Create a new issue in a GitHub repository' lack context on WHEN to use, prerequisites, or what the tool returns. LLMs cannot reliably select tools with such sparse guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 30 | 2026-07-28+ | v2 |
Fork a GitHub repository to your account or specified organization
Get the contents of a file or directory from a GitHub repository
Get details of a specific issue in a GitHub repository
Get details of a specific pull request
Get the review comments on a pull request
Get the list of files changed in a pull request
Get the reviews on a pull request
Get the combined status of all status checks for a pull request
Get list of commits of a branch in a GitHub repository
List issues in a GitHub repository with filtering options
List and filter repository pull requests
Merge a pull request
Push multiple files to a GitHub repository in a single commit
Search for code across GitHub repositories
Search for issues and pull requests across GitHub repositories
Search for GitHub repositories
Search for users on GitHub
Update an existing issue in a GitHub repository
Update a pull request branch with the latest changes from the base branch
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite 8 WRITE tools and 1 IRREVERSIBLE tool (merge_pull_request). Agents cannot distinguish safe reads from destructive writes without explicit hints.
No pagination metadata in responses. Tools like list_issues, list_pull_requests, search_repositories accept page/perPage but no evidence of returning total_count, has_more, or next_cursor. Large result sets will blow context windows.
Error handling exists (GitHubError decorator) but lacks recovery guidance. Errors return only error class name and message, not actionable next steps (e.g., 'Try search_users() first' or 'Invalid status: must be open|closed|all').