Connectez Botillon à votre assistant IA
Botillon expose un serveur MCP (Model Context Protocol) : un point d’accès unique que ChatGPT, Claude, Cursor ou tout agent compatible peuvent interroger pour consulter le catalogue, les règles, l’aide et l’API — sans clé, sans inscription.
https://botillon.fr/api/mcpQu’est-ce que le MCP ?
Le Model Context Protocol est un standard ouvert qui permet à un assistant IA de se connecter à des services externes pour aller chercher des informations fiables, au lieu d’inventer une réponse. Concrètement, votre assistant découvre une liste d’outils (« chercher un bot », « lire une fiche », « comparer deux bots »…) et les appelle lui-même quand c’est utile.
Exemple concret
Vous demandez à votre IA : « trouve-moi un bot de modération en français sur Botillon ». L’assistant appelle l’outil search_bots, obtient des résultats réels (votes, serveurs, note), puis vous répond avec des fiches à jour et leurs liens — au lieu de deviner.
Gratuit, sans clé et en lecture seule
Gratuit
Public, sans abonnement.
Sans clé
Aucun compte, aucun jeton.
Lecture seule
Aucune écriture possible.
Ce que le MCP expose
33 outils, 18 ressources (+1 modèle dynamique) et 6 prompts, tous en lecture seule.
Outils (33)
| Outil | Description |
|---|---|
| search_bots | Recherche dans le catalogue public Botillon (bots approuvés). Filtre par texte, par tags, trie et pagine. Sans paramètre, renvoie les bots les plus… |
| get_bot | Renvoie la fiche publique complète d’un bot approuvé (nom, description, tags, statistiques, liens, badges, note d’évaluation). Accepte un identifiant… |
| get_bot_community | Vie communautaire publique d’un bot approuvé : propriétaires, avis récents (note et 20 derniers avec auteur), likes total / mois / 30 jours et 20… |
| top_bots | Classement des bots approuvés par votes, serveurs, likes, nouveauté ou note d’évaluation. |
| compare_bots | Compare deux bots approuvés sur les critères du comparateur Botillon : votes, serveurs, likes, note /100, avis, tags communs et fonctionnalités.… |
| get_evaluation | Note d’évaluation Botillon (/100) d’un bot : score, statut Vérifié/Certifié, critères notés, points négatifs et badges d’évaluation. |
| list_similar_bots | Bots proches d’un bot donné (tags partagés, puis popularité). Sert à proposer des alternatives. |
| list_evaluated_bots | Derniers bots ayant une évaluation approuvée, avec leur note /100 et le badge Certifié. |
| list_tags | Liste les tags officiels Botillon avec le nombre de bots approuvés pour chacun. Ce sont les seuls filtres acceptés par le catalogue. |
| list_categories | Botillon n’utilise pas de catégories distinctes : la taxonomie publique est celle des tags. Cet outil renvoie les tags les plus fournis, utilisables… |
| classify_text | Classe un texte en LECTURE SEULE via le routeur local Sabaki (offline, sans LLM, sans quota) et renvoie un signal typé avec une confiance dans [0,1].… |
| list_badges | Badges publics de Botillon (partenaires, vérification Discord, soutiens, événements) et leur signification. |
| list_rules | Critères de listing des bots Botillon (contenus interdits, prérequis techniques, spécificités, conséquences). Utile pour vérifier qu’un bot est… |
| site_stats | Chiffres publics de Botillon : nombre de bots, votes, utilisateurs, serveurs couverts, bots évalués et top tags. |
| list_api_endpoints | Liste les endpoints publics de l’API Botillon documentés sur /api-docs : méthode, chemin, description, paramètres et exemple de réponse. Distingue… |
| list_help_topics | Table des matières de l’aide publique de Botillon : présentation, pourquoi Botillon, règles de la communauté, critères de listing, ajouter un bot,… |
| get_help_topic | Contenu complet et public d’un sujet d’aide (règles, guides, bonnes pratiques). Le slug provient de list_help_topics. |
| get_site_presentation | Que fait Botillon, à qui ça s’adresse, engagements, fonctionnalités clés, comment soumettre un bot, comment voter, programme d’évaluation,… |
| get_why_botillon | Argumentaire structuré de la page /pourquoi-botillon : positionnement (bots uniquement, pas un annuaire de serveurs), comparatif des botlists,… |
| get_terms | CGU de Botillon en sections structurées (objet, licence, contenu utilisateur, votes, sanctions, responsabilité) + URL publique. |
| get_privacy | Politique de confidentialité de Botillon : données collectées, finalités et bases légales, cookies, destinataires, durées de conservation, droits… |
| get_legal_notice | Mentions légales de Botillon : éditeur, hébergement, objet du site, propriété intellectuelle, responsabilité, droit applicable. |
| get_discord_bot | Documentation publique du bot Discord Botillon : commandes (/vote, /commentaire, /like, /bump, /config), configuration serveur, récompenses de rôle,… |
| get_page_markdown | Renvoie n’importe quelle page publique du site au format Markdown (frontmatter + contenu), à partir de son chemin. Refuse les espaces privés (/api,… |
| list_pages | Découverte : liste des pages publiques importantes (chemin, URL, description) et, quand elle existe, leur URL Markdown (.md). |
| list_partners | Services et serveurs partenaires officiels de Botillon (nom, accroche, description, lien). |
| list_recommended_bots | Bots mis en avant sur le site : carrousel d’accueil en trois zones égales (tirage au sort équitable, Croissants gagnés, têtes d’affiche), plus… |
| list_integrations | Intégrations publiques approuvées par Botillon (services connectables en webhooks signés HMAC) et scopes d’événements supportés. |
| list_bot_posts | Articles publics d’un bot, du plus récent au plus ancien : articles natifs publiés sur Botillon ET items de son flux externe (RSS/Atom synchronisé).… |
| list_blog_posts | Flux public du hub /blog : articles natifs des bots, items de leurs flux externes ET actualités éditoriales du site. Le champ « type » vaut « bot »,… |
| list_news | Actualités publiées de Botillon (annonces, nouveautés, guides) : titre, slug, extrait, date, tags, auteur et URL /news/<slug>. Recherche texte… |
| search_news | Recherche plein texte dans les actualités publiées de Botillon (titre, extrait, contenu). Alias de list_news avec une requête. |
| get_news | Contenu complet (texte/Markdown) d’une actualité publiée, par son slug : extrait, tags, auteur, dates, pièces jointes et URL /news/<slug>. |
Ressources (19)
botillon://llms.txt— Description textuelle de Botillon à destination des agents IA (llms.txt).botillon://regles/bots— Règles à respecter pour être référencé sur Botillon (version JSON structurée).botillon://badges— Liste JSON des badges publics de Botillon.botillon://tags— Tags officiels et nombre de bots approuvés par tag.botillon://stats— Chiffres publics de Botillon (bots, votes, serveurs, top tags).botillon://croissants— Monnaie communautaire « Croissants » (gain par votes et entraide, plafonds,…botillon://api-docs— Endpoints publics de l’API Botillon (méthode, chemin, description, paramètres, exemple de…botillon://aide— Sujets d’aide publics de Botillon (règles, guides, bonnes pratiques) — hors contenu staff.botillon://presentation— Que fait Botillon, pour qui, fonctionnalités, soumission, vote, évaluation.botillon://pourquoi-botillon— Argumentaire et comparatif des botlists, fonctionnalités incluses et FAQ.botillon://legal/cgu— CGU de Botillon en sections structurées.botillon://legal/confidentialite— Politique de confidentialité de Botillon en sections structurées.botillon://legal/mentions-legales— Mentions légales de Botillon en sections structurées.botillon://bot-discord— Commandes, configuration serveur, récompenses de rôle, rappels de vote et prérequis.botillon://pages— Liste des pages publiques importantes avec URL et URL Markdown.botillon://partenaires— Services et serveurs partenaires officiels de Botillon.botillon://news— Liste des actualités publiées de l’équipe (titre, slug, extrait, date, tags, auteur, URL).botillon://blog— Derniers articles publics du hub /blog : articles de bots, flux externes et actualités du…botillon://news/{slug}— Contenu complet d’une actualité publiée, par son slug (brouillons et articles masqués…
Prompts (6)
trouver_un_bot— Prépare une recherche de bot adaptée à un besoin donné.comparer_deux_bots— Prépare une comparaison argumentée de deux bots Botillon.presenter_botillon— Prépare une présentation claire de Botillon pour un public donné.ajouter_mon_bot— Guide pas à pas pour soumettre un bot sur Botillon.resumer_une_page— Prépare le résumé ou la citation d’une page publique de Botillon.installer_bot_discord— Guide pour inviter et configurer le bot Discord Botillon dans un serveur.
Comment se connecter
Cursor / Claude Code / client Streamable HTTP
Ajoutez le serveur distant dans votre configuration MCP :
{
"mcpServers": {
"botillon": {
"type": "streamable-http",
"url": "https://botillon.fr/api/mcp"
}
}
}Claude Desktop (via mcp-remote)
Claude Desktop ne gère pas encore le HTTP distant nativement : passez par le pont mcp-remote.
{
"mcpServers": {
"botillon": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://botillon.fr/api/mcp"]
}
}
}Tester en ligne de commande
Initialisation :
curl -s https://botillon.fr/api/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'Lister les outils :
curl -s https://botillon.fr/api/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'Le transport est conforme au Streamable HTTP MCP : les réponses sont du JSON-RPC (application/json) ; le SSE reste disponible via ?transport=sse.
Exemples de questions
- Trouve-moi un bot de modération en français sur Botillon.
- Compare Mr. Robøt et BreezyBot : lequel est le mieux noté ?
- Quels sont les 10 bots avec le plus de serveurs ?
- Quels bots sont certifiés (note ≥ 75/100) ?
- Quels sont les critères pour ajouter un bot sur Botillon ?
- Résume la politique de confidentialité de Botillon.
Questions fréquentes
Est-ce gratuit ?
Oui, totalement. Le serveur MCP de Botillon est public et gratuit, sans abonnement ni clé.
Ai-je besoin d’une clé API ?
Non. Aucune clé, aucun compte. L’API REST v1 (clé projet) est un service distinct ; le MCP se contente des données publiques.
Ça modifie quelque chose sur Botillon ?
Non. Le MCP est strictement en lecture seule : il ne peut ni voter, ni liker, ni commenter, ni modifier une fiche. Il lit uniquement des données publiques.
Quels assistants sont compatibles ?
Tous les clients qui implémentent le Model Context Protocol (Streamable HTTP) : Cursor, Claude Code, Claude Desktop (via mcp-remote), ou tout agent compatible MCP.
Y a-t-il une limite de débit ?
Oui, pour éviter les abus : environ 30 requêtes en rafale puis 60 par minute et par adresse IP. Au-delà, le serveur répond une erreur JSON-RPC avec un délai de réessai.
Développeurs
Vous cherchez l’API REST (clés projet, webhooks, statistiques) ou la documentation complète ? Tout est décrit sur la page API, et les agents IA peuvent lire llms.txt.