MCP Server to Assist with Setting-up and Maintaining Better-Auth
Server has 8 tools with schemas and descriptions present, but quality is significantly below production baseline. Most tool descriptions are generic and under 100 chars (well below the 194-char average for A+ tools). Parameter descriptions are sparse or missing entirely. No output schemas documented. Error handling is minimal, tool implementations are stubs that return placeholder text. No tool annotations (readOnlyHint/destructiveHint). The setup_better_auth tool exposes API credentials as parameters, violating secret-injection pattern. Tools like analyze_project, analyze_logs, and monitor_auth_flows lack actionable parameter guidance (e.g., what constitutes a valid timeRange format). No pagination support documented. Naming is reasonable (verb_noun style) but descriptions fail to explain WHEN to use each tool or what it returns.
Detect and analyze existing auth.js/next-auth implementation
Analyze Better-Auth logs for issues
Analyze project structure and dependencies to recommend Better-Auth setup approach
Create step-by-step migration plan from existing auth to Better-Auth
Real-time monitoring of authentication processes
Install and configure Better-Auth in the project
Test authentication workflows
API credentials (projectId, apiKey) exposed as tool parameters in setup_better_auth. Credentials must never appear in parameters, use server-side secret injection via environment variables.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields without knowing response structure. All tools return placeholder text only.
Parameter descriptions are missing or generic. 'timeRange' in analyze_logs lacks format guidance (is '24h' valid? '1 day'? Unix timestamp?). 'duration' in monitor_auth_flows similarly undefined. LLMs cannot infer valid formats.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | <=2025-11-25 | v2 |
Run security tests on Better-Auth setup
Tool descriptions do not explain WHEN to use each tool or what distinguishes it from similar tools. E.g., analyze_project vs analyze_current_auth, when should an agent call one vs the other? No guidance provided.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Agents cannot determine which tools are safe to retry or which modify state. setup_better_auth is destructive but unmarked.