Mcp Laravel Package

What's Changed

• fix: support custom URI schemes in OAuth client registration by @alexis-riot in https://github.com/laravel/mcp/pull/181
• fix: return tool errors for auth failures by @Gujiassh in https://github.com/laravel/mcp/pull/186
• fix: authorization_servers and issuer should be the root URL, not the resource path by @pktharindu in https://github.com/laravel/mcp/pull/185

New Contributors

• @alexis-riot made their first contribution in https://github.com/laravel/mcp/pull/181
• @pktharindu made their first contribution in https://github.com/laravel/mcp/pull/185

Full Changelog: https://github.com/laravel/mcp/compare/v0.6.4...v0.6.5

• Remove redundant "When to Apply" section from skill body by @pushpak1300 in https://github.com/laravel/mcp/pull/175
• Validate OAuth registration client names by @Gujiassh in https://github.com/laravel/mcp/pull/177
• Add nested OAuth resource metadata regression coverage by @Gujiassh in https://github.com/laravel/mcp/pull/178

• Add assertStructuredContent($closure) support by @gdebrauwer in https://github.com/laravel/mcp/pull/172

• Makes imports consistent by @nunomaduro in https://github.com/laravel/mcp/pull/171

• Add missing @throws annotation to toJsonRpcResponse method by @mohammadRezaei1380 in https://github.com/laravel/mcp/pull/166
• Update boost skill description and remove core guideline by @pushpak1300 in https://github.com/laravel/mcp/pull/170

• Allow localhost redirect with dynamic ports by @dylanbr in https://github.com/laravel/mcp/pull/156
• Add Image and Audio content types with Storage integration by @pushpak1300 in https://github.com/laravel/mcp/pull/155
• Remove incorrect Response::structured docblock throw by @nathanheffley in https://github.com/laravel/mcp/pull/160
• Add Boost Guidelines & Skills by @pushpak1300 in https://github.com/laravel/mcp/pull/153
• Add facade documenter workflow and sync Mcp facade docblocks by @pushpak1300 in https://github.com/laravel/mcp/pull/161
• Add Allow header to 405 responses for unsupported HTTP methods by @pushpak1300 in https://github.com/laravel/mcp/pull/162
• Fix CI failures in facade documenter and static analysis by @pushpak1300 in https://github.com/laravel/mcp/pull/163
• Add example of registering MCP Tool in a Server by @mohammadRezaei1380 in https://github.com/laravel/mcp/pull/164

• Update stubs to use attribute syntax by @pushpak1300 in https://github.com/laravel/mcp/pull/157

• Add attribute alternatives for primitive and server configuration by @pushpak1300 in https://github.com/laravel/mcp/pull/154

• Add configurable JSON response formatting by @LAlex14 in https://github.com/laravel/mcp/pull/150
• Change JSON response formatting to compact by default by @pushpak1300 in https://github.com/laravel/mcp/pull/151
• Add SessionInitialized event by @jessarcher in https://github.com/laravel/mcp/pull/152

• Update command description formatting to match all other Laravel Commands by @matthewjohns0n in https://github.com/laravel/mcp/pull/146
• Add host and port options to MCP Inspector command by @pushpak1300 in https://github.com/laravel/mcp/pull/147
• Fix streaming generator handling under Octane by @csfh in https://github.com/laravel/mcp/pull/148

• Rename stub files with mcp- prefix and update references by @pushpak1300 in https://github.com/laravel/mcp/pull/145

• Drop Php 8.1 Support by @pushpak1300 in https://github.com/laravel/mcp/pull/141
• Add assertStructuredContent method by @gdebrauwer in https://github.com/laravel/mcp/pull/140
• Supports Laravel 13 by @crynobone in https://github.com/laravel/mcp/pull/144

• Fix JSON-RPC notification param serialization by @csfh in https://github.com/laravel/mcp/pull/136

• Implement MCP scope registration in service provider by @pushpak1300 in https://github.com/laravel/mcp/pull/131

What's Changed

• fix: correct header name to MCP-Session-Id by @batosai in https://github.com/laravel/mcp/pull/132

New Contributors

• @batosai made their first contribution in https://github.com/laravel/mcp/pull/132

Full Changelog: https://github.com/laravel/mcp/compare/v0.5.0...v0.5.1

• Add Completion Support by @pushpak1300 in https://github.com/laravel/mcp/pull/127

What's Changed

• Bump Laravel version by @florianraith in https://github.com/laravel/mcp/pull/128

New Contributors

• @florianraith made their first contribution in https://github.com/laravel/mcp/pull/128

Full Changelog: https://github.com/laravel/mcp/compare/v0.4.1...v0.4.2

What's Changed

• Add 2025-11-25 to supported protocolVersion by @pushpak1300 in https://github.com/laravel/mcp/pull/125

Full Changelog: https://github.com/laravel/mcp/compare/v0.4.0...v0.4.1

What's Changed

