MCP Server that dynamically generates tools from OpenAPI specifications and provides access to Docker Hub APIs, Docker Scout, and related services
10 tools with mostly complete schemas and descriptions, but significant gaps in parameter documentation and error handling guidance. All tools have input schemas and descriptions present, but many descriptions are generic or lack actionable context. Parameter descriptions are inconsistent, some tools like createRepository have detailed constraints, while others like getPersonalNamespace lack parameter detail entirely. No output schemas documented. Error handling is absent, no recovery guidance, retryability classification, or actionable error messages. Tool naming follows verb_noun convention well (list*, get*, create*, search*). Composition is sound: tools are single-responsibility and chainable. However, the server lacks the polish expected of production-grade tools.
Create a new repository
This API is used to list Docker Hardened Images (DHIs) available in the user organisations. The tool takes the organisation name as input and returns the list of DHI images available in the organisation. It depends on the "listNamespaces" tool to be called first to get the list of organisations the user has access to.
Get the personal namespace name
Get a repository by namespace and name
Get a specific tag from a repository
List all namespaces the user is a member of
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields without knowing response structure.
Empty input schemas for getPersonalNamespace and listAllNamespacesMemberOf lack parameter descriptions. Even zero-parameter tools should document what they return and any prerequisites.
No error handling guidance. Tools do not indicate which errors are retryable, what the LLM should do on failure, or how to recover. E.g., 'namespace not found' should suggest calling listNamespaces first.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2025-06-18+ | v2 |
List paginated namespaces
List paginated repositories by namespace
List paginated tags for a repository
Search for repositories
Pagination parameters (page, page_size) lack constraints. No min/max documented. LLMs may pass invalid values (page=0, page_size=10000) causing API errors.
createRepository description does not explicitly state it modifies state (creates a resource). Agents need to know this is irreversible and may require confirmation.