MCP Client for Laravel

Laravel-native client for Model Context Protocol (MCP) servers
Built and maintained by Redberry, a Diamond-tier official Laravel partner.

AI PoC Sprint

🚀 What is This?

This package provides a Laravel-native client for interacting with Model Context Protocol (MCP) servers — enabling your Laravel application to communicate with external tools, structured resources, and memory services in a standardized way.

It is framework-agnostic and can be used in any Laravel application. Agent frameworks like LarAgent use this package internally to enable tool use, memory management, and reasoning across distributed contexts.

Use it to:

• Connect to any MCP-compliant server over HTTP or STDIO
• Discover and call tools defined on MCP servers
• Access structured memory and contextual resources
• Extend your Laravel apps with AI-ready interfaces to external agents or toolchains

🚀 Looking to build an AI agent in Laravel? Talk to us about our 5-week PoC sprint — from idea to working prototype.

Installation

Note that while project is running with php artisan serve STDIO transporter doesn't work

You can install the package via composer:

composer require redberry/mcp-client-laravel

After installation, publish the configuration file:

php artisan vendor:publish --tag="mcp-client-config"

This will create a config/mcp-client.php file in your application.

Configuration

The published configuration file contains settings for your MCP servers. Here's an example configuration:

return [
    'servers' => [
        'github' => [
            'type' => \Redberry\MCPClient\Enums\Transporters::HTTP,
            'base_url' => 'https://api.githubcopilot.com/mcp',
            'timeout' => 30,
            'token' => env('GITHUB_API_TOKEN', null),
        ],
        'npx_mcp_server' => [
            'type' => \Redberry\MCPClient\Enums\Transporters::STDIO,
            'command' => [
                'npx',
                '-y',
                '@modelcontextprotocol/server-memory',
            ],
            'timeout' => 30,
            'cwd' => base_path(),
        ],
    ],
];

Configuration Options

HTTP Transporter

• type: Set to Redberry\MCPClient\Enums\Transporters::HTTP for HTTP connections
• base_url: The base URL of the MCP serv

... View full README on GitHub