Identity-aware MCP resource server for internal developer access management
AgentGate MCP demonstrates solid foundational quality with well-named tools following verb_noun conventions and comprehensive parameter schemas. All 6 tools have descriptions and input schemas with proper types. However, output schemas are not documented in the provided source, parameter descriptions lack depth (missing format/constraint details), and error handling guidance is absent. Tool names are clear (get_user, list_applications, create_access_request, check_permission, search_identity_documentation, get_audit_events), but descriptions are brief (avg ~80 chars) and lack context about when to use each tool vs. alternatives. Parameters include enums and constraints (e.g., sensitivity levels, permission types, duration bounds), but descriptions don't explain the rationale or dependencies. No evidence of output schema documentation or error recovery guidance.
Check whether a user has permission to perform an action on an application.
Request temporary access to an application. Creates audit trail and notifies approvers.
Retrieve recent audit events. Restricted to admin and auditor roles.
Get user profile by ID or email. Developers can read self; admin/auditor can read any.
List registered internal applications, optionally filtered by sensitivity.
Search internal identity and security documentation using full-text search.
Output schemas not documented. LLMs cannot plan downstream tool calls or extract required fields without knowing response structure.
Parameter descriptions lack actionable constraints. E.g., 'reason' has minLength/maxLength but description doesn't explain why or what makes a good reason. 'durationHours' has bounds but no guidance on typical values.
No error handling guidance. Tools lack descriptions of failure modes, recovery steps, or when to retry. E.g., create_access_request doesn't explain what happens if the application doesn't exist or the user lacks permission to request access.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | <=2025-11-25 | v2 |
Tool descriptions are brief (avg 60-75 chars) and lack context about when to use each tool. E.g., get_audit_events and get_user both retrieve data but descriptions don't explain the distinction or when to call each.
No pagination guidance for list_applications and get_audit_events. Descriptions don't explain what happens if results exceed the limit or how to fetch additional pages.