registerWebMcpTools
Function: registerWebMcpTools()
registerWebMcpTools(
port,context,options?):Promise<WebMcpRegistration>
Defined in: src/serve/webmcp.ts:44
Register a fixed serving port with an explicitly supplied browser WebMCP context.
Pass the context your browser exposes, rather than relying on a global here: Lightpanda uses navigator.modelContext; the October 2026 draft uses document.modelContext. Both synchronous and asynchronous registration work.
Execution delegates directly to the supplied port. Its guards, principals, confirmations and settlement policy remain authoritative. A pending result remains pending: the caller uses the same did_it_work tool the port serves. Registration and disposal never call a browser's requestUserInteraction.
Tools become callable only after every registration succeeds. Failure aborts this registration group, without unregistering another owner's tools. A host must honor the registration signal to remove its listings; even if it retains an old callback, that callback cannot dispatch after disposal.
Parameters
port
context
options?
WebMcpOptions = {}
Returns
Promise<WebMcpRegistration>