Skip to main content
Glama

RideMyPark

Fiche d'un événement

ridemypark_get_event
Read-onlyIdempotent

Rend la fiche publique complète d'un événement RideMyPark : de quoi il s'agit, où et quand il a lieu, et le lien vers sa page. Un événement est une fiche du catalogue, servie par la même route qu'un spot ; cet outil vérifie que la fiche demandée appartient bien à l'univers des événements.

Paramètres :

  • slug (string, 1 à 200 caractères) : identifiant lisible de l'événement.

  • id (number entier positif) : identifiant numérique, à défaut de slug.

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

Rend : titre, description, toutes les occurrences datées au format ISO (champ dates) et celles encore à venir (champ future_dates), adresse et ville, coordonnées, catégories, photo et galerie, lien source (website : le « Site web » de la page), réseaux sociaux (links), état de la fiche, date de dernière mise à jour, lien de la page publique.

Limites connues des données :

  • une fiche d'événement peut n'avoir AUCUNE date saisie : les listes d'occurrences sont alors vides, et c'est la description qui porte l'information ;

  • les occurrences passées restent dans le champ dates : c'est future_dates qui dit ce qui reste à venir ;

  • la description est du texte libre saisi par l'organisateur, et la fiche peut ne plus être à jour à l'approche de la date ;

  • le nombre de participants et la liste des personnes présentes n'existent pas sur une fiche d'événement : cet outil n'en rend jamais.

Erreurs :

  • « Aucun événement … » quand le slug n'existe pas : le reprendre d'un résultat de ridemypark_list_events.

  • « Cette fiche n'est pas un événement » quand le slug désigne un spot ou une boutique : l'erreur indique l'outil qui sert cet univers.

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_get_event"
  }
}

Input Schema

NameRequiredDescriptionDefault
idNoIdentifiant numérique de l'événement, à défaut de slug.
slugNoIdentifiant lisible de l'événement, tel que rendu par ridemypark_list_events.
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.4/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive, and the description adds substantive data caveats beyond them: events may have zero dates, past occurrences stay in 'dates' while 'future_dates' carries upcoming ones, free-text descriptions can be stale, and participant data never exists on this record type. It also documents the two failure messages, which annotations cannot convey.

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 with the purpose, then sectioned into parameters, return values, data limitations and errors, which is easy to scan. It loses a little to the verbatim repetition of the schema's parameter block and ranges, which the agent already has in structured form.

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?

With no output schema, the description fully carries the return contract by listing every field returned (dates, future_dates, address, coordinates, categories, gallery, website, links, update date, page URL). It also covers the empty-dates and stale-record cases and the error paths, which is everything needed to call and interpret this tool.

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 documents slug, id and response_format including the default and enum. The description restates the same ranges and the 'à défaut de slug' fallback without adding new semantics such as precedence rules between id and slug when both are supplied. Baseline 3 is appropriate when the schema does the heavy lifting.

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?

States a specific verb and resource ('Rend la fiche publique complète d'un événement RideMyPark') and enumerates what the record contains (quand/où, lien). It explicitly separates itself from the spot and shop universes by noting the record is served by the same route as a spot but validated as an event, so an agent can tell it apart from ridemypark_get_spot 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 Guidelines4/5

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

Gives concrete operational routing: the slug should be taken from a ridemypark_list_events result, and the 'Cette fiche n'est pas un événement' error is documented as pointing to the tool that serves the other universe. It stops short of an explicit when-not-to-use statement (e.g. 'pour un spot, appelez directement get_spot'), leaving that to be inferred from the error text.

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