Local MCP server for real-time AI subscription quota across Claude Code Max, Kimi, and Z.ai
Three tools with clear verb-noun naming and complete input schemas. Descriptions are present and actionable (avg 156 chars), meeting the 10-1024 char baseline. All parameters have type definitions and descriptions. However, output schemas are undocumented, LLMs cannot predict response structure for downstream chaining. Error handling is basic (isError flag only, no recovery guidance). No tool annotations (readOnlyHint, etc.). Missing parameter constraints on threshold (0-100 range declared but not validated in description). Overall solid foundation but lacks production-grade polish for complex agent workflows.
Flags providers that are over a usage threshold (default 80%) or have missing/invalid tokens. Returns a health report with actionable warnings.
Returns detailed quota information for a single provider. Supported providers: claude, kimi, zai.
Returns a unified quota summary across all configured providers (Claude Code Max, Kimi, Z.ai). Providers without a configured token report a config error rather than failing the whole call.
Output schemas not documented. LLMs cannot predict response structure (fields, types, nesting) for downstream tool chaining or data extraction. Responses are markdown text blobs, not structured objects.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All three tools are read-only but this is not declared in the tool definition, forcing LLMs to infer safety from descriptions alone.
Error responses lack recovery guidance. When provider validation fails or token is missing, the tool returns isError=true with a plain message. No actionable next steps (e.g., 'Set CLAUDE_API_TOKEN env var' or 'Call get_quota_summary to see all providers').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Parameter 'mock' in get_provider_quota is undocumented in descriptions. LLMs cannot determine when to use mock=true vs calling real APIs. No guidance on when mock data is appropriate.
Threshold parameter in check_quota_health has min/max constraints in schema (0-100) but description does not explain the constraint or default behavior. LLMs may not respect JSON Schema bounds without explicit text guidance.