Skip to content

Beautiful Open-Source Form Builder

fix(mcp): make ChatGPT preview template discoverable

Julien Nahumbd90fe36c3b2
diff --git a/api/app/Mcp/Apps/FormDraftPreviewApp.php b/api/app/Mcp/Apps/FormDraftPreviewApp.php
index 54da48147..224dc1b69 100644
--- a/api/app/Mcp/Apps/FormDraftPreviewApp.php
+++ b/api/app/Mcp/Apps/FormDraftPreviewApp.php
@@ -14,9 +14,11 @@ use Laravel\Mcp\Server\Ui\Csp;
#[Name('form_draft_preview')]
#[Description('Interactive preview of a temporary guest OpnForm draft with an optional editor handoff.')]
-#[Uri('ui://opnform/form-draft-preview-v7')]
+#[Uri(FormDraftPreviewApp::URI)]
class FormDraftPreviewApp extends AppResource
{
+ public const URI = 'ui://opnform/form-draft-preview-v8.html';
+
public function shouldRegister(McpAvailability $availability): bool
{
return $availability->guestDraftsEnabled();
diff --git a/api/app/Mcp/Tools/PreviewFormDraftTool.php b/api/app/Mcp/Tools/PreviewFormDraftTool.php
index 4b156592b..737f1230d 100644
--- a/api/app/Mcp/Tools/PreviewFormDraftTool.php
+++ b/api/app/Mcp/Tools/PreviewFormDraftTool.php
@@ -24,6 +24,16 @@ use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
#[IsOpenWorld(false)]
class PreviewFormDraftTool extends GuestDraftMcpTool
{
+ /**
+ * @return array<string, mixed>
+ */
+ public function toArray(): array
+ {
+ $this->setMeta('openai/outputTemplate', FormDraftPreviewApp::URI);
+
+ return parent::toArray();
+ }
+
public function handle(Request $request, AgentFormDraftService $drafts): ResponseFactory
{
$validated = $request->validate([
diff --git a/api/tests/Feature/Mcp/AgentDraftEditorTest.php b/api/tests/Feature/Mcp/AgentDraftEditorTest.php
index ddbdda180..8b276a6fc 100644
--- a/api/tests/Feature/Mcp/AgentDraftEditorTest.php
+++ b/api/tests/Feature/Mcp/AgentDraftEditorTest.php
@@ -73,7 +73,7 @@ it('publishes standard and ChatGPT-compatible CSP metadata with the full fronten
->content()
->toResource($previewApp);
- expect($previewApp->uri())->toBe('ui://opnform/form-draft-preview-v7')
+ expect($previewApp->uri())->toBe('ui://opnform/form-draft-preview-v8.html')
->and($previewApp->resolvedAppMeta()['domain'])
->toBe('http://127.0.0.1:33676')
->and($previewApp->resolvedAppMeta()['csp']['resourceDomains'])
diff --git a/api/tests/Feature/Mcp/AuthenticatedFormToolsTest.php b/api/tests/Feature/Mcp/AuthenticatedFormToolsTest.php
index fb73d5153..60d430ecd 100644
--- a/api/tests/Feature/Mcp/AuthenticatedFormToolsTest.php
+++ b/api/tests/Feature/Mcp/AuthenticatedFormToolsTest.php
@@ -168,7 +168,7 @@ it('hides guest draft capabilities but keeps validation and OAuth tools on self-
expect($resourceUris)
->toContain('opnform://schemas/agent-form-definition/v1', 'opnform://reference/form-fields/v1')
- ->not->toContain('ui://opnform/form-draft-preview-v7');
+ ->not->toContain('ui://opnform/form-draft-preview-v8.html');
$this->postJson('/mcp', [
'jsonrpc' => '2.0',
diff --git a/api/tests/Feature/Mcp/GuestDraftToolsTest.php b/api/tests/Feature/Mcp/GuestDraftToolsTest.php
index 87fe68cf4..b3cda0e96 100644
--- a/api/tests/Feature/Mcp/GuestDraftToolsTest.php
+++ b/api/tests/Feature/Mcp/GuestDraftToolsTest.php
@@ -36,7 +36,8 @@ it('publishes a neutral draft handle contract and accurate preview annotations',
->and($create['outputSchema']['properties'])->not->toHaveKey('draft_token')
->and($create['_meta'])->not->toHaveKey('ui')
->and(app(PatchFormDraftTool::class)->toArray()['_meta'])->not->toHaveKey('ui')
- ->and($preview['_meta']['ui']['resourceUri'])->toBe('ui://opnform/form-draft-preview-v7')
+ ->and($preview['_meta']['ui']['resourceUri'])->toBe('ui://opnform/form-draft-preview-v8.html')
+ ->and($preview['_meta']['openai/outputTemplate'])->toBe('ui://opnform/form-draft-preview-v8.html')
->and($preview['inputSchema']['properties'])->toHaveKey('draft_handle')
->and($preview['outputSchema']['properties'])->not->toHaveKeys([
'editor_url',