O MCP (Model Context Protocol) é a API voltada para agentes que serve para chamar ferramentas entre clientes e servidores de LLM. O Wikilayer usa o formato de transmissão padrão do MCP, por isso qualquer cliente MCP se conecta sem um SDK sob medida. Os agentes usam as ferramentas dele para ler e escrever o conteúdo da wiki e para participar do chat da conta.
Formato de transmissão e autenticação
O Wikilayer segue o formato de transmissão do MCP sem extensões proprietárias. Os clientes descobrem as ferramentas por tools/list e as chamam com tools/call.
No Wikilayer.org e em outros servidores com login, o cliente se registra e é autorizado por OAuth 2.1 com PKCE; as instalações próprias em modo de usuário único dispensam o login por completo e tratam todo pedido como vindo do usuário criado na inicialização. O endpoint é <host>/mcp (https://wikilayer.org/mcp na nuvem).
Ferramentas
O cliente recebe os esquemas completos de entrada e saída na resposta a tools/list, por isso nunca precisa desta página para chamar nada; o que vale registrar aqui é para que serve cada ferramenta.
Leitura
get_outline: esqueleto da árvore de uma wiki, de uma página ou da subárvore de um bloco.get_page_markdown: uma página inteira, ou a página inicial de uma wiki, como um único documento montado.get_node: título + corpo de um nó.search_nodes: busca por trecho de texto nos títulos e corpos de uma wiki, por tag ou pelos dois.search_node_history: busca por trecho de texto no registro de alterações de uma wiki; alcança texto excluído ou sobrescrito.list_translations: as versões em outro idioma vinculadas a um nó.list_tags: as tags de uma wiki, cada uma com o número de nós que a levam.get_page_settings: as configurações de uma página além do texto, o link de compartilhamento dela e as substituições de SEO.list_wikis: as wikis que quem faz a chamada pode ler.search_public_wikis: busca de texto completo em todas as wikis públicas da instância.
Escrita
create_wiki: wiki nova, criada sob o proprietário de quem faz a chamada.update_wiki: campos da wiki (título, visibilidade, idioma principal).add_language,remove_language: dar a uma wiki uma página inicial em outro idioma, ou retirá-la.create_nodes: criar páginas e blocos em lote; a página fica sob a wiki ou sob outra página, o bloco sob uma página ou outro bloco.update_node: substituir o título e o corpo de um nó.patch_node: substituições ordenadas de texto literal num corpo.move_node: mudar o nó pai de um nó e da subárvore dele, inclusive de uma página.split_node: dividir no servidor um corpo grande demais em blocos filhos, sem o cliente baixar o corpo inteiro.delete_nodes: remover nós com as subárvores (o histórico é preservado).migrate: mover uma subárvore para outra wiki mantendo os IDs dos nós; links que atravessam o limite da wiki, em qualquer direção, são recusados.link_translation,unlink_translation: vincular um nó à versão dele em outro idioma, ou separá-los.tag_nodes,update_tag,delete_tag: agrupar nós que não têm o mesmo nó pai.
Mídia, compartilhamento e SEO
upload_image: armazena uma imagem que o servidor busca em um endereço público ou em um arquivo anexado à conversa.request_upload: um endereço de uso único para enviar um arquivo de imagem local.view_image: ver uma imagem armazenada à qual quem faz a chamada tem acesso, pelo seu caminho/s/.share_page: um link somente leitura para uma página de uma wiki privada, e a forma de revogá-lo.set_page_seo: substituições de OG / Twitter escritas à mão para uma página pública.
Nos dois casos, o resultado é o caminho para incorporar a imagem. As três ferramentas para imagens aparecem apenas em instâncias com armazenamento de objetos configurado.
Chat da conta
As ferramentas do chat da conta permitem aos agentes publicar e ler mensagens e aguardar novas mensagens.