Warning
Experimental. This extension is experimental and not yet ready for production use. It is built on top of WebMCP, which is itself an experimental, early-stage proposal. Both the underlying specification and this extension's API may change or break at any time without notice. Use at your own risk.
Upgrading
From 0.3 to 0.4
Version 0.4 aligns the runtime with the WebMCP specification draft of 2026-10-02. Requirements are unchanged (TYPO3 14.3+, PHP 8.2+).
What changes
- Registration. The runtime no longer calls
provide, which the specification removed. Each tool is registered individually withContext () register, so tools appear one after another instead of all at once. If one registration fails, only that tool is missing and the console shows one warning naming it.Tool () - Lifecycle. Tools are unregistered on
pagehideand registered again when the page is restored from the back/forward cache. - Iframes. Tools are no longer registered when the page is embedded in an iframe.
- Output cap. The text output of a tool call is limited to 1,500 characters by default.
- New annotation. Every manifest now also carries
annotations.(consequential Hint trueformailto).
Do I need to act?
- Tools built on the four primitives: no action required.
- Escape-hatch modules that call
providethemselves: replace the call with oneContext () registerper tool.Tool (tool, { signal }) providedoes not exist in current browsers.Context () - Tools with long text output (large
staticlists, high search limits): check whether the output exceeds 1,500 characters. Shorten it or set outputLimit (0disables the cap). - Embedded pages: if you relied on tools inside an iframe, that no longer works — agents do not discover tools in iframes anyway.
- Check your log after the first page render: the data processor now warns about tool or parameter names over 30 characters and descriptions over the recommended sizes (see Writing tools).
New, optional settings
- legacyNavigatorFallback
— set to
0to stop using the deprecatednavigator..model Context - outputLimit — the output cap.
- Manifest arguments
consequentialanddebugging(see Writing tools).