Unified Laravel API Layer for Humans and AI

One Codebase. REST for Humans, MCP for AI Agents.

Laravel Restify turns your Eloquent models into both JSON:API endpoints and MCP servers -- automatically. Build once, and instantly serve APIs that work seamlessly for developers, apps, and AI agents.

🚀 The Power of One Codebase

Traditional API development requires separate implementations for different consumers. Laravel Restify changes that:

• 👥 Humans get full-featured JSON:API endpoints
• 🤖 AI Agents get structured MCP (Model Context Protocol) servers
• 🔒 Same Rules - All authentication, authorization, and policies apply to both
• 📝 One Definition - Write your repository once, serve everywhere

Key Features

• JSON:API Endpoints - Full JSON:API specification compliance
• MCP Server Generation - Automatic AI agent interfaces with tool definitions
• Unified Authorization - Laravel policies protect both human and AI access
• Search & Filtering - Powerful query capabilities for all consumers
• Authentication - Laravel Sanctum integration for secure access
• GraphQL Support - Auto-generated GraphQL schemas
• Field Validation - Consistent validation rules across all interfaces

Installation

composer require binaryk/laravel-restify

Quick Start

1. Setup the package:

php artisan restify:setup

2. Create your first repository:

php artisan restify:repository PostRepository --all

3. Enable MCP for AI agents (optional):

Add to your config/ai.php:

use Binaryk\LaravelRestify\MCP\RestifyServer;
use Laravel\Mcp\Facades\Mcp;

Mcp::web('restify', RestifyServer::class)
    ->middleware(['auth:sanctum'])
    ->name('mcp.restify');

That's it! Your API now serves both:

For Humans (JSON:API):

GET /api/restify/posts
POST /api/restify/posts
PUT /api/restify/posts/1
DELETE /api/restify/posts/1

For AI Agents (MCP):

GET /mcp/restify  # Tool definitions and capabilities

Example Repository

use Binaryk\LaravelRestify\Http\Requests\RestifyRequest;
use Binaryk\LaravelRestify\Repositories\Repository;
use Binaryk\LaravelRestify\Attributes\Model;

#[Model(Post::class)]
class PostRepository extends Repository
{
    public function fields(RestifyRequest $request): array
    {
        return [
            field('title')->rules('required', 'string', 'max:255'),
            textarea('content')->rules('required'),
            field('author')->readonly(),
            datetime('published_at')->nullable(),
        ];
    }
}

This single definition automatically provides:

• ✅ JSON:API CRUD endpoints with validation
• ✅ MCP tools for AI agents with the same validation
• ✅ Authorization policies applied to both interfaces
• ✅ Search and filtering capabilities for all consumers

One Codebase, Two Outputs

Here's what you get from one repository definition:

For Humans (JSON:API Response)

GET /api/restify/posts

{
  "data": [
    {
      "id": "1",
      "type": "posts",
      "attributes": {
        "title": "Laravel Restify Guide",
        "content": "Build APIs fast...",
        "published_at": "2024-01-15"
      }
    }
  ],
  "links": {
    "self": "/api/restify/posts",
    "next": "/api/restify/posts?page=2"
  }
}

For AI Agents (MCP Tool Definition)

GET /mcp/restify  # Tool definitions for AI agents