MCP server bridging ARIS skills to Zhipu (BigModel) API, implementing codex and codex-reply tools for code review and iterative conversation over the Anthropic Messages protocol
Two tools with basic descriptions but significant schema and parameter documentation gaps. Tool names lack action verbs (codex, codex-reply are domain-specific but not verb-prefixed). Input schemas visible but lack type definitions for nested objects and parameter constraints. Descriptions are adequate (100-150 chars) but lack actionable guidance on when to use each tool vs. the other. No output schema documented. Error handling present in code but not surfaced in tool definitions. No parameter descriptions for config object fields (model_reasoning_effort values, constraints). Follows basic MCP structure but falls short of production-grade tool design.
Submit a prompt to the Zhipu GLM API for code review or analysis. Returns a threadId and content response. Supports model selection and reasoning effort configuration (ultra, max, xhigh, high) for extended thinking.
Continue a conversation thread with the Zhipu reviewer. Loads the thread history, appends the new message, and returns the updated response. Supports model selection and reasoning effort configuration.
Tool names lack action verbs. 'codex' and 'codex-reply' are domain-specific but do not start with verbs (submit_, send_, continue_). LLMs infer intent from verb-prefixed names; these names require reading descriptions to disambiguate from other code-review tools.
Input schema for 'config' parameter is declared as type 'object' with description 'Configuration object containing model_reasoning_effort' but lacks nested field definitions, types, and constraints. LLMs cannot infer valid values (ultra, max, xhigh, high) from schema alone, they must parse the description text.
No output schema documented in tool definitions. Descriptions mention 'Returns a threadId and content response' but do not specify field types, structure, or whether content is plain text, markdown, or structured JSON. Agents cannot plan downstream calls without knowing response shape.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | <=2025-11-25 | v2 |
Parameter 'model' description states 'if omitted, inherits from thread' (codex-reply) but does not explain what happens in codex when model is omitted. Undocumented dependency on ZHIPU_MODEL env var forces LLMs to guess or read server code.
No error handling guidance in tool definitions. Code implements retry logic for thinking-field rejection and HTTP error handling, but tool descriptions do not tell LLMs what errors are retryable, what to do on model-not-found, or how to recover from timeouts.