• Add Annotation Support on Resources by @pushpak1300 in https://github.com/laravel/mcp/pull/111
• Add structuredContent & outputSchema Support by @macbookandrew in https://github.com/laravel/mcp/pull/83
• Standardise Role case names by @pushpak1300 in https://github.com/laravel/mcp/pull/116
• Test Improvements by @crynobone in https://github.com/laravel/mcp/pull/115
• PHP 8.5 Compatibility by @pushpak1300 in https://github.com/laravel/mcp/pull/114
• Fix casing for keys in OAuthRegisterController response by @pushpak1300 in https://github.com/laravel/mcp/pull/117
• Update JsonSchema usage by @pushpak1300 in https://github.com/laravel/mcp/pull/120
• Add Support For Resource Templates by @pushpak1300 in https://github.com/laravel/mcp/pull/113
• Remove unused resource-template stub and update JsonSchema import by @pushpak1300 in https://github.com/laravel/mcp/pull/122

New Contributors

• @macbookandrew made their first contribution in https://github.com/laravel/mcp/pull/83
• @crynobone made their first contribution in https://github.com/laravel/mcp/pull/115

Breaking Change

1. Case Name Updates (https://github.com/laravel/mcp/pull/116)

Applications referencing the previous case names will need manual updates.

Required changes

• Role::ASSISTANT should be updated to Role::Assistant
• Role::USER should be updated to Role::User

Make sure your codebase reflects these changes before upgrading to avoid build or runtime errors.

2. JsonSchema Contract Change (https://github.com/laravel/mcp/pull/120)

Tool implementations that explicitly type hint Illuminate\JsonSchema\JsonSchema in their schema() or outputSchema() methods must update to use the contract interface Illuminate\Contracts\JsonSchema\JsonSchema.

Migration Guide

Before

use Illuminate\JsonSchema\JsonSchema;

public function schema(JsonSchema $schema): array
{
    //
}

After

use Illuminate\Contracts\JsonSchema\JsonSchema;

public function schema(JsonSchema $schema): array
{
    //
}

This affects only custom tool classes that override the schema methods. The update is minimal, requiring only the import change to the contract interface.

Full Changelog: https://github.com/laravel/mcp/compare/v0.3.4...v0.4.0

• Add _meta support by @pushpak1300 in https://github.com/laravel/mcp/pull/106
• Remove non-spec fields from resource content responses by @pushpak1300 in https://github.com/laravel/mcp/pull/110

• Add MCP service provider to testbench config by @zacksmash in https://github.com/laravel/mcp/pull/100
• Fix client_name rename in oauth registrar by @mikebouwmans in https://github.com/laravel/mcp/pull/104
• fix: allow multi-segment issuer paths by @isaac-bowen in https://github.com/laravel/mcp/pull/105

What's Changed

• Ensure the property field exists in tool input schemas by @pushpak1300 in https://github.com/laravel/mcp/pull/97

New Contributors

• @pushpak1300 made their first contribution in https://github.com/laravel/mcp/pull/97

Full Changelog: https://github.com/laravel/mcp/compare/v0.3.1...v0.3.2

• refactor: move to first class callable by @ashleyhindle in https://github.com/laravel/mcp/pull/94
• Cast client_id to string in JSON response by @mostafa-rz in https://github.com/laravel/mcp/pull/93
• Feature: adds security to the OAuth registration endpoint by @jsandfordhughescoop in https://github.com/laravel/mcp/pull/87

• Add assertDontSee() to TestResponse and extend test coverage by @mattwells-coex in https://github.com/laravel/mcp/pull/74
• Fix tool annotation type error when using custom Attributes by @Daanra in https://github.com/laravel/mcp/pull/75
• Add Macroable and Conditionable traits to some core classes by @mattwells-coex in https://github.com/laravel/mcp/pull/76

• feat: default the MCP inspector to 'stdio' when inspecting a local server by @ashleyhindle in https://github.com/laravel/mcp/pull/52
• Fix error message formatting in InspectorCommand by @aymanebouljam in https://github.com/laravel/mcp/pull/53
• InspectorCommand error message improvement by @szabi-bc in https://github.com/laravel/mcp/pull/55
• Uses nowdoc for LLMs by @nunomaduro in https://github.com/laravel/mcp/pull/56
• Remove .junie Detritus by @yitzwillroth in https://github.com/laravel/mcp/pull/59
• Enhance documentation consistency and Tool class annotations by @aymanebouljam in https://github.com/laravel/mcp/pull/57
• add basic sessionid support by @ashleyhindle in https://github.com/laravel/mcp/pull/58
• Fixes artisan optimize command by @nunomaduro in https://github.com/laravel/mcp/pull/66
• [0.x] Adds support for custom request classes by @nunomaduro in https://github.com/laravel/mcp/pull/63

• First official "beta" release of Laravel MCP package.

What's Changed

• add docblock to Mcp facade by @ashleyhindle in https://github.com/laravel/mcp/pull/16

Full Changelog: https://github.com/laravel/mcp/compare/v0.1.0...v0.1.1

• Initial release of Laravel MCP package.