cf-memory-mcp 3.2.0 → 3.3.0

package/README.md

@@ -5,7 +5,9 @@
 
 A **best-in-class MCP (Model Context Protocol)** server for AI memory storage using **Cloudflare infrastructure**. This package provides AI coding agents with intelligent memory management featuring **smart auto-features**, **intelligent search**, **memory collections**, **temporal intelligence**, **multi-agent collaboration**, **advanced analytics**, and a **real-time analytics dashboard** with interactive visualizations and business intelligence.
 
-## 🎯 Current Version: v2.12.1
+## 🎯 Current Version: v3.2.1 (Tool Consolidation Release)
+
+**🔧 Major Update: Tool Consolidation** - Reduced from 95+ tools to 20 essential tools (79% reduction) for improved usability and performance.
 
 ## 📊 Real-time Analytics Dashboard
 
@@ -349,613 +351,203 @@ Add to your Claude Desktop MCP configuration:
 }
 ```
 
-## 🔧 Available Tools
+## 🔧 Available Tools (v3.2.0 - Consolidated)
 
-The CF Memory MCP server provides comprehensive memory management tools:
+The CF Memory MCP server provides **20 essential tools** (consolidated from 95+ tools for improved usability):
 
-### Core Memory Operations
+### Core Memory Operations (5 tools)
 
 #### `store_memory`
-
 Store a new memory with optional metadata and tags.
 
 **Parameters:**
-
 - `content` (string, required) - The memory content
 - `tags` (array, optional) - Tags for categorization
 - `importance_score` (number, optional) - Importance score 0-10
 - `metadata` (object, optional) - Additional metadata
 
-#### `unified_search`
-
-Unified search interface that consolidates all search modes: basic, intelligent, temporal, and vectorize.
-
-**Parameters:**
-
-- `query` (string, optional) - Full-text or semantic search query
-- `tags` (array, optional) - Filter by specific tags
-- `limit` (number, optional) - Maximum results (default: 10)
-- `offset` (number, optional) - Results offset (default: 0)
-- `min_importance` (number, optional) - Minimum importance score
-- `semantic` (boolean, optional) - Use AI-powered semantic search
-- `similarity_threshold` (number, optional) - Minimum similarity for semantic search
-
 #### `retrieve_memory`
-
 Retrieve a specific memory by ID.
 
 **Parameters:**
-
 - `id` (string, required) - The unique memory ID
 
-### Batch Operations
-
-#### `store_multiple_memories`
-
-Store multiple memories in a single batch operation.
-
-**Parameters:**
-
-- `memories` (array, required) - Array of memory objects to store
-
-#### `update_multiple_memories`
-
-Update multiple memories in a single batch operation.
+#### `update_memory`
+Update an existing memory.
 
 **Parameters:**
+- `id` (string, required) - Memory ID to update
+- `content` (string, optional) - New content
+- `tags` (array, optional) - New tags
+- `importance_score` (number, optional) - New importance score
+- `metadata` (object, optional) - New metadata
 
-- `updates` (array, required) - Array of memory updates with ID and data
-
-#### `search_and_update`
-
-Search for memories and update them in one operation.
+#### `delete_memory`
+Delete a memory and its relationships.
 
 **Parameters:**
+- `id` (string, required) - Memory ID to delete
 
-- `search` (object, required) - Search criteria
-- `update` (object, required) - Update data to apply
-
-### Graph & Relationship Operations
-
-#### `traverse_memory_graph`
-
-Traverse the memory graph from a starting point to find connected memories.
-
-**Parameters:**
-
-- `start_memory_id` (string, required) - Starting memory ID
-- `relationship_types` (array, optional) - Filter by relationship types
-- `max_depth` (number, optional) - Maximum traversal depth (default: 3)
-- `direction` (string, optional) - Direction: 'outgoing', 'incoming', or 'both'
-- `min_strength` (number, optional) - Minimum relationship strength
-
-#### `find_memory_path`
-
-Find a path between two memories through relationships.
-
-**Parameters:**
-
-- `start_memory_id` (string, required) - Starting memory ID
-- `end_memory_id` (string, required) - Target memory ID
-- `relationship_types` (array, optional) - Filter by relationship types
-- `max_depth` (number, optional) - Maximum path length (default: 5)
-- `min_strength` (number, optional) - Minimum relationship strength
-
-#### `get_related_memories`
-
-Get memories related to a specific memory with various options.
+#### `unified_search`
+Unified search interface consolidating all search modes: basic, intelligent, temporal, and vectorize.
 
 **Parameters:**
-
-- `memory_id` (string, required) - Memory ID to find related memories for
-- `relationship_types` (array, optional) - Filter by relationship types
-- `min_strength` (number, optional) - Minimum relationship strength
+- `query` (string, optional) - Full-text or semantic search query
+- `mode` (string, optional) - Search mode: 'basic', 'intelligent', 'temporal', 'vectorize'
+- `tags` (array, optional) - Filter by specific tags
 - `limit` (number, optional) - Maximum results (default: 10)
-- `include_indirect` (boolean, optional) - Include indirectly related memories
-- `max_hops` (number, optional) - Maximum hops for indirect relationships
-
-## 🤖 Smart Auto-Features (v2.0.0)
-
-### `suggest_relationships`
-
-Get intelligent relationship suggestions for a memory without automatically creating them.
-
-**Parameters:**
-- `memory_id` (string, required) - Memory ID to suggest relationships for
-
-**Returns:** Array of potential relationships with confidence scores and suggested actions.
-
-### `detect_duplicates`
-
-Detect potential duplicate memories with similarity analysis and merge strategies.
-
-**Parameters:**
-- `memory_id` (string, optional) - Specific memory to check for duplicates
-
-**Returns:** Array of potential duplicates with similarity scores and merge suggestions.
-
-### `suggest_tags`
-
-Get AI-powered tag suggestions based on content analysis and existing patterns.
-
-**Parameters:**
-- `content` (string, required) - Content to analyze for tag suggestions
-- `existing_tags` (array, optional) - Existing tags to exclude from suggestions
-
-**Returns:** Suggested tags with confidence scores and reasoning.
+- `semantic` (boolean, optional) - Use AI-powered semantic search
+- `time_context` (string, optional) - Temporal context: 'today', 'last_week', 'last_month'
 
-### `calculate_auto_importance`
+### Analytics & System (3 tools)
 
-Calculate automatic importance score based on multiple factors.
+#### `unified_analytics`
+Unified analytics interface for memory, usage, patterns, system, and collaboration analytics.
 
 **Parameters:**
-- `memory_id` (string, required) - Memory ID to calculate importance for
-
-**Returns:** Importance score with detailed factor analysis and reasoning.
+- `scope` (string, optional) - Analytics scope: 'memory', 'usage', 'patterns', 'system', 'collaboration'
+- `time_range` (string, optional) - Time range: 'day', 'week', 'month'
+- `analysis_type` (string, optional) - Analysis depth: 'basic', 'comprehensive', 'learning'
 
-### `improve_memory_quality`
-
-**Quality Auto-Improvement Engine** - Enhance memory quality using AI to boost quality scores from 27% to 60%+.
+#### `get_system_health_report`
+Generate comprehensive system health report with actionable insights.
 
 **Parameters:**
-- `memory_id` (string, optional) - Specific memory ID to improve. If not provided, improves batch of low-quality memories
-- `batch_size` (number, optional) - Number of memories to process in batch (default: 20)
-- `target_quality_threshold` (number, optional) - Target quality threshold - memories above this score are skipped (default: 60)
-- `improvement_types` (array, optional) - Types of improvements to apply: content_expansion, importance_recalculation, tag_enhancement, relationship_building
-- `dry_run` (boolean, optional) - If true, only analyze and suggest improvements without applying them
-
-**Returns:** Detailed improvement report with before/after quality scores, applied changes, and quality statistics.
+- `report_type` (string, optional) - Report type: 'summary', 'detailed', 'diagnostic'
+- `time_range` (string, optional) - Time range: 'day', 'week', 'month'
+- `include_recommendations` (boolean, optional) - Include optimization recommendations
 
-## 🧠 Intelligent Search & Collections (v2.0.0)
-
-### `intelligent_search`
-
-Advanced search combining semantic, keyword, and graph traversal with query expansion.
+#### `get_cleanup_suggestions`
+Get AI-powered cleanup suggestions for memory optimization.
 
 **Parameters:**
-- `query` (string, required) - Natural language search query
-- `auto_expand` (boolean, optional) - Automatically expand query with synonyms
-- `include_related` (number, optional) - Include related memories (number of hops)
-- `context_aware` (boolean, optional) - Apply context-aware ranking
-- `project_context` (string, optional) - Project context for ranking
+- `suggestion_types` (array, optional) - Types: 'duplicates', 'low_quality', 'orphaned', 'outdated'
+- `limit` (number, optional) - Maximum suggestions
 
-**Returns:** Search results with metadata about methods used and query expansion.
+### Unified Management Tools (6 tools)
 
-### `create_collection`
-
-Create a memory collection with optional auto-include criteria.
+#### `unified_relationships`
+Manage memory relationships: create, update, list, delete.
 
 **Parameters:**
-- `name` (string, required) - Collection name
-- `description` (string, optional) - Collection description
-- `auto_include_criteria` (object, optional) - Criteria for auto-populating collection
-- `sharing_permissions` (object, optional) - Sharing and access permissions
-
-### `project_onboarding`
+- `action` (string, required) - Action: 'create', 'update', 'list', 'delete'
+- `source_memory_id` (string, conditional) - Source memory ID (for create)
+- `target_memory_id` (string, conditional) - Target memory ID (for create)
+- `relationship_type` (string, conditional) - Relationship type
+- `relationship_id` (string, conditional) - Relationship ID (for update/delete)
+- `strength` (number, optional) - Relationship strength 0-1
 
-Smart workflow for automated project onboarding with knowledge extraction.
+#### `unified_collections`
+Manage memory collections: create, add, remove, get memories.
 
 **Parameters:**
-- `project_name` (string, required) - Name of the project
-- `project_description` (string, optional) - Project description
-- `technologies` (array, optional) - Technologies used in the project
-- `team_members` (array, optional) - Team members
-- `goals` (array, optional) - Project goals and objectives
+- `action` (string, required) - Action: 'create', 'add', 'remove', 'get_memories', 'list'
+- `name` (string, conditional) - Collection name (for create)
+- `collection_id` (string, conditional) - Collection ID
+- `memory_id` (string, conditional) - Memory ID (for add/remove)
 
-**Returns:** Complete onboarding results with key concepts, relationship map, knowledge gaps, and documentation suggestions.
-
-## ⏰ Context-Aware & Temporal Intelligence (v2.2.0)
-
-### `create_conversation_context`
-
-Create a new conversation context for tracking related memories.
+#### `unified_optimization`
+Run optimization operations: recommendations, comprehensive optimization.
 
 **Parameters:**
+- `action` (string, required) - Action: 'get_recommendations', 'run_comprehensive'
+- `optimization_scope` (string, optional) - Scope: 'quality', 'relationships', 'performance', 'comprehensive'
+- `dry_run` (boolean, optional) - Preview changes without applying
 
-- `context_name` (string, required) - Name for the conversation context
-- `description` (string, optional) - Description of the context
-- `metadata` (object, optional) - Additional context metadata
-
-### `activate_memory_in_context`
-
-Activate a memory within a specific conversation context.
+#### `unified_batch_jobs`
+Manage batch processing jobs: create, status, cancel, results.
 
 **Parameters:**
+- `action` (string, required) - Action: 'create', 'status', 'cancel', 'results'
+- `job_type` (string, conditional) - Job type (for create): 'quality_improvement', 'relationship_building', 'export', 'import'
+- `job_id` (string, conditional) - Job ID (for status/cancel/results)
 
-- `memory_id` (string, required) - Memory ID to activate
-- `context_id` (string, required) - Context ID to activate memory in
-- `activation_strength` (number, optional) - Strength of activation (0-1)
-
-### `get_context_memories`
-
-Get all memories associated with a conversation context.
+#### `unified_system_alerts`
+Manage system alerts: list, configure, resolve.
 
 **Parameters:**
+- `action` (string, required) - Action: 'list', 'configure', 'resolve'
+- `alert_id` (string, conditional) - Alert ID (for resolve)
+- `alert_types` (array, optional) - Alert types to configure
+- `thresholds` (object, optional) - Custom thresholds
 
-- `context_id` (string, required) - Context ID to get memories for
-- `include_inactive` (boolean, optional) - Include inactive memories
-- `sort_by_relevance` (boolean, optional) - Sort by temporal relevance
-
-### `evolve_memory`
-
-Create a new version of a memory with evolution tracking.
-
-**Parameters:**
-
-- `memory_id` (string, required) - Original memory ID
-- `new_content` (string, required) - Updated content
-- `evolution_type` (string, required) - Type of evolution (refinement, expansion, correction)
-- `evolution_summary` (string, optional) - Summary of changes
-
-### `analyze_memory_decay`
-
-Analyze temporal decay patterns for memories.
+#### `unified_agent_handoff`
+Manage agent handoff: get context, enable handoff, cleanup.
 
 **Parameters:**
+- `action` (string, required) - Action: 'get_context', 'enable_handoff', 'cleanup'
+- `session_id` (string, optional) - Session ID
 
-- `memory_id` (string, optional) - Specific memory to analyze
-- `time_range_days` (number, optional) - Time range for analysis (default: 30)
-- `include_predictions` (boolean, optional) - Include future decay predictions
+### Project Intelligence (1 tool)
 
-### `analyze_temporal_relationships`
-
-Analyze how relationships evolve over time.
+#### `get_complete_project_intelligence`
+Unified project intelligence combining scanning, briefing, and handoff summary.
 
 **Parameters:**
+- `project_path` (string, optional) - Path to project root
+- `project_name` (string, optional) - Project name
+- `briefing_type` (string, optional) - Briefing type: 'full', 'quick', 'technical', 'deployment', 'onboarding'
+- `include_components` (array, optional) - Components: 'scan', 'briefing', 'handoff', 'list'
 
-- `relationship_id` (string, optional) - Specific relationship to analyze
-- `memory_id` (string, optional) - Memory ID to analyze relationships for
-- `time_range_days` (number, optional) - Time range in days (default: 30)
-- `include_predictions` (boolean, optional) - Include future predictions
-
-## 🤝 Multi-Agent Collaboration (v2.3.0)
-
-### `register_agent`
+### Multi-Agent Collaboration (3 tools)
 
+#### `register_agent`
 Register a new agent in the system for collaboration.
 
 **Parameters:**
-
 - `name` (string, required) - Agent name
-- `type` (string, required) - Agent type: 'ai_agent', 'human_user', or 'system'
+- `type` (string, required) - Agent type: 'ai_agent', 'human_user', 'system'
 - `description` (string, optional) - Agent description
 - `capabilities` (array, optional) - Agent capabilities
-- `metadata` (object, optional) - Agent metadata
-
-### `create_memory_space`
 
+#### `create_memory_space`
 Create a collaborative memory space for multi-agent sharing.
 
 **Parameters:**
-
 - `name` (string, required) - Memory space name
-- `description` (string, optional) - Space description
 - `owner_agent_id` (string, required) - Agent ID who owns this space
-- `space_type` (string, optional) - Type: 'private', 'collaborative', or 'public'
-- `access_policy` (string, optional) - Policy: 'open', 'invite_only', or 'restricted'
-
-### `grant_space_permission`
-
-Grant permission to an agent for a memory space.
-
-**Parameters:**
-
-- `space_id` (string, required) - Memory space ID
-- `agent_id` (string, required) - Agent ID to grant permission to
-- `permission_level` (string, required) - Level: 'read', 'write', or 'admin'
-- `granted_by` (string, required) - Agent ID granting the permission
-
-### `add_memory_to_space`
-
-Add a memory to a collaborative space.
-
-**Parameters:**
-
-- `memory_id` (string, required) - Memory ID to add
-- `space_id` (string, required) - Space ID to add memory to
-- `added_by` (string, required) - Agent ID adding the memory
-- `access_level` (string, optional) - Access level for this memory
-
-### `get_agent_spaces`
+- `space_type` (string, optional) - Type: 'private', 'collaborative', 'public'
+- `access_policy` (string, optional) - Policy: 'open', 'invite_only', 'restricted'
 
+#### `get_agent_spaces`
 Get all memory spaces accessible to an agent.
 
 **Parameters:**
-
 - `agent_id` (string, required) - Agent ID to get spaces for
 
-### `get_space_memories`
-
-Get all memories in a space (requires permission).
-
-**Parameters:**
-
-- `space_id` (string, required) - Space ID to get memories from
-- `agent_id` (string, required) - Agent ID requesting access
-
-## 🔄 Memory Synchronization (v2.3.0)
-
-### `sync_memory`
-
-Synchronize a memory with another instance.
-
-**Parameters:**
-
-- `memory_id` (string, required) - Memory ID to synchronize
-- `target_instance` (string, required) - Target instance identifier
-- `force_sync` (boolean, optional) - Force sync even if already synced
-- `conflict_resolution` (string, optional) - Strategy: 'manual', 'auto_merge', 'source_wins', 'target_wins'
-
-### `resolve_sync_conflict`
-
-Resolve a synchronization conflict.
-
-**Parameters:**
-
-- `conflict_id` (string, required) - Conflict ID to resolve
-- `resolution_method` (string, required) - Resolution method
-- `resolved_by` (string, required) - Agent ID resolving the conflict
-- `resolved_version` (object, optional) - Manually resolved version
-
-### `get_sync_status`
-
-Get synchronization status for a memory.
-
-**Parameters:**
-
-- `memory_id` (string, required) - Memory ID to check sync status for
-
-## 📤 Export/Import Operations (v2.3.0)
-
-### `create_export_job`
+### Export/Import (2 tools)
 
+#### `create_export_job`
 Create an export job for memories.
 
 **Parameters:**
-
 - `format` (string, required) - Export format: 'json', 'xml', 'markdown', 'csv', 'graphml'
+- `initiated_by` (string, required) - Agent ID initiating export
 - `memory_ids` (array, optional) - Specific memory IDs to export
-- `space_ids` (array, optional) - Memory space IDs to export
 - `include_relationships` (boolean, optional) - Include memory relationships
-- `include_metadata` (boolean, optional) - Include full metadata
-- `initiated_by` (string, required) - Agent ID initiating export
-
-### `get_export_job`
-
-Get export job status and download information.
-
-**Parameters:**
-
-- `job_id` (string, required) - Export job ID
-
-### `create_import_job`
 
+#### `create_import_job`
 Create an import job for memories.
 
 **Parameters:**
-
 - `format` (string, required) - Import format
 - `file_content` (string, required) - File content to import
-- `target_space_id` (string, optional) - Target space to import into
-- `conflict_resolution` (string, optional) - How to handle existing memories
 - `initiated_by` (string, required) - Agent ID initiating import
+- `conflict_resolution` (string, optional) - How to handle existing memories: 'skip', 'overwrite', 'merge'
 
-## 📊 Analytics & Monitoring (v2.3.0)
-
-### ⚡ KV Optimization & Monitoring (v2.8.0)
-
-#### `get_kv_usage_stats`
-
-Get current KV storage usage statistics and daily limits.
-
-**Returns:** Current daily usage, remaining writes, usage percentage, and warnings.
-
-#### `get_kv_usage_trends`
-
-Get KV usage trends over the past week.
-
-**Returns:** Daily usage trends with writes, reads, deletes, and total operations.
-
-#### `get_cache_optimization_recommendations`
-
-Get recommendations for optimizing KV cache usage.
-
-**Returns:** Personalized optimization recommendations based on usage patterns.
-
-#### `migrate_analytics_to_d1`
-
-Migrate existing analytics data from KV to D1 database to reduce KV writes.
-
-**Returns:** Migration results with migrated keys and any errors.
-
-#### `flush_cache_queue`
-
-Manually flush the optimized cache write queue to KV storage.
-
-**Returns:** Cache statistics including in-memory entries and queue size.
-
-### `track_memory_analytics`
-
-Track a memory analytics event.
-
-**Parameters:**
-
-- `memory_id` (string, required) - Memory ID
-- `agent_id` (string, required) - Agent ID performing the action
-- `action_type` (string, required) - Action: 'create', 'read', 'update', 'delete', 'search', 'relate'
-- `session_id` (string, optional) - Session identifier
-- `context_data` (object, optional) - Context data about the action
-- `performance_metrics` (object, optional) - Performance metrics
-
-### `get_memory_analytics`
-
-Get memory usage analytics.
-
-**Parameters:**
-
-- `memory_id` (string, optional) - Specific memory ID
-- `agent_id` (string, optional) - Specific agent ID
-- `action_type` (string, optional) - Specific action type
-- `start_date` (string, optional) - Start date for analytics
-- `end_date` (string, optional) - End date for analytics
-- `limit` (number, optional) - Maximum number of results
-
-### `get_collaboration_analytics`
-
-Get collaboration event analytics.
-
-**Parameters:**
-
-- `space_id` (string, optional) - Specific space ID
-- `agent_id` (string, optional) - Specific agent ID
-- `event_type` (string, optional) - Specific event type
-- `start_date` (string, optional) - Start date for analytics
-- `end_date` (string, optional) - End date for analytics
-- `limit` (number, optional) - Maximum number of results
-
-## 🧠 Memory Intelligence Engine (v2.7.0)
-
-### `initialize_adaptive_thresholds`
-
-Initialize adaptive thresholds for automated learning optimization.
-
-**Parameters:**
-
-- `threshold_types` (array, optional) - Types of thresholds to initialize (quality, relevance, importance, relationship_strength)
-- `baseline_values` (object, optional) - Optional baseline values for thresholds
-
-**Returns:** Number of thresholds initialized and their current values.
-
-### `create_learning_experiment`
-
-Create a new learning experiment for A/B testing and optimization.
-
-**Parameters:**
-
-- `experiment_name` (string, required) - Name of the experiment
-- `experiment_type` (string, required) - Type of experiment (quality_improvement, relationship_discovery, tag_enhancement, content_expansion)
-- `hypothesis` (string, required) - Hypothesis being tested
-- `success_criteria` (object, required) - Success criteria for the experiment
-- `control_group_size` (number, optional) - Size of control group (default: 100)
-- `test_group_size` (number, optional) - Size of test group (default: 100)
-- `confidence_threshold` (number, optional) - Statistical confidence threshold (default: 0.95)
-- `created_by` (string, optional) - Creator of the experiment
-
-**Returns:** Experiment ID and creation confirmation.
-
-### `run_ab_test`
-
-Run A/B test for a specific learning experiment.
-
-**Parameters:**
-
-- `experiment_id` (string, required) - ID of the experiment to run
-- `memory_ids` (array, required) - Memory IDs to include in the test
-- `test_strategy` (string, optional) - Strategy for splitting test groups (random_split, importance_based, content_length_based)
-
-**Returns:** Control and test group assignments with group sizes.
-
-### `analyze_experiment_results`
-
-Analyze results from a learning experiment and make threshold adjustments.
-
-**Parameters:**
-
-- `experiment_id` (string, required) - ID of the experiment to analyze
-- `include_recommendations` (boolean, optional) - Include optimization recommendations (default: true)
-
-**Returns:** Number of adjustments made and optimization recommendations.
-
-### `run_improvement_cycle`
-
-Run a complete self-improvement cycle with automated optimizations.
-
-**Parameters:**
-
-- `cycle_type` (string, optional) - Type of improvement cycle (full, quality_focused, relationship_focused, performance_focused)
-- `max_improvements` (number, optional) - Maximum number of improvements to apply (default: 5)
-
-**Returns:** Number of improvements applied, performance gain percentage, and next cycle scheduling.
-
-## 🎯 Cloudflare Vectorize Integration (v2.8.1) - Paid Tier
-
-The Vectorize integration provides lightning-fast semantic search using Cloudflare's dedicated vector database. This paid tier enhancement offers superior performance compared to D1-based embeddings with 50M queries/month and 10M stored dimensions/month.
-
-### Setup Instructions
-
-For paid tier users, enable Vectorize with:
-
-```bash
-# Setup Vectorize index and configuration
-npm run setup-vectorize
-
-# Deploy with Vectorize enabled
-npm run setup-paid-tier
-```
-
-This creates the `cf-memory-embeddings` Vectorize index with 768 dimensions (BGE-base-en-v1.5 compatible) and cosine similarity metric.
-
-### Hybrid D1+Vectorize Architecture
-
-The system uses a hybrid approach combining both databases:
-
-- **D1 Database**: Stores all memory metadata, content, tags, relationships, and serves as fallback for semantic search
-- **Vectorize**: Stores only vector embeddings for ultra-fast semantic similarity search
-- **Hybrid Search Flow**: Vectorize finds similar vectors → D1 enriches with full memory data → ranked results returned
-- **Fallback Mechanism**: If Vectorize fails, system automatically uses D1-based semantic search
-- **Data Consistency**: Both databases stay synchronized when memories are created/updated/deleted
-
-### `vectorize_semantic_search`
-
-Perform advanced semantic search using Cloudflare Vectorize for superior speed and accuracy.
-
-**Parameters:**
-
-- `query` (string, required) - Search query for semantic similarity
-- `limit` (number, optional) - Maximum number of results (default: 10)
-- `filter` (object, optional) - Metadata filters to apply
-- `return_vectors` (boolean, optional) - Include vector data in results (default: false)
-
-**Returns:** Array of search results with similarity scores, metadata, and optional vector data.
-
-### `vectorize_find_similar`
-
-Find memories similar to a specific memory using vector similarity.
-
-**Parameters:**
-
-- `memory_id` (string, required) - Memory ID to find similar memories for
-- `limit` (number, optional) - Maximum number of results (default: 10)
-- `similarity_threshold` (number, optional) - Minimum similarity score (default: 0.7)
-- `exclude_self` (boolean, optional) - Exclude the source memory from results (default: true)
-
-**Returns:** Array of similar memories with similarity scores and metadata.
-
-### `vectorize_cluster_memories`
-
-Perform AI-powered clustering analysis using vector similarity to group related memories.
-
-**Parameters:**
-
-- `memory_ids` (array, required) - Array of memory IDs to cluster
-- `cluster_count` (number, optional) - Number of clusters to create (default: 5)
-
-**Returns:** Array of clusters with cluster IDs, memory IDs in each cluster, and centroid similarity scores.
-
-### `vectorize_index_stats`
-
-Get statistics and information about the Vectorize index.
-
-**Returns:** Index statistics including dimensions, vector count, and configuration details.
-
-### Paid Tier Benefits
+---
 
-- **50M Queries/Month**: Massive query capacity for high-volume applications
-- **10M Stored Dimensions/Month**: Store millions of memory vectors
-- **33x More KV Writes**: Increased from 1,000 to 33,333 daily KV operations
-- **10x Larger Batches**: Process up to 500 memories per batch operation
-- **6x Faster Learning**: Learning cycles run every 5 minutes instead of 30 minutes
-- **50-70% Performance Boost**: Significantly faster response times through optimized caching
+### Tool Consolidation Summary (v3.2.0)
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| Core CRUD | 5 | store, retrieve, update, delete, unified_search |
+| Analytics | 3 | unified_analytics, health_report, cleanup_suggestions |
+| Unified Management | 6 | relationships, collections, optimization, batch_jobs, alerts, handoff |
+| Project Intelligence | 1 | get_complete_project_intelligence |
+| Collaboration | 3 | register_agent, create_memory_space, get_agent_spaces |
+| Export/Import | 2 | create_export_job, create_import_job |
+| **Total** | **20** | Reduced from 95+ tools (79% reduction) |
 
 ## 🌐 Architecture
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cf-memory-mcp",
-	"version": "3.2.0",
+	"version": "3.3.0",
 	"description": "Best-in-class MCP (Model Context Protocol) server for AI memory storage with MIRIX-Inspired Specialized Memory Types (Core, Episodic, Semantic, Procedural, Resource, Knowledge Vault), Progressive Disclosure, AI-Powered Summaries, Context Window Optimization, Summary Memory Feature (TL;DR), Enhanced JSON Processing, Temporal Relationship Tracking, AI-Enhanced Context-Aware + Temporal Intelligence, Smart Tool Recommendation Engine, Memory Intelligence Engine, autonomous optimization, A/B testing, self-improving algorithms, intelligent search, smart auto-features, memory collections, project onboarding workflows, advanced lifecycle management, Project Intelligence for seamless agent handoff, and Unified Project Intelligence Tool with 57% performance improvement",
 	"main": "bin/cf-memory-mcp.js",
 	"bin": {