WebMCP, ferramentas no script da página
Há ainda o caso da página que já está aberta no navegador e quer oferecer, no próprio script, as ferramentas que um agente pode invocar ali. É esse o recorte do WebMCP, no índice de protocolos.
O que o documento descreve
O documento publicado em https://webmachinelearning.github.io/webmcp/ descreve a WebMCP API como uma interface JavaScript que permite ao desenvolvedor expor a funcionalidade da aplicação web como tools: funções JavaScript com descrições em linguagem natural e schemas estruturados, que podem ser invocadas por agentes, inclusive agentes do próprio navegador, e por tecnologias assistivas. O mesmo texto afirma que páginas que usam WebMCP podem ser pensadas como servidores Model Context Protocol que implementam tools no script do cliente, em vez de no backend, e que o WebMCP viabiliza fluxos colaborativos em que usuário e agente trabalham juntos na mesma interface web, reaproveitando a lógica já existente da aplicação, com contexto compartilhado e controle do usuário.
O README oficial do repositório formula o recorte de modo próximo: o WebMCP deixa o desenvolvedor expor funcionalidade como tools desenhadas para ingestão por um agente de IA, invocáveis por agentes no navegador, em iframes ou em extensões, sobre conteúdo que tradicionalmente foi pensado para interação humana.
Status e governança
O documento apresenta-se, no próprio cabeçalho, como Draft Community Group Report, com status CG-DRAFT. Na seção «Status of this document», informa que a especificação foi publicada pelo Web Machine Learning Community Group, e que não é um padrão W3C nem está na trilha de padrões do W3C. Eu deixo isso explícito, com essa atribuição, enquanto a página ainda o disser. Não há, no cabeçalho da spec publicada, um número de versão de protocolo do tipo WebMCP 1.0. O status é o desse relatório de Community Group.
Os editores listados no cabeçalho do relatório publicado são Brandon Walderman (Microsoft), Khushal Sagar (Google), Dominic Farolino (Google) e Samuel Dallstream (Microsoft). O steward institucional, segundo o próprio documento, é o Web Machine Learning Community Group, sob o W3C Community Contributor License Agreement. O repositório canônico é https://github.com/webmachinelearning/webmcp.
Como a página registra uma tool
Na spec publicada, cada Document tem document.modelContext. A interface ModelContext oferece registerTool, getTools e executeTool, além de handlers para mudanças, ativação e cancelamento da tool. O registro acontece num contexto seguro. A policy de permissões usa o recurso "tools".
O dicionário oficial ModelContextTool, na seção 4.2.1 da spec, inclui name e description como campos obrigatórios, title como rótulo para a interface, inputSchema e outputSchema como objetos JSON Schema, execute como callback obrigatório, e annotations opcionais, entre elas readOnlyHint, untrustedContentHint, consequentialHint e debugging. As regras normativas de name, no algoritmo de registerTool, rejeitam string vazia, comprimento maior que 128 e caracteres fora de ASCII alphanumeric, "_", "-" ou ".". Uma description vazia também é inválida.
O README descreve o fluxo no navegador: a página registra tools; o agente do browser as invoca; a página executa a lógica no cliente e atualiza a interface. Esse recorte contrasta, no mesmo README, com integrações de backend, como MCP ou OpenAPI, que passam ao largo da interface web do serviço. Há exploração de uma API declarativa baseada em formulário HTML; isso aparece como exploração futura, não como o mecanismo normativo atual de registro.
Um exemplo oficial
O exemplo abaixo é da documentação oficial, o README do repositório, em https://raw.githubusercontent.com/webmachinelearning/webmcp/main/README.md, na seção «Imperative Tool Registration: document.modelContext». É o registro da tool add-todo, copiado como a fonte o publica.
const controller = new AbortController();
await document.modelContext.registerTool({
name: "add-todo",
description: "Add a new item to the user's active todo list",
inputSchema: {
type: "object",
properties: {
text: { type: "string", description: "The text content of the todo item" }
},
required: ["text"]
},
async execute({ text }) {
// Reuse existing client-side application logic and update UI.
await addTodoItemToCollection(text);
return {
content: [
{
type: "text",
text: `Added todo item: "${text}" successfully.`
}
]
};
}
}, { signal: controller.signal });
// To unregister the tool later, abort the signal.
// controller.abort();
Relação com o MCP
A spec publicada, na introdução, diz que páginas com WebMCP podem ser pensadas como servidores MCP que implementam tools no script do cliente, e referencia a especificação do MCP. O README registra que o grupo considerou adotar diretamente a spec completa do MCP no navegador, sem criar uma API nativa da web, e não adotou esse caminho. Os motivos oficiais são que o MCP foi construído sobretudo para comunicação server-to-client e para processos stdio/SSE, e que nele faltam conceitos nativos da web como origins, permissões padrão do navegador, integração com o DOM e ciclo de vida no nível do tab; e que acoplar uma API web diretamente a um protocolo de backend em evolução prejudicaria compatibilidade para trás e estabilidade da plataforma. Em vez disso, segundo o mesmo README, o WebMCP deriva inspiração direta e compartilha um vocabulário comum com o MCP, por exemplo tools, schemas e parameters, numa solução desenhada de forma nativa para a plataforma web.
Enquanto o documento do Community Group mantiver esse status, eu o trato como rascunho daquele grupo, com a API no script da página. O restante do mapa está no índice.