A zero-knowledge authorization layer for AI agents and MCP tools backed by Midnight zero-knowledge proofs
zkMCP defines 3 tools with explicit schemas and descriptions, but quality is inconsistent. All tools have input schemas with proper types and descriptions (good baseline). However, descriptions are minimal (10-30 chars), output schemas are present but basic, and error handling is absent. Tool naming follows verb_noun convention (documents.read, email.send, payments.transfer) but lacks clarity on scope, 'documents.read' doesn't indicate it's matter-specific. No recovery guidance, no actionable error messages, and no confirmation pattern for irreversible operations (payments.transfer). Annotations present (readOnlyHint, destructiveHint, idempotentHint) but underutilized.
Read a document from a legal matter
Send an external email
Transfer a payment
Descriptions are too brief (10-30 chars). LLMs cannot determine when/why to select tools. Baseline is 194 chars; these lack context, prerequisites, and selection guidance.
No error handling or recovery guidance. Tools do not indicate what to do on failure (retry? ask user? fatal?). Irreversible operation (payments.transfer) lacks confirmation or dry-run pattern.
Output schemas are minimal. documents.read returns {content, documentId, matterId}; email.send returns {messageId, status}; payments.transfer has no documented output. Missing fields that downstream tools may need (e.g., transaction_id, confirmation_code).
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2025-06-18+ | v2 |
Tool naming lacks specificity. 'documents.read' doesn't clarify it reads legal matter documents. 'email.send' doesn't indicate external-only scope. Ambiguous names increase LLM selection errors.
Parameter descriptions are generic. 'Document identifier', 'Matter identifier', 'Recipient email address' lack format guidance, constraints, or examples. No mention of valid formats, length limits, or dependencies.