Merge remote-tracking branch 'origin/feature/MCP-Connections' into hawk/testing

# Conflicts:
#	_documentation/5-Deployment/3-Docker Deployment.md
#	app/Providers/AppServiceProvider.php

Author: Neunerlei

_docker_production/config/model_providers.php

@@ -1,7 +1,7 @@
 <?php
 
 return [
-    
+
     /*
     |--------------------------------------------------------------------------
     |   Default AI Models
@@ -13,10 +13,10 @@
     'default_models' => [
         'default_model' => env('DEFAULT_MODEL', 'gpt-4.1-nano'),
         'default_web_search_model' => env('DEFAULT_WEBSEARCH_MODEL', 'gemini-2.0-flash'),
-        'default_file_upload_model' => env('DEFAULT_FILEUPLOAD_MODEL', 'meta-llama-3.1-8b-instruct'),
-        'default_vision_model' => env('DEFAULT_VISION_MODEL', 'qwen2.5-vl-72b-instruct'),
+        'default_file_upload_model' => env('DEFAULT_FILEUPLOAD_MODEL', 'qwen3-omni-30b-a3b-instruct'),
+        'default_vision_model' => env('DEFAULT_VISION_MODEL', 'qwen3-omni-30b-a3b-instruct'),
     ],
-    
+
     /*
      * The default models to use when accessing HAWKI via an external application
      * If null, the general default models are used above (can be useful to prevent high cost models being used by external apps)
@@ -27,7 +27,7 @@
 //        'default_file_upload_model' => null,
 //        'default_vision_model' => null,
     ],
-    
+
     /*
     |--------------------------------------------------------------------------
     |   System Models
@@ -44,7 +44,7 @@
         'prompt_improver' => env('PROMPT_IMPROVEMENT_MODEL', 'gpt-4.1-nano'),
         'summarizer' => env('SUMMARIZER_MODEL', 'gpt-4.1-nano'),
     ],
-    
+
     /*
      * The system models to use when accessing HAWKI via an external application
      * If null, the general system models are used above (can be useful to prevent high cost models being used by external apps)
@@ -54,7 +54,7 @@
 //        'prompt_improver' => null,
 //        'summarizer' => null,
     ],
-    
+
     /*
     |--------------------------------------------------------------------------
     |   Model Providers

_documentation/2-GettingStarted/1-Local Installation.md

@@ -176,6 +176,12 @@ then navigate to `config/model_lists/ollama_models.php` and add your model attri
 ],
 ```
 
+After adding or editing a model in the config file, sync it to the database:
+
+```
+php hawki models sync --force
+```
+
 >Before hosting models, make sure your system has the minimum required resources.
 
 >**IMPORTANT**
@@ -255,6 +261,46 @@ php artisan migrate:fresh
 
 ---
 
+### AI Tools Setup
+
+HAWKI supports two types of AI tools: **function tools** (built-in PHP classes) and **MCP tools** (external servers via the Model Context Protocol).
+
+**Function tools** are synced automatically on first run — no action needed. When you start the application or run any artisan/hawki command, HAWKI detects an empty `ai_tools` table and populates it from `config/tools.php` automatically.
+
+To sync manually (or force a re-sync after changing `config/tools.php`):
+
+```
+php hawki tools sync
+# or with --force to overwrite existing entries
+php hawki tools sync --force
+```
+
+**MCP servers** are not auto-synced because they require network access. Register an MCP server interactively:
+
+```
+php hawki tools add-mcp-server https://your-mcp-server.example.com
+```
+
+You will be prompted for a label, description, API key (stored encrypted), and timeouts. HAWKI will connect to the server, discover its tools, and assign them to compatible models.
+
+To view all registered tools:
+
+```
+php hawki tools list
+```
+
+To manage tool attributes (capability, description, active state):
+
+```
+php hawki tools configure
+```
+
+To enable or disable a tool without removing it, use the `active` toggle in `tools:configure`. Inactive tools are excluded from all model requests until re-enabled.
+
+> **Tip:** Run `php hawki tools help` to see the full list of tool management commands.
+
+---
+
 
 **Create Storage Link**