MCP Server for server card generation, validation and discovery — .well-known/mcp-server-card.json protocol
Server has 6 tools with basic descriptions and parameter schemas. However, descriptions are inconsistent in quality, some bilingual (English/German) and verbose, others minimal. Parameter descriptions exist but lack actionable constraints (enums, ranges, formats). No output schemas documented. Error handling is absent from visible code. Tool naming follows verb_noun pattern (generate_card, validate_card, discover, search, register, schema) which is good, but composition could be tighter, generate_card accepts a raw tools array rather than discovering/validating first. No evidence of idempotency guarantees, rate limiting, or permission gates. The register tool is destructive (WRITE) but lacks confirmation or dry-run support.
Discover an MCP server card from a URL via .well-known. Prüft ob unter der angegebenen URL eine Server Card unter .well-known/mcp-server-card.json verfügbar ist.
Generate a .well-known/mcp-server-card.json for an MCP server. Erstellt eine maschinenlesbare Server Card mit allen Metadaten, die andere Agents zur automatischen Discovery brauchen.
Register a server card in the local index. Fügt eine Server Card zum lokalen Index hinzu oder aktualisiert eine bestehende Card mit gleichem Namen.
Get the JSON schema for MCP server cards. Gibt das vollständige Schema zurück, das beschreibt welche Felder eine Server Card haben kann und welche Pflicht sind.
Search indexed server cards by keyword. Durchsucht den lokalen Index nach Server Cards. Sucht in Name, Beschreibung, Kategorien und Tool-Namen.
Validate a server card JSON against the schema. Prüft ob eine Server Card alle Pflichtfelder enthält und dem Schema entspricht. Gibt auch Warnungen für fehlende empfohlene Felder.
No output schemas documented. Tools return strings (JSON serialized) but LLMs cannot infer structure. Downstream tools cannot reliably extract fields for chaining.
Parameter descriptions lack actionable constraints. 'categories' has no enum; 'pricing' accepts free/freemium/paid/open-source but no validation hint; 'transport' accepts stdio/http/both but no guidance on when to use each.
register tool is destructive (WRITE) but has no confirmation step, dry-run option, or error recovery guidance. Agents could overwrite existing cards without warning.
Bilingual descriptions (English + German) waste tokens and confuse LLMs. Descriptions should be in a single language optimized for LLM parsing.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
No error handling visible in tool implementations. No guidance on retryability, user-fixable vs fatal errors, or recovery steps. Agents will not know how to respond to failures.