MCP server for interacting with Ghost CMS via Admin and Content APIs
Server has 13 tools with explicit @Tool annotations and descriptions in French. All tools are READ_ONLY and follow a consistent naming pattern (verb_noun). However, critical gaps exist: NO input parameter schemas are visible in the source code, parameters are bare Java method arguments (String author, String tag, String slug) with no JSON Schema definitions, type constraints, or descriptions. Tool descriptions are present but generic (100-150 chars), lacking LLM-optimized guidance on WHEN to use each tool vs. similar ones. No output schemas documented. No error handling guidance visible. Parameter descriptions missing entirely, LLMs cannot infer what 'author', 'tag', or 'slug' mean without explicit docs. This is a typical community server: functional but not production-ready for agentic use.
Recherche les articles de blog écrits par un auteur spécifique (par exemple 'erwan') via l'API Admin. Permet d'accéder aux articles (publiés ou non) d'un auteur particulier. Retourne une liste contenant les objets Post complets.
Recherche les articles associés à un tag spécifique via l'API Admin. Utile pour filtrer le contenu par catégorie taxonomique, y compris les articles non publiés. Retourne une liste d'objets Post complets.
Récupère les détails administratifs d'un article unique via son slug (URL friendly). Fournit les informations complètes, incluant les formats html et plaintext si disponibles.
Récupère tous les articles récents via l'API Admin de Ghost. Cela inclut tous les articles, y compris les brouillons (drafts) et les articles planifiés (scheduled). Retourne une liste contenant les objets Post complets.
Récupère la liste de tous les auteurs ayant publié des articles via l'API Content. Inclut les détails comme le nom, la bio et le nombre d'articles publiés.
NO input parameter schemas visible. All parameters are bare Java Strings (author, tag, slug, id) with no JSON Schema definitions, type constraints, enums, or format declarations. LLMs cannot validate inputs or understand constraints.
Parameter descriptions completely missing. Tools accept 'author', 'tag', 'slug', 'id' but provide no guidance on format, length, or valid values. LLMs must guess whether 'author' is a name, email, or ID.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
Récupère tous les articles récents via l'API Content de Ghost. Retourne uniquement les articles publics et publiés avec leurs titres, slugs et métadonnées de base.
Récupère tous les tags utilisés sur le site via l'API Content. Retourne les noms des tags, leurs descriptions et le nombre d'articles associés.
Récupère les détails d'un auteur spécifique par son identifiant unique via l'API Content.
Récupère les détails d'un auteur spécifique par son slug via l'API Content.
Récupère un article unique par son identifiant via l'API Content. Utile pour obtenir le contenu complet d'un article spécifique quand son ID est connu.
Récupère un article unique par son slug (partie friendly de l'URL) via l'API Content. C'est la méthode recommandée pour afficher le contenu d'un article à partir de son lien.
Récupère les détails d'un tag spécifique par son identifiant unique via l'API Content.
Récupère les détails d'un tag spécifique par son slug via l'API Content.
No output schemas documented. Tools return Post, Author, Tag objects but LLMs cannot see field names, types, or which fields are safe to chain into downstream tools. Breaks tool composition.
Tool descriptions lack LLM-optimized guidance. Descriptions are generic (60-150 chars) and do not explain WHEN to use each tool vs. similar ones. E.g., getAllAdminPosts vs. getAllContentPosts distinction is unclear from descriptions alone.
No error handling guidance visible. No recovery hints, retryability classification, or actionable error messages. If a slug is invalid or author not found, LLMs have no guidance on next steps.