Skip to main content
Glama

RideMyPark

Chercher des boutiques

ridemypark_search_shops
Read-onlyIdempotent

Cherche les boutiques du catalogue public RideMyPark : skateshops, magasins de vélo, ateliers et locations. Les résultats sont des fiches de l’univers shops, avec un lien /shops/.

Paramètres :

  • near (string, 3 à 120 caractères) : lieu autour duquel chercher. Sinon latitude + longitude, en degrés décimaux. Ces deux modes ne se combinent pas.

  • radius_km (number > 0, maximum 200, défaut 25) : rayon autour du point de recherche. Sans point, aucun rayon n’est appliqué.

  • country (string, 2 à 80 caractères), region, city (string, 1 à 80 caractères) : slugs rendus par ridemypark_browse_geography.

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

  • limit (integer 1-50, défaut 10), page (integer 1-20, défaut 1) : pagination.

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

Rend : shops (id, title, slug, url, adresse, coordonnées, photo et site web quand renseignés), page, total_matched, has_more et notes. origin et radius_km sont présents si la recherche est centrée sur un lieu. Le slug ou l’id permet de lire la fiche avec ridemypark_get_shop.

Limites : les fiches peuvent être incomplètes ou anciennes. Aucun stock, prix ou disponibilité de produit. Si une réponse amont contient un autre univers, ces fiches sont écartées, le total est omis et la pagination s’arrête avec une note.

Erreurs : lieu introuvable, coordonnées incomplètes ou modes de localisation combinés. Aucun résultat : élargir le rayon ou retirer un filtre.

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

Input Schema

NameRequiredDescriptionDefault
cityNoSlug de la ville, rendu par ridemypark_browse_geography.
nearNoLieu à géocoder pour chercher autour de ce point. Ne pas combiner avec latitude et longitude.
pageNoNuméro de page, de 1 à 20. La première page est 1.
limitNoNombre de boutiques par page, de 1 à 50, défaut 10.
queryNoMot-clé dans le titre, la description ou l’adresse.
regionNoSlug de la région, rendu par ridemypark_browse_geography.
countryNoSlug du pays, rendu par ridemypark_browse_geography.
latitudeNoLatitude du point de recherche, avec longitude et sans near.
longitudeNoLongitude du point de recherche, avec latitude et sans near.
radius_kmNoRayon en km autour du point de recherche. Sans point, 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.5/5.0
Behavior5/5

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

Beyond the provided annotations, the description discloses important behavioral caveats: records may be incomplete or outdated, no stock/price/availability is included, and upstream cross-universe records are filtered out with totals omitted and pagination stopped. It also documents error conditions and no-result behavior.

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

Conciseness5/5

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

The description is organized into Purpose, Parameters, Returns, Limits, and Errors sections, and the purpose is front-loaded. Every sentence contributes useful information without filler.

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 an 11-parameter search tool with no output schema, the description covers the key parameter interactions, result shape, pagination behavior, limitations, and error cases. An agent has enough information to select and invoke it correctly.

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?

With 100% schema description coverage, the schema already documents parameter meanings, defaults, ranges, and mode restrictions. The description restates these clearly but adds little semantic detail beyond what the schema already provides.

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?

The description states a specific verb and resource: 'Cherche les boutiques du catalogue public RideMyPark', and enumerates skate shops, bike shops, workshops, and rentals. It also scopes the result universe ('fiches de l’univers shops') and explains the /shops/<slug> linkage, making it distinguishable from sibling searches.

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?

It clearly directs the agent to ridemypark_browse_geography for country/region/city slugs and to ridemypark_get_shop for reading a full record. It also gives no-result and error recovery guidance. It does not explicitly contrast with sibling searches such as ridemypark_search_spots, but the scope is clear enough that this is a minor gap.

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