PHPackages                             gracjankubicki/laravel-mcp-providers - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. gracjankubicki/laravel-mcp-providers

ActiveLibrary[API Development](/categories/api)

gracjankubicki/laravel-mcp-providers
====================================

External MCP providers integration for Laravel AI SDK.

v0.1.4(2mo ago)011↓50%MITPHPPHP ^8.5CI passing

Since Feb 6Pushed 2mo agoCompare

[ Source](https://github.com/gracjankubicki/laravel-mcp-providers)[ Packagist](https://packagist.org/packages/gracjankubicki/laravel-mcp-providers)[ Docs](https://github.com/gracjankubicki/laravel-mcp-providers)[ RSS](/packages/gracjankubicki-laravel-mcp-providers/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (14)Versions (6)Used By (0)

MCP Providers for Laravel AI
============================

[](#mcp-providers-for-laravel-ai)

[![Laravel MCP Providers Logo](docs/assets/logo.svg)](docs/assets/logo.svg)

[![Latest Version on Packagist](https://camo.githubusercontent.com/d0c24de74242325572ff49551442f4eac5a58bbb7646e774c49f2b4a477da909/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f677261636a616e6b756269636b692f6c61726176656c2d6d63702d70726f7669646572732e7376673f6c6162656c3d7061636b6167697374)](https://packagist.org/packages/gracjankubicki/laravel-mcp-providers)[![Total Downloads](https://camo.githubusercontent.com/2c00c97ea51918b0a5a8694ee24ca5cb33633a6f93712088887bc249fe8c5f85/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f677261636a616e6b756269636b692f6c61726176656c2d6d63702d70726f7669646572732e737667)](https://packagist.org/packages/gracjankubicki/laravel-mcp-providers)[![PHP Version](https://camo.githubusercontent.com/64116ead26d2959b941ff8bad74d70b0f8bbcf8f6588dfdf5d7a8bac30388634/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f677261636a616e6b756269636b692f6c61726176656c2d6d63702d70726f7669646572732e737667)](https://packagist.org/packages/gracjankubicki/laravel-mcp-providers)[![Laravel](https://camo.githubusercontent.com/c1e36135dc90c088df32bbaae6b87db4e188b46517e65bc3b6298300f39e8b52/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d4646324432302e737667)](https://laravel.com)[![License](https://camo.githubusercontent.com/b89d953210b9bf1f2a357ce72c7739fcbdd7a6635f773831af98cf2211814e45/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f677261636a616e6b756269636b692f6c61726176656c2d6d63702d70726f7669646572732e737667)](LICENSE)[![Tests](https://camo.githubusercontent.com/0e8f33b78bb7a2a75741027f962e6b0bac135a0fec9097fb80cb64dcea806461/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f677261636a616e6b756269636b692f6c61726176656c2d6d63702d70726f7669646572732f74657374732e796d6c3f6c6162656c3d7465737473)](https://github.com/gracjankubicki/laravel-mcp-providers/actions/workflows/tests.yml)[![Coverage](https://camo.githubusercontent.com/b3545ae1bcdb4ea486f71f87b43001e82dd21933bc8035d44601706c851265da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d3130302532352d627269676874677265656e2e737667)](composer.json)

`gracjankubicki/laravel-mcp-providers` integrates external MCP servers with [laravel/ai](https://github.com/laravel/ai) using a class-first tools workflow.

Why this package
----------------

[](#why-this-package)

- Connect multiple MCP servers from Laravel config.
- Discover tool metadata from MCP (`tools/list`) into local manifests.
- Generate typed Laravel AI tools from manifests.
- Select tools by `::class` (safe, explicit, refactor-friendly).
- Add per-server auth, timeout, retry, and health checks.

Requirements
------------

[](#requirements)

- PHP `^8.5`
- Laravel `^12.0`
- `laravel/ai` `^0.1.2`

Installation
------------

[](#installation)

```
composer require gracjankubicki/laravel-mcp-providers
```

Publish config:

```
php artisan vendor:publish --tag=mcp-providers-config
```

Quick Start
-----------

[](#quick-start)

1. Configure MCP servers in `config/mcp-providers.php`.
2. Discover manifests:

```
php artisan ai-mcp:discover
```

3. Generate tools:

```
php artisan ai-mcp:generate
```

4. Use generated tool classes in your agent:

```
public function tools(): iterable
{
    return [
        app(\App\Ai\Tools\Generated\Gdocs\GdocsSearchDocsTool::class),
        app(\App\Ai\Tools\Generated\N8n\N8nRunWorkflowTool::class),
    ];
}
```

Configuration
-------------

[](#configuration)

Config file: `config/mcp-providers.php`

```