A Go-based MCP server that provides autonomous agent capabilities with tool execution, model integration, and agentic workflows
core-agent exposes only 2 tools with minimal structure. Both tools have descriptions, but they are vague and do not follow agentic tool patterns. 'return_result' and 'report_done' appear to be lifecycle/control tools rather than domain-specific capabilities. Input schemas are present but lack proper type definitions and parameter descriptions. The tools do not follow verb_noun naming conventions (e.g., 'return_result' is ambiguous, does it return to caller, to a database, to a log?). No output schemas are documented. Error handling is absent. The server appears designed for agent-to-agent delegation rather than exposing reusable, composable tools for LLM agents.
Lifecycle-style done tool for reporting completion status with optional detail
Return your result to the agent that delegated this task, and finish. The result argument is the ONLY thing the delegating agent is guaranteed to receive: write the answer, the root-cause analysis, the proposed change, or the specific reason you stopped, with the evidence behind it. A status line like "investigated the issue and found the cause" forces the delegating agent to redo the work, because it cannot see what you did.
Tool names lack action verbs and clarity. 'return_result' and 'report_done' are vague control signals, not domain actions. LLMs cannot infer intent from these names alone.
Parameter 'result' in return_result has no type definition visible in schema. Input schema shows only description, not JSON Schema type (string, object, array, etc.).
No output schemas documented for either tool. LLMs cannot plan downstream calls or extract structured data without knowing what these tools return.
Descriptions are generic and do not explain WHEN to use each tool or how they differ. 'Lifecycle-style done tool' is not actionable for an LLM deciding between return_result and report_done.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
No error handling guidance. If return_result fails, what should the agent do? Retry? Ask the user? No recovery path is documented.