---
title: "WebMCP tool for TYPO3"
manual: "WebMCP tool for TYPO3"
version: "0.4"
permalink: "https://docs.typo3.org/permalink/neoblack/webmcp:start@0.4"
source: "Index.rst"
start: true
rendered: "2026-10-07T22:31:54+00:00"
---

> [!WARNING]
> **Experimental.** This extension is experimental and not yet ready for
> production use. It is built on top of
> [WebMCP](https://github.com/webmachinelearning/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.

# WebMCP tool for TYPO3 {#start}

-   *Extension key:* neoblack_webmcp
-   *Package name:* neoblack/webmcp
-   *Version:* release
-   *Language:* en
-   *Author:* Frank Nägler & contributors
-   *License:*

    This document is published under the
    [Creative Commons BY 4.0](https://creativecommons.org/licenses/by/4.0/)
    license.

---

A declarative [WebMCP](https://github.com/webmachinelearning/webmcp) tool
framework for TYPO3. Define agent tools server-side as small PHP providers; the
extension collects them into a per-page manifest and a generic JavaScript
runtime registers each tool individually via
`document.modelContext.registerTool()` (with an optional, switchable
fallback to the deprecated `navigator.modelContext`). Optional, privacy-preserving first-party analytics
are included.

> [!WARNING]
> **Experimental.** Both the underlying
> [WebMCP](https://github.com/webmachinelearning/webmcp) proposal and this
> extension's API may change or break at any time. See [Introduction](https://docs.typo3.org/permalink/neoblack/webmcp:introduction@0.4) for
> details.

---

## Getting started {#getting-started}

**[✨ Introduction](https://docs.typo3.org/permalink/neoblack/webmcp:introduction@0.4)**

What WebMCP is, what this extension adds, and how everything degrades
gracefully for regular visitors.

**[🚀 Quickstart](https://docs.typo3.org/permalink/neoblack/webmcp:quickstart@0.4)**

From a fresh install to a working tool an agent can call — in three
steps, no JavaScript required.

**[⬇️ Installation](https://docs.typo3.org/permalink/neoblack/webmcp:installation@0.4)**

Composer and requirements. What the extension does — and does not — do
out of the box.

**[🛠️ Writing tools](https://docs.typo3.org/permalink/neoblack/webmcp:developer@0.4)**

The provider interface, the four behaviour primitives and the ES-module
escape hatch.

**[⚙️ Configuration](https://docs.typo3.org/permalink/neoblack/webmcp:configuration@0.4)**

Extension settings and how to wire the manifest, JSON block and runtime
into your site.

**[🧭 Architecture](https://docs.typo3.org/permalink/neoblack/webmcp:architecture@0.4)**

The two request flows — emitting tools and ingesting usage events — and
the classes behind them.

**[📊 Analytics](https://docs.typo3.org/permalink/neoblack/webmcp:analytics@0.4)**

What the first-party usage log records, how long it is kept and how the
public endpoint is protected.

**[🌐 Standards and browser support](https://docs.typo3.org/permalink/neoblack/webmcp:standards@0.4)**

Where the WebMCP specification stands, which browsers and agents
support it, and what is still open.

**[🛡️ Security considerations](https://docs.typo3.org/permalink/neoblack/webmcp:security@0.4)**

Threats named by the specification, how the extension mitigates them
and what remains your responsibility.

**[🔧 Troubleshooting](https://docs.typo3.org/permalink/neoblack/webmcp:troubleshooting@0.4)**

Why tools might not register, providers not fire, or events not land —
and how to check each.

**[⏫ Upgrading](https://docs.typo3.org/permalink/neoblack/webmcp:upgrading@0.4)**

What changes between versions and whether you need to act.