Skip to main content
Glama

RideMyPark

Événements RideMyPark

ridemypark_list_events
Read-onlyIdempotent

Liste les événements publics du catalogue RideMyPark : contests, jams, démos, inaugurations de park. Un événement est une fiche publique du site, au même titre qu'un spot, avec sa page sur ridemypark.com/events/.

Sert à répondre à « il y a un contest bientôt près de Lyon ? » ou « quels événements sont annoncés en Bretagne ce printemps ? ».

Paramètres :

  • near (string, 3 à 120 caractères) : lieu autour duquel chercher, géocodé automatiquement. Sinon latitude + longitude.

  • latitude (number -90 à 90), longitude (number -180 à 180) : point de recherche, à défaut de near.

  • radius_km (number, défaut 25, maximum 200) : rayon autour du point de recherche. Sans point de recherche, aucun filtre géographique n'est appliqué.

  • country, region, city (string) : slugs de zone, tels que rendus par ridemypark_browse_geography.

  • query (string, 2 à 120 caractères) : mot-clé dans le titre, la description et l'adresse.

  • from (string AAAA-MM-JJ) : ne garde que les événements dont une date tombe à partir de ce jour.

  • to (string AAAA-MM-JJ) : borne haute de la même fenêtre.

  • limit (number 1-50, défaut 10), page (number 1-20, défaut 1) : pagination, la page 1 étant la première.

  • response_format ('markdown' | 'json') : défaut markdown.

Rend pour chaque événement : identifiant, titre, slug, date annoncée au format ISO, adresse, photo, état de la fiche, et le lien de la page publique. Plus : la page, le point de recherche et le rayon quand ils s'appliquent, has_more, et total_matched quand aucune fiche n'a été écartée. Le slug se repasse à ridemypark_get_event pour la fiche complète.

Limites connues des données :

  • le catalogue d'événements est BEAUCOUP plus petit que celui des spots — quelques dizaines de fiches actives, souvent concentrées sur la France. Une réponse vide est un résultat courant, pas une panne ;

  • la date rendue est la prochaine occurrence à venir ou, à défaut, la dernière passée : une fiche d'événement récurrent porte plusieurs dates, et seule la fiche complète les liste toutes ;

  • un événement dont l'organisateur n'a jamais saisi de date n'a pas de date du tout, et la fenêtre from / to ne peut alors pas le retenir ;

  • les événements de la page rendue sont classés du plus proche dans le temps au plus lointain ; ceux sans date ferment la marche. Ce classement porte sur la page, pas sur le catalogue entier ;

  • les sorties entre riders (« Ça ride ») ne sont PAS des événements et n'apparaissent jamais ici : elles se consultent avec ridemypark_list_my_sessions après connexion avec account:read.

Erreurs :

  • Rien trouvé pour un lieu non géocodable : réessayer avec un nom de ville simple.

  • Aucun résultat : élargir la fenêtre de dates, augmenter radius_km, ou retirer un filtre de zone.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "ridemypark_list_events"
  }
}

Input Schema

NameRequiredDescriptionDefault
toNoFin de la fenêtre, au format AAAA-MM-JJ. Omis = pas de borne haute.
cityNoSlug de la ville, tel que rendu par ridemypark_browse_geography.
fromNoDébut de la fenêtre, au format AAAA-MM-JJ. Omis = pas de borne basse.
nearNoNom du lieu autour duquel chercher (« Lyon », « Bordeaux »), géocodé automatiquement.
pageNoNuméro de page, à partir de 1 (maximum 20).
limitNoNombre d'événements rendus (défaut 10, maximum 50).
queryNoMot-clé cherché dans le titre, la description et l'adresse de l'événement.
regionNoSlug de la région, tel que rendu par ridemypark_browse_geography.
countryNoSlug du pays, tel que rendu par ridemypark_browse_geography.
latitudeNoLatitude du point de recherche, à utiliser avec longitude.
longitudeNoLongitude du point de recherche, à utiliser avec latitude.
radius_kmNoRayon autour du point de recherche, en km (défaut 25, maximum 200). Sans point de recherche, ce rayon ne s'applique pas.
response_formatNomarkdown pour une réponse lisible, json pour les données brutes.markdown

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare the safe-read profile; the description goes far beyond by disclosing that the event catalog is tiny and empty results are normal, that the returned date is the next upcoming or last past occurrence, that undated events cannot be caught by from/to, and that sorting applies per page rather than across the catalog. Error guidance (ungéocodable place, zero results) adds operational context the annotations cannot carry.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Clearly front-loaded: purpose, then use cases, then parameters, then return shape, then data caveats and errors, with consistent bullets. It is long for a description, but the length is largely earned by 13 parameters and real data limitations; a few parameter lines duplicate the schema verbatim and could be cut.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 13-parameter, no-output-schema listing tool, it covers everything an agent needs: return fields, pagination metadata (has_more, total_matched with its caveat), how to fetch details, the ranking order, and the data-quality traps that would otherwise cause a wrong "nothing found, tool is broken" conclusion.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already explains every parameter and the baseline is 3. The description does add two genuinely non-obvious semantics – that near is auto-geocoded and substitutes for latitude/longitude, and that radius_km is silently ignored when no search point is supplied – but most parameter text restates defaults and bounds already in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource ("Liste les événements publics du catalogue RideMyPark") and immediately scopes what an event is: a public page like a spot, with its own URL. It explicitly distinguishes events from rider sessions ("Ça ride"), so an agent can separate this tool from ridemypark_list_my_sessions without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete triggering questions ("il y a un contest bientôt près de Lyon ?"), names prerequisites for zone slugs (must come from ridemypark_browse_geography) and the follow-up (slug → ridemypark_get_event). It also states an explicit exclusion: sessions are not events and belong to another tool after an account:read login.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources