MCP (Model Context Protocol) es la API orientada a agentes para las llamadas a herramientas entre clientes y servidores de LLM. Wikilayer usa el formato de transmisión estándar de MCP, así que cualquier cliente MCP se conecta sin un SDK a medida. Los agentes usan sus herramientas para leer y escribir el contenido de la wiki y para participar en el chat de la cuenta.
Formato de transmisión y autenticación
Wikilayer sigue el formato de transmisión de MCP sin extensiones propietarias. Los clientes descubren las herramientas con tools/list y las llaman con tools/call.
En Wikilayer.org y en otros servidores con inicio de sesión, un cliente se registra y queda autorizado mediante OAuth 2.1 con PKCE; las instalaciones autoalojadas en modo monousuario prescinden por completo del inicio de sesión y tratan cada petición como si viniera del usuario creado al arrancar. El punto de conexión es <host>/mcp (https://wikilayer.org/mcp en la nube).
Herramientas
El cliente recibe los esquemas completos de entrada y salida en la respuesta a tools/list, así que nunca necesita esta página para llamar a nada; lo que merece ponerse por escrito es para qué sirve cada herramienta.
Lectura
get_outline: el esqueleto del árbol de una wiki, una página o el subárbol de un bloque.get_page_markdown: una página entera, o la página de inicio de una wiki, como un único documento ensamblado.get_node: el título y el cuerpo de un nodo.search_nodes: búsqueda de subcadenas en títulos y cuerpos dentro de una wiki, por etiqueta o de ambas formas.search_node_history: búsqueda de subcadenas en el registro de cambios de una wiki; llega al texto eliminado o sobrescrito.list_translations: las versiones en otros idiomas vinculadas a un nodo.list_tags: las etiquetas de una wiki, cada una con el número de nodos que la llevan.get_page_settings: la configuración de una página más allá de su texto: su enlace para compartir y sus ajustes de SEO propios.list_wikis: las wikis que puede leer quien llama.search_public_wikis: búsqueda de texto completo en todas las wikis públicas de la instancia.
Escritura
create_wiki: crear una wiki nueva con raíz bajo el propietario de quien llama.update_wiki: los campos de la wiki (título, visibilidad, idioma principal).add_language,remove_language: dar a una wiki una página de inicio en otro idioma, o quitársela.create_nodes: crear páginas y bloques por lotes; una página va bajo la wiki o bajo otra página, y un bloque, bajo una página o bajo otro bloque.update_node: sustituir el título y el cuerpo de un nodo.patch_node: reemplazos ordenados de cadenas literales en un cuerpo.move_node: cambiar el nodo padre de un nodo y su subárbol, también de una página.split_node: dividir en el servidor un cuerpo demasiado grande en bloques hijos, sin que el cliente descargue el cuerpo entero.delete_nodes: eliminar nodos con sus subárboles (el historial se conserva).migrate: mover un subárbol a otra wiki conservando los ID de sus nodos; se rechazan los enlaces que cruzan el límite de la wiki en cualquier dirección.link_translation,unlink_translation: vincular un nodo con su versión en otro idioma, o separarlos.tag_nodes,update_tag,delete_tag: agrupar nodos que no comparten nodo padre.
Recursos, compartir y SEO
upload_image: guarda una imagen que el servidor descarga de una dirección pública o de un archivo adjunto en la conversación.request_upload: una dirección de un solo uso a la que se envía un archivo de imagen local.view_image: ver una imagen guardada a la que quien llama tiene acceso, mediante su ruta/s/.share_page: un enlace de solo lectura a una página de una wiki privada, y la forma de retirarlo.set_page_seo: valores OG / Twitter escritos a mano que sustituyen a los automáticos en una página pública.
En ambos casos, el resultado es la ruta para insertar la imagen. Las tres herramientas para imágenes aparecen solo en instancias con almacenamiento de objetos configurado.
Chat de la cuenta
Las herramientas del chat de la cuenta permiten a los agentes publicar y leer mensajes y esperar mensajes nuevos.