mcp-evento
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-evento liste mes sondages Evento en cours"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-evento
Serveur MCP pour Evento, le service de sondages et de planification d'événements
de RENATER (https://evento.renater.fr), construit sur le logiciel libre Moment
(AGPLv3, https://sourcesup.renater.fr/projects/moment, dépôt
https://git.renater.fr/anonscm/git/moment/moment.git).
Evento n'a pas d'API publique documentée, mais son interface web repose sur une API
REST (/rest.php) décrite dans doc/api/openapi.yml du dépôt Moment et utilisée par
les outils ci-dessous : sondages, questions, réponses, résultats, calendriers.
Installation
uv sync
uv run playwright install chromium # navigateur utilisé par ouvrir_connexionDéclaration dans un client MCP (~/.omp/agent/mcp.json, Claude Desktop…) :
{
"mcpServers": {
"evento": {
"command": "/chemin/vers/mcp-evento/.venv/bin/python",
"args": ["-m", "mcp_evento"]
}
}
}Variante sans venv : "command": "uv", "args": ["run", "--directory", "/chemin/vers/mcp-evento", "mcp-evento"].
Related MCP server: timergy
Session
L'authentification Evento passe par la fédération Shibboleth (aucun mot de passe applicatif) : elle ne peut pas être automatisée. Deux chemins, sans copie de cookie :
Connexion assistée par navigateur (recommandé, à lancer à la demande) :
ouvrir_connexionouvre un Chromium piloté sur la page Shibboleth, attend que la session soit valide côté API, puis la conserve dans~/.local/share/mcp-evento/session.json(0600). Les appels suivants la réutilisent, y compris depuis un autre processus ; aucune tentative de connexion n'est faite en arrière-plan, pour ne pas solliciter le fournisseur d'identité à répétition.Import depuis Firefox/Epiphany :
importer_sessionrelitcookies.sqlite.
Evento s'appuie sur la session Shibboleth (_shibsession_…) : un cookie PHPSESSID
seul ne suffit pas, et la session expire côté fournisseur d'identité — il faut alors
relancer ouvrir_connexion.
3. Cookie explicite : EVENTO_COOKIE="PHPSESSID=…; _shibsession_…=…" (les deux
cookies). EVENTO_SECURITY_TOKEN est optionnel : le jeton CSRF (X-Security-Token)
est lu dans le HTML de /home et renouvelé sur erreur.
Variables : EVENTO_COOKIE, EVENTO_BASE_URL (défaut https://evento.renater.fr),
EVENTO_SECURITY_TOKEN, EVENTO_BROWSER_PROFILE (profil Chromium), EVENTO_BROWSER_CMD
(ouverture de lien simple). Voir .env.example.
Outils
Outil | Rôle |
| Session et compte connecté (diagnostic) |
| Connexion Shibboleth dans un Chromium piloté, session capturée et vérifiée |
| Repli : import des cookies depuis Firefox/Epiphany |
| Mes sondages, invités, répondus, à traiter |
| Fiche d'un sondage : questions, propositions, réglages, lien |
| Création (dates ou choix de texte, brouillon possible) |
| Mise à jour (titre, description, lieu, réglages, questions) |
| Clôture (prévient les participants par courriel) et réouverture |
| Copie en brouillon, suppression |
| Réponse (oui / non / peut-être) et modification |
| Digest prêt pour un courriel, CSV Evento ou JSON brut |
| Participants, avec courriels et noms si demandé |
| Réponses détaillées |
| Flux ICS importés |
| Conflits bruts (JSON) entre propositions et calendriers |
| Créneaux du sondage libres dans les calendriers visés |
| Créneaux en conflit, avec les événements à l'appui |
| Ouvre le lien public d'un sondage dans le navigateur |
Aucun outil n'envoie d'invitation : la liste des invités n'est ni lue ni modifiée.
Attribution
Le code a été écrit avec l'aide d'un assistant LLM (DeepSeek V4.1 Flash servi par
vLLM), relu et vérifié contre l'API réelle par l'auteur. Les contributions
assistées doivent être signalées (voir CONTRIBUTING.md).
Développement
pre-commit install # ruff (lint + format) et gitleaks à chaque commit
uv run ruff check --fix .
uv run ruff format .
uv run pytestLicence
MIT (voir LICENSE.md). Ce serveur est un client de l'API d'Evento ; le logiciel
Evento/Moment est publié sous AGPLv3 par RENATER, indépendamment de ce dépôt.
Available Tools
24 toolsajouter_calendrierAjouter CalendrierB
Importe un calendrier ICS (URL iCal, souvent un flux secret).
nom : libellé du calendrier ; url : adresse du flux ICS ; couleur : couleur d'affichage au format #rrggbb.
Inputs: nom (required), url (required), couleur. Returns: result
clore_sondageClore SondageB
Clôt un sondage (Evento prévient participants et invités par courriel).
Inputs: sondage_id (required). Returns: result
conflits_sondageConflits SondageCRead-only
Conflits entre les propositions d'un sondage et les calendriers importés.
Inputs: sondage_id (required). Returns: result
creer_sondageCreer SondageB
Crée un sondage (aucune invitation envoyée).
options : réglages, ex. {"reply_access": "opened_to_everyone", "enable_anonymous_answer": 1, "hide_answers": 0}. brouillon=True : visible de moi seul. fermeture_auto : « 2026-12-01 » (sinon +1 mois côté serveur).
Inputs: titre (required), questions (required), lieu, options, +4 more. Returns: result
creneaux_compatiblesCreneaux CompatiblesBRead-only
Créneaux du sondage sans conflit dans les calendriers importés.
calendriers : noms ou identifiants à considérer (tous par défaut, y compris « @MyCal », l'agenda interne d'Evento).
Inputs: sondage_id (required), calendriers. Returns: result
creneaux_incompatiblesCreneaux IncompatiblesBRead-only
Créneaux en conflit avec les calendriers importés, événements à l'appui.
calendriers : noms ou identifiants à considérer (tous par défaut, y compris « @MyCal », l'agenda interne d'Evento).
Inputs: sondage_id (required), calendriers. Returns: result
dupliquer_sondageDupliquer SondageB
Duplique un sondage en un nouveau brouillon (dont on est propriétaire).
Inputs: sondage_id (required). Returns: result
importer_sessionImporter SessionB
Repli : importe la session depuis Firefox ou Epiphany, puis la vérifie.
Inputs: no named parameters. Returns: result
lister_calendriersLister CalendriersARead-only
Liste les calendriers ICS importés dans la session Evento.
Inputs: no named parameters. Returns: result
lister_participantsLister ParticipantsCRead-only
Participants d'un sondage ; avec_courriels ajoute « nom ».
Inputs: sondage_id (required), avec_courriels. Returns: result
lister_sondagesLister SondagesCRead-only
Liste mes sondages, ceux où je suis invité, répondus ou à traiter.
Inputs: limite, categorie, inclure_brouillons. Returns: result
modifier_reponseModifier ReponseC
Modifie des réponses déjà envoyées (jeton de participant ou courriel).
Inputs: reponses (required), sondage_id (required), courriel, jeton_participant. Returns: result
modifier_sondageModifier SondageC
Met à jour un sondage : seuls les champs fournis changent.
questions remplace la liste complète ; un sondage ouvert ne peut pas redevenir un brouillon.
Inputs: sondage_id (required), lieu, titre, options, +3 more. Returns: result
obtenir_sondageObtenir SondageBRead-only
Détail d'un sondage : état, réglages, questions et propositions.
Inputs: sondage_id (required). Returns: result
ouvrir_connexionOuvrir ConnexionB
Ouvre un Chromium sur la connexion Shibboleth et capture la session.
La fenêtre se ferme une fois connecté ; la session capturée est réutilisée par les appels suivants. delai : attente maximale en secondes.
Inputs: delai. Returns: result
ouvrir_sondageOuvrir SondageB
Ouvre un sondage dans le navigateur (réponse manuelle, partage).
Inputs: sondage_id (required). Returns: result
qui_suis_jeQui Suis JeBRead-only
Session utilisée et compte connecté (diagnostic).
Inputs: no named parameters. Returns: result
repondre_sondageRepondre SondageC
Répond à un sondage (nom/courriel pour un participant non connecté).
Inputs: reponses (required), sondage_id (required), nom, courriel, +1 more. Returns: result
reponses_participantReponses ParticipantCRead-only
Détail des réponses d'un participant (propriétaire du sondage).
Inputs: sondage_id (required), participant_id (required). Returns: result
reponses_questionReponses QuestionCRead-only
Toutes les réponses à une question (propriétaire), ou la sienne sinon.
Inputs: question_id (required). Returns: result
resultats_sondageResultats SondageBRead-only
Résultats d'un sondage : digest pour courriel, CSV Evento ou JSON brut.
Inputs: sondage_id (required), format. Returns: result
rouvrir_sondageRouvrir SondageA
Rouvre un sondage clos ; nouvelle_cloture (« 2026-12-01 ») sinon +1 mois.
Inputs: sondage_id (required), nouvelle_cloture. Returns: result
supprimer_calendrierSupprimer CalendrierB
Retire un calendrier importé (identifiant fourni par lister_calendriers).
Inputs: calendrier_id (required). Returns: result
supprimer_sondageSupprimer SondageADestructive
Supprime définitivement un sondage dont on est propriétaire.
Inputs: sondage_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Most tools target distinct resources and actions (lister/obtenir/creer/modifier/clore/supprimer_sondage, response and calendar tools are clearly separated). The main confusion is the trio conflits_sondage, creneaux_incompatibles and creneaux_compatibles, which all compute survey-vs-calendar overlap and differ only in output framing; obtenir_sondage vs ouvrir_sondage is also a subtle distinction (data vs browser window).
Names are consistently snake_case French with a predictable verb_noun pattern for the action tools (lister_, obtenir_, creer_, modifier_, supprimer_, ajouter_, repondre_). A handful of noun-first names (resultats_sondage, reponses_participant, reponses_question, conflits_sondage, creneaux_compatibles) break the verb-first convention but remain readable and unambiguous.
24 tools is heavy for the apparent scope; the survey CRUD, response, participant and calendar groups each earn their place, but the three conflict/compatibility tools overlap enough that one or two could be folded in, and clore/rouvrir could arguably be state changes on modifier_sondage.
Survey lifecycle (create, read, list, update, close, reopen, duplicate, delete) and response reading are well covered, with calendars and conflict detection adding real value. However, invitation/participant management is missing (creer_sondage explicitly sends no invitations, and there is no tool to invite or add participants), and there is no way to delete or retract a submitted response.
Maintenance
Related MCP Connectors
Create and query group meeting availability polls, time-zone slots, and scheduling links.
Create, update and analyze PollUnit polls, scheduling polls, surveys and contests.
Agent-first meeting schedule polls for humans and agents. Create polls, vote, find times.
Read AddEvent calendars, events, RSVPs and subscribers; create and update calendars and events.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with the Wisembly API to fetch and manage event data, including event details, participants, organizers, and locations.21ISC
- AlicenseAqualityDmaintenanceCreate scheduling polls (like Doodle) from AI agents. Find the best time for meetings, dinners, and events. 5 tools: create_poll, get_poll, vote_on_poll, get_results, finalize_poll. No authentication required.571 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables management of Cvent events, registrations, attendees, sessions, contacts, surveys, reports, custom objects, and webhooks via natural language through the Cvent REST API.MIT
- AlicenseAqualityBmaintenanceCalendar API purpose-built for AI agents. Exposes tools to manage agents, calendars, and events, find meeting times, run scheduling proposals, set availability rules, manage webhooks, and subscribe to iCal feeds.65746 npmApache 2.0