fix: docs

Author: binaryk

README.md

@@ -77,15 +77,31 @@ DELETE: http://laravel.test/api/restify/dreams/1
 
 ## 🤖 AI-Powered Development with MCP
 
-Laravel Restify now includes **Model Context Protocol (MCP)** integration, enabling seamless AI agent interactions with your API resources. This powerful feature allows AI agents to understand, query, and manipulate your data through structured tool interfaces.
+Transform your existing Laravel Restify API into an **MCP-enabled powerhouse in minutes**! Laravel Restify's Model Context Protocol integration allows AI agents to interact directly with your API resources through structured tool interfaces.
 
-> **🔥 New!** MCP support enables AI agents to work directly with your Laravel Restify APIs, providing intelligent data access, automated operations, and enhanced development workflows.
+> **🔥 Transform Your API in Minutes!** Add one trait to your Repository class and register one route - that's it! Your entire API becomes AI-agent accessible with full security and authorization intact.
 
-**Key MCP Features:**
-- **AI Agent Integration**: Connect Claude, GPT, and other AI agents directly to your APIs
-- **Structured Tool Interfaces**: Automatically generated tools for CRUD operations  
-- **Security & Authorization**: Full Laravel authorization integration maintained
-- **Developer MCP Server**: Dedicated server for enhanced Laravel Restify development
+**Quick Setup (2 steps):**
+
+1. **Add the trait to your Repository:**
+```php
+use Binaryk\LaravelRestify\MCP\Concerns\HasMcpTools;
+
+class PostRepository extends Repository
+{
+    use HasMcpTools; // ✨ This enables MCP for this resource
+}
+```
+
+2. **Register the MCP server in `routes/ai.php`:**
+```php
+use Laravel\Mcp\Facades\Mcp;
+use Binaryk\LaravelRestify\MCP\RestifyServer;
+
+Mcp::web('restify', RestifyServer::class)->middleware(['auth:sanctum']);
+```
+
+**That's it!** Your API is now AI-agent ready with automatic tool generation for CRUD operations, actions, and getters.
 
 ## MCP Server for Developers
 

docs-v2/content/en/index.md

@@ -38,19 +38,35 @@ This documentation is for the latest version of Laravel Restify. Please ensure y
 
 ## 🤖 AI-Powered Development with MCP
 
-Laravel Restify now includes **Model Context Protocol (MCP)** integration, enabling seamless AI agent interactions with your API resources. This powerful feature allows AI agents to understand, query, and manipulate your data through structured tool interfaces.
+Transform your existing Laravel Restify API into an **MCP-enabled powerhouse in minutes**! Laravel Restify's Model Context Protocol integration allows AI agents to interact directly with your API resources through structured tool interfaces.
 
 <alert type="success">
 
-**🔥 New!** MCP support enables AI agents to work directly with your Laravel Restify APIs, providing intelligent data access, automated operations, and enhanced development workflows.
+**🔥 Transform Your API in Minutes!** Add one trait to your Repository class and register one route - that's it! Your entire API becomes AI-agent accessible with full security and authorization intact.
 
 </alert>
 
-**Key MCP Features:**
-- **AI Agent Integration**: Connect Claude, GPT, and other AI agents directly to your APIs
-- **Structured Tool Interfaces**: Automatically generated tools for CRUD operations  
-- **Security & Authorization**: Full Laravel authorization integration maintained
-- **Developer MCP Server**: Dedicated server for enhanced Laravel Restify development
+**Quick Setup (2 steps):**
+
+1. **Add the trait to your Repository:**
+```php
+use Binaryk\LaravelRestify\MCP\Concerns\HasMcpTools;
+
+class PostRepository extends Repository
+{
+    use HasMcpTools; // ✨ This enables MCP for this resource
+}
+```
+
+2. **Register the MCP server in `routes/ai.php`:**
+```php
+use Laravel\Mcp\Facades\Mcp;
+use Binaryk\LaravelRestify\MCP\RestifyServer;
+
+Mcp::web('restify', RestifyServer::class)->middleware(['auth:sanctum']);
+```
+
+**That's it!** Your API is now AI-agent ready with automatic tool generation for CRUD operations, actions, and getters.
 
 [Learn more about MCP Integration →](/mcp)
 

docs-v2/content/en/mcp/mcp-docs

@@ -0,0 +1,73 @@
+---
+title: Model Context Protocol (MCP)
+menuTitle: MCP Docs CLI
+category: MCP
+position: 1
+---
+
+Laravel Restify provides seamless integration with the Model Context Protocol (MCP), allowing AI agents to interact with your REST API resources through structured tool interfaces. This enables powerful AI-driven data access and manipulation while maintaining security and control.
+
+## MCP Server for Laravel Restify Developers
+
+In addition to MCP integration within your Laravel Restify applications, we provide a dedicated **MCP server for developers** that enhances the development experience when working with Laravel Restify APIs.
+
+**Repository**: [https://github.com/BinarCode/laravel-restify-mcp](https://github.com/BinarCode/laravel-restify-mcp)
+
+### Developer MCP Server Features
+
+The Laravel Restify MCP server provides AI agents with powerful development tools:
+
+- **📚 Documentation Access**: Query Laravel Restify documentation directly from your AI agent
+- **🏗️ Repository Generation**: Create new repositories with proper structure and conventions
+- **⚡ Action Creation**: Generate custom actions for your API resources with validation and best practices
+- **🔍 Getter Development**: Build custom getters for specialized data retrieval operations
+- **💡 Code Examples**: Get contextual code examples and implementation guidance
+- **🎯 Best Practices**: Receive Laravel Restify best practices and architectural guidance
+
+### Installation & Setup
+
+#### Install the MCP Server
+
+```bash
+composer require --dev binarcode/laravel-restify-mcp
+```
+
+#### Configure AI Agents
+
+Configure your AI agent (Claude Desktop, Cursor, etc.) to use the MCP server:
+
+```json
+{
+  "mcpServers": {
+    "laravel-restify": {
+      "command": "laravel-restify-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+#### Usage Examples
+
+Once configured, your AI agent can help with:
+
+**Creating Repositories:**
+```
+AI: Create a PostRepository with title, content, and author fields
+```
+
+**Generating Actions:**
+```
+AI: Create a PublishPostAction that validates publish dates and notifies subscribers
+```
+
+**Building Getters:**
+```
+AI: Generate a PostAnalyticsGetter that returns engagement metrics for date ranges
+```
+
+**Documentation Queries:**
+```
+AI: How do I implement field validation in Laravel Restify?
+AI: Show me examples of custom repository authorization
+```