Boost in Windsurf (Editor) with GPT-5 models: Cascade error

[jensolafkoch]

Laravel Package Version

1.2.1

Laravel Version

12.31.1

PHP Version

8.4.12

System Info

Win 11 with Herd and PHP 8.4

Description

As soon as I add Laravel Boost to my Windsurf editor mcp_config.json as in:

    "laravel-boost": {
      "command": "php",
      "args": [
        "D:\\dev\\apps\\jok-tradivi\\artisan",
        "boost:mcp",
      ],
    },

and try to use it with GPT-5 models (including GPT-5 Codex), I get at the start of a new chat (before the model even explicitly uses it) a Cascade (Windsurf's Chat module) error:

Invalid argument: Try again with MCP servers disabled. The tools provided by your MCP servers might not be compatible with the model provider: invalid_argument: an internal error occurred (error ID: 5fa128a67e9c4d1c86dba04e0d9a8c39): an internal error occurred (error ID: 5fa128a67e9c4d1c86dba04e0d9a8c39)

It does work with Claude 3.7 or 4 models, though.

I don't know if that is some problem with the MCP implementation of GPT-5 models, a Windsurf problem re the interface between GPT-5 and Casvade, or something related to Boost which only shows with GPT-5 models.

Using a Powershell port of Laravel Boost MCP Global Configuration for Multiple Projects - Complete Solution shows the same problems, here even if the MCP server definition is diasbled.

Steps To Reproduce

same as above

[erjotek]

Same problem on mac. It works after downgrade to 1.1.4

[jensolafkoch]

@erjotek Great news, I could solve it with downgrading to 1.1.* as well! So probably really a Boost bug ...

[pushpak1300]

@jensolafkoch Is it only happening in windsurf ?

[jensolafkoch]

@pushpak1300 I only use Windsurf, as stand-alone editor and as plugin in PhpStorm, so cannot say, sorry!

[erjotek]

I lost some credits :/ but now I know that the problem only affects certain tools. Once they are disabled, everything works fine. The new version of Sonnet 4.5 for windsurfing also has a problem with these tools:

boost.php:

    'mcp' => [
        'tools' => [
            'exclude' => [
                ApplicationInfo::class,
                DatabaseConnections::class,
                LastError::class,
                ListArtisanCommands::class,
                ListAvailableConfigKeys::class,
            ],
        ],

[erjotek]

Okay, the problem is the empty Tools::schema(), because it generates:

[inputSchema] => Array
        (
            [type] => object
        )

Simple fix:

Tool::toArray()

    public function toArray(): array
    {
        $annotations = $this->annotations();

        $schema = [
            'name' => $this->name(),
            'title' => $this->title(),
            'description' => $this->description(),
            'inputSchema' => JsonSchema::object(
                fn (JsonSchema $schema): array => $this->schema($schema),
            )->toArray(),
            'annotations' => $annotations === [] ? (object) [] : $annotations,
        ];

        if (!isset($schema['inputSchema']['properties'])) {
            unset($schema['inputSchema']);
        }

        return $schema;
    }

[jensolafkoch]

@pushpak1300 The tag "windows" is too narrow, it also effects MacOS. It seems to be a bug, introduced in probably v1.2, please see findings from @erjotek.

[Kenneth-Inkum]

Same problem on mac. It works after downgrade to 1.1.4

Thanks for this... You really helped. I have downgraded and it works again with any model at all. I was frustrated it was Windsurf problem not knowing it's coming from laravel:boost

[cxemnet]

Same problem on Trae:
The argument schema for mcp tool is incompatible with GPT-5-high. Please switch/fix the MCP server, or switch models.