Inspired by Rui Carmo's MCP server lessons: "The prefix is the plan. The verb is the step." Today our tools are prefixed by verb, not entity, which forces the model to scan all 20 descriptions to figure out which one applies to the entity it has in hand.
Proposed regrouping:
collection_search, collection_refresh, collection_statsfolder_list, folder_create, folder_delete, folder_editrelease_get, release_rate, release_add (to collection), release_remove, release_movecustom_field_list, custom_field_editdiscogs_search (catalog-wide)server_info, auth_status, ping, cache_stats
MCP clients re-fetch the tool list on every connection, so the practical breakage is small: in-flight conversations holding the old list in context, any local prompt that hardcodes a tool name, and our own test suite. Just rename in one shot, bump major, update tests and local CLAUDE.md references. Pair with the server-instructions change (#29) so the new path is documented at the same time.
Inspired by Rui Carmo's MCP server lessons: "The prefix is the plan. The verb is the step." Today our tools are prefixed by verb, not entity, which forces the model to scan all 20 descriptions to figure out which one applies to the entity it has in hand.
Proposed regrouping:
collection_search,collection_refresh,collection_statsfolder_list,folder_create,folder_delete,folder_editrelease_get,release_rate,release_add(to collection),release_remove,release_movecustom_field_list,custom_field_editdiscogs_search(catalog-wide)server_info,auth_status,ping,cache_statsMCP clients re-fetch the tool list on every connection, so the practical breakage is small: in-flight conversations holding the old list in context, any local prompt that hardcodes a tool name, and our own test suite. Just rename in one shot, bump major, update tests and local CLAUDE.md references. Pair with the server-instructions change (#29) so the new path is documented at the same time.