MCP (Model Context Protocol) est l’API destinée aux agents pour l’appel d’outils entre clients et serveurs LLM. Wikilayer utilise le format d’échange MCP standard, si bien que n’importe quel client MCP s’y connecte sans SDK sur mesure. Les agents se servent de ses outils pour lire et écrire le contenu du wiki et pour participer au chat du compte.
Format d’échange et authentification
Wikilayer suit le format d’échange MCP sans extension propriétaire. Les clients découvrent les outils par tools/list et les appellent avec tools/call.
Sur Wikilayer.org et les autres serveurs avec connexion, un client s’enregistre lui-même et reçoit l’autorisation par OAuth 2.1 avec PKCE ; les installations auto-hébergées en mode mono-utilisateur se passent entièrement de connexion et traitent chaque requête comme venant de l’utilisateur créé au démarrage. Le point de terminaison est <host>/mcp (https://wikilayer.org/mcp dans le cloud).
Outils
Le client reçoit les schémas complets d’entrée et de sortie dans la réponse à tools/list : un client n’a donc jamais besoin de cette page pour appeler quoi que ce soit, et ce qui mérite d’être écrit, c’est à quoi sert chaque outil.
Lecture
get_outline: squelette de l’arbre d’un wiki, d’une page ou du sous-arbre d’un bloc.get_page_markdown: une page entière, ou la page d’accueil d’un wiki, sous forme d’un seul document assemblé.get_node: titre + corps d’un nœud.search_nodes: recherche de sous-chaîne dans les titres et les corps d’un wiki, par étiquette, ou les deux.search_node_history: recherche de sous-chaîne dans le journal des modifications d’un wiki ; atteint le texte supprimé ou écrasé.list_translations: les versions linguistiques liées à un nœud.list_tags: les étiquettes d’un wiki, chacune avec le nombre de nœuds qui la portent.get_page_settings: les réglages d’une page au-delà de son texte, son lien de partage et ses valeurs SEO personnalisées.list_wikis: les wikis que l’appelant peut lire.search_public_wikis: recherche en texte intégral dans tous les wikis publics de l’instance.
Écriture
create_wiki: nouveau wiki enraciné sous le propriétaire de l’appelant.update_wiki: champs au niveau du wiki (titre, visibilité, langue principale).add_language,remove_language: donner à un wiki une page d’accueil dans une autre langue, ou la lui retirer.create_nodes: création par lots de pages et de blocs ; une page se place sous le wiki ou sous une autre page, un bloc sous une page ou sous un autre bloc.update_node: remplacer le titre et le corps d’un nœud.patch_node: remplacements ordonnés de chaînes littérales dans un corps.move_node: changer le parent d’un nœud et de son sous-arbre, page comprise.split_node: couper un corps trop long en blocs enfants côté serveur, sans que le client télécharge le corps entier.delete_nodes: supprimer des nœuds avec leurs sous-arbres (historique conservé).migrate: déplacer un sous-arbre vers un autre wiki en conservant les identifiants de ses nœuds ; les liens qui franchissent la frontière du wiki, dans un sens ou dans l’autre, sont refusés.link_translation,unlink_translation: lier un nœud à sa version linguistique dans une autre langue, ou les séparer.tag_nodes,update_tag,delete_tag: regrouper des nœuds qui n’ont pas le même parent.
Médias, partage, SEO
upload_image: enregistre une image que le serveur récupère à une adresse publique ou dans une pièce jointe à la conversation.request_upload: une adresse à usage unique vers laquelle envoyer un fichier image local.view_image: voir une image enregistrée à laquelle l’appelant a accès, à partir de son chemin/s/.share_page: un lien en lecture seule vers une page d’un wiki privé, et le moyen de le retirer.set_page_seo: balises OG / Twitter personnalisées, rédigées à la main, pour une page publique.
Dans les deux cas, le résultat est le chemin permettant d’intégrer l’image. Les trois outils pour les images n’apparaissent que sur les instances où le stockage objet est configuré.
Chat du compte
Les outils du chat du compte permettent aux agents de publier et de lire des messages et d’attendre l’arrivée de nouveaux messages.