A simple MCP server demonstrating basic tool functionality with greeting and arithmetic operations
12 tools with basic schemas and descriptions, but significant quality gaps. All tools have descriptions (10-50 chars, mostly under the 194-char baseline), and input schemas are present with type definitions. However, descriptions are generic and lack actionable context for LLM selection. No parameter descriptions beyond type names. No output schemas documented. Error handling is minimal (catch-all GithubException returns {"error": str(e)}). No guidance on when to use similar tools (e.g., get_repository vs list_repositories). Tool names follow verb_noun convention but lack specificity in some cases (e.g., 'get_profile' is vague about what profile). No pagination support despite list_* tools. No idempotency hints or destructive operation warnings.
Add two numbers.
Create a GitHub issue.
Get authenticated GitHub user.
Return profile information.
Get repository information.
Greet a user.
Get latest commit.
Descriptions are generic and lack LLM-optimized context. Most are 10-50 chars (well below 194-char baseline). No guidance on when to use similar tools (e.g., get_repository vs list_repositories) or what data is returned.
No parameter descriptions. Parameters like 'repo_name', 'title', 'body' lack context explaining format, constraints, or examples. LLMs cannot infer whether 'repo_name' accepts 'owner/repo' or just 'repo'.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
List all branches.
List open issues.
List open pull requests.
List all GitHub repositories.
Return a welcome message.
No output schemas documented. Tools return dicts/lists but LLMs have no formal schema for what fields to expect. E.g., get_repository returns {name, description, language, stars, forks, watchers, url} but this is not declared in tool metadata.
Error handling is minimal. All GitHub tools catch GithubException and return {"error": str(e)}, which is opaque to LLMs. No guidance on retry, user-fixable vs fatal, or recovery steps.
No pagination support on list_* tools. list_repositories, list_branches, list_issues, list_pull_requests return all results without limit/offset/page parameters or total count. Large result sets will blow context windows.