Overview
Hotfix release completing the v10.0.0 tool consolidation initiative by removing deprecated tools from the MCP tool list advertisement. This achieves the promised 64% tool reduction (34→12 visible tools) while maintaining full backwards compatibility.
What's Fixed
Tool List Cleanup
- Removed 20 deprecated tool definitions from MCP tool list
- Claude Desktop and other MCP clients now see a clean, focused list of 12 unified tools
- Deprecated tools still work perfectly via backwards compatibility routing in compat.py
- All old tool names continue working with deprecation warnings until v11.0.0
- No breaking changes - existing integrations work unchanged
Deprecated Tools Removed from Advertisement
The following 20 tools no longer appear in the MCP tool list but still work via backwards compatibility:
Memory Retrieval:
- recall_memory → Use memory_search
- retrieve_memory → Use memory_search
- retrieve_with_quality_boost → Use memory_search with quality_weight
- debug_retrieve → Use memory_search with debug=true
- exact_match_retrieve → Use memory_search with exact content
- recall_by_timeframe → Use memory_search with start_date/end_date
Memory Deletion:
- delete_memory → Use memory_delete with content_hash
- delete_by_tag → Use memory_delete with tags
- delete_by_tags → Use memory_delete with tags
- delete_by_all_tags → Use memory_delete with tags and match_all=true
- delete_by_timeframe → Use memory_delete with start_date/end_date
- delete_before_date → Use memory_delete with before_date
Consolidation:
- consolidate_memories → Use consolidation_manage with action=run
- consolidation_status → Use consolidation_manage with action=status
- consolidation_recommendations → Use consolidation_manage with action=recommend
- scheduler_status → Use consolidation_manage with action=scheduler_status
- trigger_consolidation → Use consolidation_manage with action=trigger
- pause_consolidation → Use consolidation_manage with action=pause
- resume_consolidation → Use consolidation_manage with action=resume
Debugging:
- get_raw_embedding → Use memory_debug with action=embedding
Why This Release?
v10.0.0 introduced unified tools but kept deprecated tools in the MCP tool list for backwards compatibility. This caused Claude Desktop to still show 29 tools instead of 12, defeating the purpose of the consolidation. This hotfix removes the deprecated tools from the advertisement while keeping them fully functional via compatibility routing.
Impact
- User Experience: Claude Desktop users now see a clean list of 12 focused tools
- Backwards Compatibility: 100% maintained - all old tool names still work
- Migration: Optional until v11.0.0 (deprecation warnings guide users)
- Documentation: Complete migration guide in docs/MIGRATION.md
Upgrade Instructions
For end users, update normally:
pip install --upgrade mcp-memory-serviceFor developers using deprecated tool names, migrate at your convenience. See docs/MIGRATION.md for complete migration patterns.
Related Releases
- v10.0.0 - Initial tool consolidation (34→12 tools)
- v10.0.1 - Fixed MCP tools not loading (boolean syntax error)
- v10.0.2 - Completed consolidation by cleaning tool list (this release)
Links
- Full Changelog: https://github.com/doobidoo/mcp-memory-service/blob/main/CHANGELOG.md
- Migration Guide: https://github.com/doobidoo/mcp-memory-service/blob/main/docs/MIGRATION.md
- PyPI: https://pypi.org/project/mcp-memory-service/
Note: PyPI publishing is handled automatically by GitHub Actions workflow.