Skip to main content
Glama

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_connexion

Dé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 :

  1. Connexion assistée par navigateur (recommandé, à lancer à la demande) : ouvrir_connexion ouvre 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.

  2. Import depuis Firefox/Epiphany : importer_session relit cookies.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

qui_suis_je

Session et compte connecté (diagnostic)

ouvrir_connexion

Connexion Shibboleth dans un Chromium piloté, session capturée et vérifiée

importer_session

Repli : import des cookies depuis Firefox/Epiphany

lister_sondages

Mes sondages, invités, répondus, à traiter

obtenir_sondage

Fiche d'un sondage : questions, propositions, réglages, lien

creer_sondage

Création (dates ou choix de texte, brouillon possible)

modifier_sondage

Mise à jour (titre, description, lieu, réglages, questions)

clore_sondage, rouvrir_sondage

Clôture (prévient les participants par courriel) et réouverture

dupliquer_sondage, supprimer_sondage

Copie en brouillon, suppression

repondre_sondage, modifier_reponse

Réponse (oui / non / peut-être) et modification

resultats_sondage

Digest prêt pour un courriel, CSV Evento ou JSON brut

lister_participants

Participants, avec courriels et noms si demandé

reponses_participant, reponses_question

Réponses détaillées

lister_calendriers, ajouter_calendrier, supprimer_calendrier

Flux ICS importés

conflits_sondage

Conflits bruts (JSON) entre propositions et calendriers

creneaux_compatibles

Créneaux du sondage libres dans les calendriers visés

creneaux_incompatibles

Créneaux en conflit, avec les événements à l'appui

ouvrir_sondage

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 pytest

Licence

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 tools
ajouter_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 SondageC
Read-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 CompatiblesB
Read-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 IncompatiblesB
Read-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 CalendriersA
Read-only

Liste les calendriers ICS importés dans la session Evento.

Inputs: no named parameters. Returns: result

lister_participantsLister ParticipantsC
Read-only

Participants d'un sondage ; avec_courriels ajoute « nom ».

Inputs: sondage_id (required), avec_courriels. Returns: result

lister_sondagesLister SondagesC
Read-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 SondageB
Read-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 JeB
Read-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 ParticipantC
Read-only

Détail des réponses d'un participant (propriétaire du sondage).

Inputs: sondage_id (required), participant_id (required). Returns: result

reponses_questionReponses QuestionC
Read-only

Toutes les réponses à une question (propriétaire), ou la sienne sinon.

Inputs: question_id (required). Returns: result

resultats_sondageResultats SondageB
Read-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 SondageA
Destructive

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

    B3/5.0

    Scored across 24 tools

    Disambiguation4/5

    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).

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables interaction with the Wisembly API to fetch and manage event data, including event details, participants, organizers, and locations.
      2
      1
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Create 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.
      5
      71 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables management of Cvent events, registrations, attendees, sessions, contacts, surveys, reports, custom objects, and webhooks via natural language through the Cvent REST API.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Calendar 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.
      65
      746 npm
      Apache 2.0