QQ Music & NetEase CLI + MCP — search, play, playlist management
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and error guidance. All tools are READ_ONLY and properly named with action verbs (search_*, play_*). Schemas are present but incomplete: search_music and search_album lack descriptions for the 'source' parameter; play_music has optional parameters but no guidance on mutual exclusivity (song_id vs songmid). Error handling returns structured responses but lacks recovery guidance. Output schemas are not documented. Descriptions are adequate (50-100 chars) but generic. No tool annotations (readOnlyHint, etc.) despite all being read-only. Average tool score: 52.
Get playback URL for a music track with optional quality selection and lyric retrieval
Search for albums by query string with pagination support
Search for music by query string with pagination support
play_music has mutually exclusive parameters (song_id vs songmid) but no documentation of this constraint. LLMs may pass both or neither, causing ambiguous failures.
Parameter 'source' (tx/wy/empty) lacks description in all three tools. LLMs cannot infer valid values or when to use each source.
Output schemas are not documented. LLMs do not know what fields to expect in responses (e.g., is_end, data structure, url, quality, song, lyric).
Error responses lack recovery guidance. Errors return {ok: false, error, message} but do not suggest next steps (e.g., 'Try a different source' or 'Check song_id format').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
No tool annotations despite all tools being read-only. Missing readOnlyHint would help agents understand these are safe to retry.