MCP server for turning AI conversations into dev.io markdown posts.
Server has 12 tools with complete input schemas and descriptions. Naming follows verb_noun convention (publish_post, list_posts, get_post, etc.). Descriptions are present but brief (avg ~60 chars, below the 194-char baseline). Parameters are typed and mostly described, but lack actionable constraints (enums, ranges, format hints). Output schemas are not documented in the source. Error handling is minimal, no recovery guidance or categorization. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (WRITE, DESTRUCTIVE). Missing parameter validation rules and dependency documentation.
Add a top-level comment to a post
Delete a post from the local posts directory
Get the full content of a specific post
Get metrics for a specific post
Get a specific article from dev.to
List comments for a post from local or remote source
List all local posts with optional filtering
List articles from dev.to
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and risk broken tool chains.
Destructive tools (delete_post) lack confirmation or dry-run support. Agents can permanently delete posts without a safety gate.
Tool annotations missing. delete_post, update_post, and publish_post should declare destructiveHint/idempotentHint to guide agent retry logic and safety decisions.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | <=2025-11-25 | v2 |
Publish a new post to the local posts directory and optionally to dev.to
Record a metric event for a post (view, like, bookmark, share, comment)
Reply to an existing comment on a post
Update an existing post
Parameter descriptions lack actionable constraints. 'file' parameter appears in 8 tools but has no format hint (e.g., 'filename without path, .md extension'). 'query' in list_posts has no length/format guidance.
No error handling guidance. Tools do not document what happens on failure (file not found, invalid metric event, API timeout). LLMs receive raw errors with no recovery path.