TypeScript implementation of MCP Server Cards (SEP-2127) - tools for generating, validating, discovering, and serving MCP Server Card metadata
mcp-card is a CLI tool for MCP Server Card (SEP-2127) management with 6 tools. Tool naming is clear and verb-driven (init, validate, preview, discover, crawl). Descriptions are present and adequate (50-150 chars). Input schemas are visible with type definitions and descriptions for all parameters. However, output schemas are not documented, LLMs cannot predict what these tools return. Error handling is minimal; no recovery guidance or actionable error messages. Parameters lack constraints (enums, ranges, patterns) that would guide LLM input. No tool annotations (readOnlyHint, destructiveHint). The 'init' and 'from-server-json' tools perform writes but lack confirmation/dry-run patterns.
Crawl a list of URLs (one per line) and report SEP-2127 compliance
Fetch a remote card and report identity, transports, capabilities, and headers
Convert an MCP Registry server.json to an mcp-server-card.json
Interactively generate an mcp-server-card.json
Render a friendly summary of a card
Validate a card from a file path or URL
Output schemas not documented. LLMs cannot predict return types, field names, or structure. Tools return JSON but no schema is visible in tool definitions.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). 'init' and 'from-server-json' perform writes but LLMs cannot detect this from the tool definition.
Parameters lack enums and constraints. 'timeout' and 'concurrency' accept strings with no validation hints. LLMs may pass invalid values like 'timeout=abc' or 'concurrency=-5'.
No error handling guidance. Tools do not document what errors are retryable, what user-fixable errors look like, or how to recover from failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
Destructive operations lack confirmation. 'init' and 'from-server-json' overwrite files; 'yes' flag bypasses prompts but no dry-run or confirmation pattern exists.