Skip to main content
Glama

Chercher des livres

search_books
Read-onlyIdempotent

Cherche dans le catalogue de livres de psychologie pratique, vendus sur le site en PDF, en audiolivre ou en pack ebook + audio selon les titres. À utiliser quand une personne veut approfondir un thème par la lecture (attachement, couple, estime de soi, etc.) ; la recherche est tolérante (pluriels, féminins, mots vides ignorés) et classe par pertinence. Renvoie, par livre : slug, titre, sous-titre, présentation abrégée, thèmes, offre (formats avec prix de référence en euros, pages), lien de la fiche d'achat et de l'extrait gratuit. Fiches uniquement : le livre entier n'est pas accessible ici et ne s'achète pas ici. Pour le détail d'un titre connu (présentation complète, langues de l'audiolivre) utiliser ensuite get_book avec son slug. Les fiches existent en fr, en, es, pt (titres et présentations en français).

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": "search_books"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNo
queryNoThème ou mots-clés (ex. « attachement », « confiance en soi »).
topicNoThème exact, tel qu'il figure dans le champ themes d'un résultat.
localeNoLangue de la personne : toujours renseigner ce paramètre avec la langue dans laquelle elle écrit (fr, en, es ou pt) ; sans lui, les pages s'ouvrent en français. Langue de la page ouverte (fr, en, es, pt). Les données de l'API publique sont en fr ou en ; pour es et pt, les titres sont en français et le lien ouvre la page dans la langue demandée quand elle existe.fr

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / locale / description
      Previous value: -"Langue de la page ouverte (fr, en, es, pt). Les données de l'API publique sont en fr ou en ; pour es et pt, les titres sont en français et le lien ouvre la page dans la langue demandée quand elle existe."New value: +"Langue de la personne : toujours renseigner ce paramètre avec la langue dans laquelle elle écrit (fr, en, es ou pt) ; sans lui, les pages s'ouvrent en français. Langue de la page ouverte (fr, en, es, pt). Les données de l'API publique sont en fr ou en ; pour es et pt, les titres sont en français et le lien ouvre la page dans la langue demandée quand elle existe."
  2. Changed2 schema fields changed
    • addedInput schema / properties / query / description
      Added value: +"Thème ou mots-clés (ex. « attachement », « confiance en soi »)."
    • addedInput schema / properties / topic / description
      Added value: +"Thème exact, tel qu'il figure dans le champ themes d'un résultat."
  3. Changed1 schema field changed
    • changedInput schema / properties / limit / default
      Previous value: -10New value: +6
  4. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/openWorld/non-destructive, so the safety profile is covered; the description goes further by disclosing search tolerance (plurals, feminine forms, stop words ignored), relevance ranking, that results are cards only with no purchase possible, and the per-book return fields. It stops short of pagination or result-count behavior, which keeps it below the top.

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?

A single dense paragraph, front-loaded with purpose then usage then return values then the get_book handoff. Nearly every clause carries information, though the localization sentence at the end is somewhat compressed and the return-field enumeration is long.

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

Completeness4/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 compensates by enumerating the returned fields per book and clarifying that no full text or purchase happens here. The main remaining gap relative to a 4-param search tool is the undocumented 'topic' vs 'query' distinction and limit behavior.

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 coverage is 75%, so the baseline is 3. The description adds meaning for the search text (morphological tolerance, relevance ordering) and reinforces the locale behavior, but it never explains how the 'topic' exact-theme filter differs from the free-text 'query', nor the default or maximum for 'limit'.

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 ('Cherche dans le catalogue de livres de psychologie pratique') and immediately scopes it: only cards, only sold formats (PDF, audiolivre, pack). It also explicitly separates itself from get_book, so an agent can route correctly 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 an explicit when-to-use condition ('quand une personne veut approfondir un thème par la lecture' with example themes) and names the follow-up alternative for a known title ('utiliser ensuite get_book avec son slug'). It also states a hard exclusion: the full book is neither accessible nor purchasable here.

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