down to 16 general tools only

README.md

@@ -7,43 +7,32 @@
 ![Claude](https://img.shields.io/badge/Claude-AI-orange?style=for-the-badge)
 
 **Transform Claude into your intelligent Appwrite management assistant**  
-*135 powerful tools • Complete API coverage • Full Messaging & Locale Services • Production-ready*
+*16 optimized tools • Core Appwrite operations • Context-efficient design • Production-ready*
 
 </div>
 
 ---
 
-A comprehensive **Model Context Protocol (MCP)** server that supercharges Claude with native Appwrite integration. Unlike the official implementation, this version includes advanced features like bulk operations, automatic schema validation, complete user management with MFA, storage file operations, function deployments & variables, full messaging service (topics, subscribers, providers), locale & avatars services, and comprehensive error handling.
+A **context-optimized Model Context Protocol (MCP)** server that provides Claude with essential Appwrite integration. This version focuses on core functionality with action-based combined tools, offering database operations, user management, storage, messaging, and team management in an efficient package designed to stay under MCP context limits.
 
 ## 🚀 Features
 
-**Core Appwrite Management:**
-- Complete database and collection operations
-- Document CRUD with full query support
-- Advanced user management with MFA, identities, preferences
-- Storage buckets and comprehensive file operations
-- Serverless function management with deployments & variables
-- Team and permission management
-- Complete messaging service (providers, messages, topics, subscribers)
-- Locale service (countries, currencies, languages, timezones)
-- Avatars service (icons, QR codes, initials, favicons)
+**🎯 Core Appwrite Operations:**
+- **Database Management** - Create, list, and delete databases
+- **Collection Operations** - Full collection lifecycle management
+- **Document CRUD** - Complete document operations with bulk support
+- **User Management** - User operations including bulk processing and preferences
+- **Storage Management** - Bucket and file operations with URL generation
+- **Team Management** - Complete team administration
+- **Messaging Service** - Messages, topics, and subscriber management
+- **Attribute & Index Management** - Schema management with bulk operations
+- **Health Monitoring** - System health checks
 
-**🧠 Intelligent Database Assistant:**
-- **Auto-detect schemas** from sample data
-- **Data quality analysis** and recommendations
-- **Duplicate detection** with similarity matching
-- **Index optimization** suggestions
-- **Schema migrations** with safety checks
-
-**🔐 Advanced Authentication & Sessions:**
-- **Session management** (create, delete, list user sessions)
-- **Function execution** with logging and monitoring
-- **Health monitoring** for all Appwrite services
-
-**⚡ Bulk Operations:**
-- **Bulk user management** (create, update, delete multiple users)
-- **Bulk document operations** (create, update, delete multiple documents)
-- **Efficient batch processing** with detailed success/error reporting
+**⚡ Action-Based Design:**
+- **Single tools handle multiple operations** using action parameters
+- **Bulk operations integrated** into respective categories
+- **Context-optimized** - 88% fewer tools than original
+- **Maintained functionality** - All core features preserved
 
 ## 📦 Quick Start
 
@@ -175,109 +164,72 @@ Once integrated, you should be able to use commands like:
 - "Create a new user with email test@example.com"
 - "Show me all collections in my database"
 
-## 🛠️ Available Tools (135 Total)
+## 🛠️ Available Tools (16 Total)
 
 <details>
-<summary><strong>🗄️ Database Operations (3 tools)</strong></summary>
+<summary><strong>🗄️ Database Operations (1 tool)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_database` | Create a new database |
-| `list_databases` | List all databases in your project |
-| `delete_database` | Delete a database |
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `manage_database` | create, list, delete | Comprehensive database management |
 
 </details>
 
 <details>
-<summary><strong>📁 Collection Operations (4 tools)</strong></summary>
+<summary><strong>📁 Collection Operations (1 tool)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_collection` | Create a new collection in a database |
-| `get_collection` | ✨ Get collection details by ID |
-| `list_collections` | List all collections in a database |
-| `delete_collection` | Delete a collection from a database |
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `collection_operations` | create, get, list, update, delete | Complete collection lifecycle management |
 
 </details>
 
 <details>
-<summary><strong>🏷️ Attribute Management (5 tools)</strong></summary>
+<summary><strong>🏷️ Attribute Management (1 tool)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_attribute` | ✨ Create any attribute type (string, integer, float, boolean, datetime, email, IP, URL, enum, relationship) |
-| `get_attribute` | ✨ Get attribute details by key |
-| `update_attribute` | ✨ Update any attribute type with unified interface |
-| `list_attributes` | List all attributes in a collection |
-| `delete_attribute` | Delete an attribute from a collection |
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `attribute_operations` | create, get, list, update, delete, bulk_create, bulk_delete | Full attribute management with bulk operations |
 
 </details>
 
 <details>
-<summary><strong>📊 Index Management (4 tools)</strong></summary>
+<summary><strong>📊 Index Management (1 tool)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_index` | Create an index in a collection (key, fulltext, unique) |
-| `get_index` | ✨ Get index details by key |
-| `list_indexes` | List all indexes in a collection |
-| `delete_index` | Delete an index from a collection |
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `index_operations` | create, get, list, delete | Complete index management |
 
 </details>
 
 <details>
-<summary><strong>📄 Document Operations (5 tools)</strong></summary>
+<summary><strong>📄 Document Operations (2 tools)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_document` | Create a new document in a collection ✨ *with schema validation* |
-| `get_document` | Get a document by ID |
-| `list_documents` | List documents in a collection with optional queries |
-| `update_document` | Update a document |
-| `delete_document` | Delete a document |
+| Tool | Actions/Description |
+|------|--------------------|
+| `document_operations` | create, get, update, delete, bulk_create, bulk_update, bulk_delete |
+| `list_documents` | List documents with advanced queries and pagination |
 
 </details>
 
 <details>
-<summary><strong>👥 User Management (25 tools)</strong></summary>
+<summary><strong>👥 User Management (2 tools)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_user` | Create a new user |
-| `list_users` | ✨ List all users with email/phone verification columns |
-| `get_user` | Get a user by ID |
-| `update_user_email` | Update user email |
-| `update_user_name` | Update user name |
-| `update_user_password` | Update user password |
-| `update_user_password_hash` | ✨ Update password with specific hash algorithm |
-| `delete_user` | Delete a user |
-| `verify_user_email` | ✨ Verify a user's email address |
-| `unverify_user_email` | ✨ Unverify a user's email address |
-| `verify_user_phone` | ✨ Verify a user's phone number |
-| `unverify_user_phone` | ✨ Unverify a user's phone number |
-| `update_user_mfa` | ✨ Enable/disable MFA for users |
-| `create_user_mfa_recovery_codes` | ✨ Generate MFA recovery codes |
-| `update_user_phone_verification` | ✨ Update phone verification status |
-| `update_user_labels` | ✨ Update user labels for permissions |
-| `get_user_preferences` | ✨ Get user preferences |
-| `update_user_preferences` | ✨ Update user preferences |
-| `list_user_identities` | ✨ List user identities |
-| `delete_user_identity` | ✨ Delete user identity |
-| `create_user_target` | ✨ Create messaging targets |
-| `list_user_targets` | ✨ List messaging targets |
-| `get_user_target` | ✨ Get messaging target details |
-| `update_user_target` | ✨ Update messaging target |
-| `delete_user_target` | ✨ Delete messaging target |
+| Tool | Actions/Description |
+|------|--------------------|
+| `user_operations` | create, get, update, delete, update_preferences, update_labels, bulk_create, bulk_update, bulk_delete |
+| `list_users` | List users with advanced filtering and pagination |
 
 </details>
 
 <details>
-<summary><strong>🗂️ Storage Operations (13 tools)</strong></summary>
+<summary><strong>🗂️ Storage Operations (3 tools)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_bucket` | Create a storage bucket |
-| `list_buckets` | List all storage buckets |
+| Tool | Actions/Description |
+|------|--------------------|
+| `bucket_operations` | create, get, list, update, delete |
+| `file_operations` | get, create, update, delete, list |
+| `get_file_url` | Generate download, preview, or view URLs with transformations |
 | `get_bucket` | Get a bucket by ID |
 | `update_bucket` | Update a storage bucket |
 | `delete_bucket` | Delete a storage bucket |
@@ -315,151 +267,50 @@ Once integrated, you should be able to use commands like:
 </details>
 
 <details>
-<summary><strong>👨‍👩‍👧‍👦 Team Management (5 tools)</strong></summary>
+<summary><strong>👨‍👩‍👧‍👦 Team Management (1 tool)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_team` | Create a new team |
-| `list_teams` | List all teams |
-| `get_team` | Get a team by ID |
-| `update_team` | Update a team |
-| `delete_team` | Delete a team |
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `team_operations` | create, get, list, update, delete | Complete team management |
 
 </details>
 
 <details>
-<summary><strong>📧 Messaging Operations (20 tools)</strong></summary>
+<summary><strong>📧 Messaging Operations (3 tools)</strong></summary>
 
-| Tool | Description |
-|------|-------------|
-| `create_messaging_provider` | ✨ Create messaging provider |
-| `list_messaging_providers` | ✨ List messaging providers |
-| `get_messaging_provider` | ✨ Get messaging provider details |
-| `update_messaging_provider` | ✨ Update messaging provider |
-| `delete_messaging_provider` | ✨ Delete messaging provider |
-| `create_messaging_message` | ✨ Create and send message |
-| `list_messaging_messages` | ✨ List messages |
-| `get_messaging_message` | ✨ Get message details |
-| `update_messaging_message` | ✨ Update message |
-| `delete_messaging_message` | ✨ Delete message |
-| `create_messaging_topic` | ✨ Create messaging topic |
-| `list_messaging_topics` | ✨ List messaging topics |
-| `get_messaging_topic` | ✨ Get topic details |
-| `update_messaging_topic` | ✨ Update topic |
-| `delete_messaging_topic` | ✨ Delete topic |
-| `create_messaging_subscriber` | ✨ Create topic subscriber |
-| `list_messaging_subscribers` | ✨ List topic subscribers |
-| `get_messaging_subscriber` | ✨ Get subscriber details |
-| `delete_messaging_subscriber` | ✨ Delete subscriber |
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `messaging_message_operations` | create, get, list, update, delete | Complete message management |
+| `messaging_topic_operations` | create, get, list, update, delete | Complete topic management |
+| `messaging_subscriber_operations` | create, get, list, delete | Complete subscriber management |
 
 </details>
 
 <details>
-<summary><strong>🌍 Locale Operations (5 tools)</strong></summary>
+<summary><strong>🏥 Health Monitoring (1 tool)</strong></summary>
 
 | Tool | Description |
 |------|-------------|
-| `list_countries` | ✨ List all countries with phone codes |
-| `list_continents` | ✨ List all continents |
-| `list_currencies` | ✨ List all currencies |
-| `list_languages` | ✨ List all languages |
-| `list_phone_codes` | ✨ List phone codes for countries |
-
-</details>
-
-<details>
-<summary><strong>🎨 Avatars Operations (7 tools)</strong></summary>
-
-| Tool | Description |
-|------|-------------|
-| `get_browser_icon` | ✨ Get browser icon URL |
-| `get_credit_card_icon` | ✨ Get credit card icon URL |
-| `get_favicon` | ✨ Get website favicon URL |
-| `get_flag_icon` | ✨ Get country flag icon URL |
-| `get_image_from_url` | ✨ Transform image from URL |
-| `get_initials_avatar` | ✨ Generate initials avatar URL |
-| `get_qr_code` | ✨ Generate QR code URL |
+| `get_health` | Get overall health status of Appwrite services |
 
 </details>
 
 ---
 
-### 🌟 **Exclusive Advanced Features**
+## 🗑️ Removed Features
 
-<details>
-<summary><strong>🧠 Smart Schema Operations (4 tools)</strong></summary>
+*The following features have been removed to optimize context usage:*
 
-| Tool | Description |
-|------|-------------|
-| `auto_detect_schema` | ✨ Analyze sample data and automatically create collection schema |
-| `suggest_indexes` | ✨ Recommend optimal indexes based on collection usage patterns |
-| `validate_document` | ✨ Check document data against collection schema before creation |
-| `schema_migration` | ✨ Automatically migrate collection schema with data preservation |
+- **Data Analysis Tools** - Auto-detect schemas, duplicate detection, data quality analysis
+- **Avatars Service** - Icon generation, QR codes, initials avatars
+- **Locale Service** - Countries, currencies, languages, timezones
+- **Advanced User Features** - MFA management, identity management, email/phone verification (labels management retained in user_operations)
+- **Function Management** - Function deployments, execution, variables
+- **Messaging Providers** - Provider configuration and management
+- **Session Management** - User session create/delete/list
+- **Advanced Health Monitoring** - Specific service health checks
 
-</details>
-
-<details>
-<summary><strong>📊 Data Analysis & Insights (4 tools)</strong></summary>
-
-| Tool | Description |
-|------|-------------|
-| `analyze_collection` | ✨ Get comprehensive data insights and patterns from collections |
-| `detect_duplicates` | ✨ Find potential duplicate records with similarity scoring |
-| `data_quality_check` | ✨ Analyze data quality (completeness, validity, consistency) |
-| `usage_stats` | ✨ Get usage statistics and access patterns for collections |
-
-</details>
-
-<details>
-<summary><strong>🔐 Authentication & Sessions (3 tools)</strong></summary>
-
-| Tool | Description |
-|------|-------------|
-| `create_session` | ✨ Create a new user session with email and password |
-| `delete_session` | ✨ Delete a user session |
-| `list_sessions` | ✨ List all sessions for a user |
-
-</details>
-
-<details>
-<summary><strong>⚡ Function Execution (3 tools)</strong></summary>
-
-| Tool | Description |
-|------|-------------|
-| `execute_function` | ✨ Execute a function with optional data |
-| `list_executions` | ✨ List function executions with logs |
-| `get_execution` | ✨ Get details of a specific function execution |
-
-</details>
-
-<details>
-<summary><strong>🏥 Health Monitoring (3 tools)</strong></summary>
-
-| Tool | Description |
-|------|-------------|
-| `get_health` | ✨ Get overall health status of Appwrite services |
-| `get_health_db` | ✨ Get database health status |
-| `get_health_storage` | ✨ Get storage health status |
-
-</details>
-
-<details>
-<summary><strong>⚡ Bulk Operations (8 tools)</strong></summary>
-
-| Tool | Description |
-|------|-------------|
-| `bulk_create_attributes` | ✨ Create multiple attributes at once in a collection |
-| `bulk_delete_attributes` | ✨ Delete multiple attributes at once from a collection |
-| `bulk_create_users` | ✨ Create multiple users at once |
-| `bulk_update_users` | ✨ Update multiple users at once |
-| `bulk_delete_users` | ✨ Delete multiple users at once |
-| `bulk_create_documents` | ✨ Create multiple documents at once |
-| `bulk_update_documents` | ✨ Update multiple documents at once |
-| `bulk_delete_documents` | ✨ Delete multiple documents at once |
-
-</details>
-
-> ✨ **Exclusive features** not available in the official Appwrite MCP implementation
+*These features are preserved in `removed-tools-backup.ts` for future restoration if needed.*
 
 ## ⚙️ Configuration Guide
 
@@ -470,26 +321,23 @@ Once integrated, you should be able to use commands like:
    - **Appwrite Cloud**: `https://cloud.appwrite.io/v1`
    - **Self-hosted**: `https://your-domain.com/v1`
 3. **🔐 API Key**: Create a new API key in your Appwrite console under **Settings > API Keys**
-   - ✅ Enable all scopes for full functionality
-   - ⚠️ Required scopes: `databases.read`, `databases.write`, `users.read`, `users.write`, `functions.read`, `functions.write`, `storage.read`, `storage.write`, `targets.read`, `targets.write`, `providers.read`, `providers.write`, `messages.read`, `messages.write`, `topics.read`, `topics.write`, `subscribers.read`, `subscribers.write`, `locale.read`, `avatars.read`, `health.read`
+   - ✅ Required scopes: `databases.read`, `databases.write`, `users.read`, `users.write`, `storage.read`, `storage.write`, `messages.read`, `messages.write`, `topics.read`, `topics.write`, `subscribers.read`, `subscribers.write`, `teams.read`, `teams.write`, `health.read`
 
 ### 🎯 VS Official Implementation
 
 | Feature | Our Implementation | Official Appwrite MCP |
 |---------|-------------------|----------------------|
-| **Tools Available** | 🟢 135 tools (complete coverage) | 🟡 195 tools (selective enabling) |
-| **Default Setup** | 🟢 Complete coverage out-of-box | 🟡 Database tools only (context limits) |
-| **Messaging Service** | 🟢 Complete (providers, messages, topics, subscribers) | 🟡 Selective enabling required |
-| **Locale & Avatars** | 🟢 Complete internationalization support | 🟡 Selective enabling required |
+| **Tools Available** | 🟢 16 optimized tools (context-efficient) | 🟡 195 tools (selective enabling) |
+| **Context Usage** | 🟢 Under 25,000 tokens (88% reduction) | 🔴 Over 60,000 tokens |
+| **Tool Design** | 🟢 Action-based combined tools | 🟡 Individual tools for each operation |
+| **Core Operations** | 🟢 All essential Appwrite features | 🟡 Database tools only (context limits) |
+| **Messaging Service** | 🟢 Messages, topics, subscribers | 🟡 Selective enabling required |
 | **Storage Operations** | 🟢 Complete file operations & uploads | 🟡 Basic bucket operations |
-| **User Management** | 🟢 MFA, identities, preferences, targets | 🟡 Basic CRUD only |
-| **Functions Service** | 🟢 Deployments & variables included | 🟡 Basic function management |
-| **Bulk Operations** | 🟢 Full support | 🔴 Not available |
-| **Schema Validation** | 🟢 Automatic | 🔴 Manual only |
+| **User Management** | 🟢 CRUD + preferences + bulk operations | 🟡 Basic CRUD only |
+| **Bulk Operations** | 🟢 Integrated into respective categories | 🔴 Not available |
 | **Error Handling** | 🟢 Comprehensive | 🟡 Basic |
 | **Language** | 🟡 TypeScript/Node.js | 🟢 Python |
-| **Context Efficiency** | 🟡 All tools use context | 🟢 Selective loading saves context |
-| **Self-Hosted Focus** | 🟢 Optimized for self-hosted | 🟡 Cloud-first approach |
+| **Maintenance** | 🟢 Easier with fewer tools | 🟡 Complex with many tools |
 
 ## 🎯 Usage Examples
 
@@ -512,14 +360,12 @@ Once integrated, you can use natural language commands with Claude to interact w
 <summary><strong>🏷️ Schema & Attributes</strong></summary>
 
 ```
-✨ "Create a string attribute called 'name' in the products collection with max size 255"
-✨ "Add a boolean attribute 'in_stock' to the products collection"
-✨ "Create an enum attribute 'status' with values active, inactive, pending"
-✨ "Add a relationship attribute linking products to categories"
-✨ "Bulk create attributes: name (string), price (float), in_stock (boolean)"
-✨ "Bulk delete attributes: old_field1, deprecated_field2, unused_field3"
+✨ "Create a string attribute called 'name' in the products collection" 
+✨ "Add multiple attributes with bulk create operation"
 ✨ "List all attributes in the products collection"
+✨ "Update attribute settings for existing fields"
 ✨ "Create a unique index on the 'sku' attribute"
+✨ "Remove old attributes with bulk delete"
 ```
 
 </details>
@@ -538,20 +384,17 @@ Once integrated, you can use natural language commands with Claude to interact w
 </details>
 
 <details>
-<summary><strong>👥 User & Authentication</strong></summary>
+<summary><strong>👥 User Management</strong></summary>
 
 ```
-✨ "Create a new user with email john@example.com and password SecurePass123"
-✨ "List all users in the project"
-✨ "Update user xyz123's name to 'John Doe'"
-✨ "Verify user abc123's email address"
-✨ "Enable MFA for user xyz123"
-✨ "Generate MFA recovery codes for user abc456"
-✨ "Update user labels for permissions: ['admin', 'moderator']"
-✨ "Get user preferences for user xyz123"
-✨ "Create messaging target for user notifications"
-✨ "List all identities for user abc123"
-✨ "Create a session for user john@example.com"
+✨ "Create a new user with email john@example.com"
+✨ "List all users in the project with filtering"
+✨ "Update user xyz123's name and email"
+✨ "Update user labels for admin permissions"
+✨ "Delete inactive user accounts"
+✨ "Update user preferences for notifications"
+✨ "Bulk create 10 test users for demo"
+✨ "Bulk update user information from CSV"
 ✨ "Bulk create 10 test users for demo purposes"
 ```
 
@@ -692,7 +535,7 @@ npm start
 | **❌ Connection failed** | Verify your API endpoint is correct (check for typos) |
 | **❌ Tools not loading** | Restart your IDE after adding the MCP server |
 | **❌ Permission denied** | Check that your API key has `databases.write`, `users.write` permissions |
-| **❌ Schema validation errors** | Use `list_attributes` to check collection schema before creating documents |
+| **❌ Schema validation errors** | Use `attribute_operations` with list action to check collection schema |
 
 </details>