Psychologie & Sérénité
Server Details
Catalogue public en lecture seule : tests psychologiques, blog, livres et services (FR/EN).
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Scored across 11 tools
Most tools target clearly distinct resources and actions: search_* tools are separated by content type, and get_* tools retrieve a specific item or record. There is minor overlap because describe_service could cover tests, books, or articles, but get_test, get_book, and get_article have narrower and clearer purposes. No two tools appear identical.
All tool names use snake_case with a consistent verb_noun pattern: search_articles, get_book, list_services, describe_service, start_test. The convention is predictable throughout, despite the descriptive text being in French.
Eleven tools fit the scope of a multi-content psychology portal well. Each major content type has search/get coverage, services can be listed and described, and start_test handles the external test-taking flow. There is no obvious redundancy or bloat.
The set covers core discovery and access: services, articles, books, tests, concepts, example reports, and starting a test. Minor gaps remain, such as no dedicated get_concept detail tool, no explicit language filter on search tools, and no direct tool for the assistant or community salon services. These are workable limitations rather than blocking omissions.
Available Tools
11 toolsdescribe_serviceDécrire un serviceBRead-onlyIdempotentInspect
Décrit un service en détail avec son adresse officielle, y compris par langue quand elle existe (PSW et PT : 4 langues ; ScanMyLove : 14 langues).
| Name | Required | Description | Default |
|---|---|---|---|
| service | Yes | Identifiant du service (voir list_services). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the safety profile (readOnlyHint=true, idempotentHint=true, destructiveHint=false), so the description's burden is lower. It usefully adds that the return includes the official address and language variants (with counts for PSW/PT/SML), but says nothing about format, errors, or whether an unknown service id fails.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One front-loaded sentence that opens with the verb and resource, with the return detail in a trailing parenthetical. No filler. The language-count parenthetical is informative rather than wasteful, though it is slightly cluttered.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description should carry more of the return-value burden; it does say the response includes the official address and language availability, which is genuinely useful. However, it leaves the overall shape of the response (per-language fields, structure) unspecified.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single 'service' parameter has an enum plus a description pointing to list_services, so the schema does the heavy lifting. The description adds no meaning about the identifier beyond what the schema already states; baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Décrit un service en détail') and enumerates what the detail contains: official address and per-language availability. This clearly separates it from a listing tool like list_services, though it does not name that sibling explicitly in the description text.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit when-to-use or when-not-to-use guidance. The phrase 'en détail' implies use this for a single service's full detail rather than list_services, and the schema notes 'voir list_services', but the description itself offers no routing instructions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_articleLire un articleBRead-onlyIdempotentInspect
Texte complet d'un article du blog (Markdown, licence CC-BY 4.0), en français ou en anglais.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| locale | No | fr |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint, so the safety profile is covered. The description usefully adds output characteristics (Markdown, CC-BY 4.0 license, fr/en content) but says nothing about lookup failure behavior or truncation for long articles.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence that states resource, return format, license and language with zero redundancy. Every element earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter read tool with no output schema and annotations that already cover safety, the description supplies the key return-value context (format, license, languages). Only edge-case behavior (unknown slug, very long articles) is absent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must carry the load. It partially compensates by implying the locale dimension ('en français ou en anglais'), which maps to the fr/en enum, but the required 'slug' parameter (maxLength 220) is never explained or exemplified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific resource ('Texte complet d'un article du blog') and qualifies the return format (Markdown) and license, which is well beyond a tautology. It implies it differs from search_articles by promising the full text, but never names the sibling or contrasts explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to use this tool versus the sibling search_articles, nor any prerequisite about needing a known slug. Usage is only inferable from the name and the word 'complet'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_bookFiche d un livreBRead-onlyIdempotentInspect
Fiche d'un livre : présentation, thèmes, liens vers la fiche et l'extrait gratuit. Pas de texte intégral, pas de prix (affiché sur le site selon le pays).
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| locale | No | 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 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false, so the safety profile is covered. The description adds that the tool excludes full text and price, and notes that price varies by country on the website, giving some extra behavioral context beyond annotations. It still omits details like authentication, rate limits, or pagination.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two compact sentences with no wasted words. The first phrase restates the title, which is slightly redundant, but overall the structure is front-loaded and efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple retrieval tool with no output schema, the description partially covers return contents but misses the action verb and any parameter explanation. It also does not clarify how the required slug is used or how the locale parameter affects the response, leaving notable gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 50%, with the slug parameter having no description at all. The description does not mention either parameter, so it fails to compensate for the missing slug guidance and adds no meaning beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with the title repeated ('Fiche d'un livre') and then enumerates the content returned (presentation, themes, links, free extract), implying retrieval. However, it never states an action verb (e.g., 'retrieve', 'fetch') and does not differentiate itself from sibling tools like search_books.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides negative usage boundaries by explicitly stating what the tool does not return ('Pas de texte intégral, pas de prix'), which hints at when not to use it. But it never names an alternative tool or states positively when this tool is the right choice.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_example_reportExemple de rapportBRead-onlyIdempotentInspect
Lien vers un exemple de rapport : pour un test (page « exemple »), ou le rapport de démonstration ScanMyLove.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Slug du test (service=test). | |
| locale | No | 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 |
| service | No | test |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description usefully discloses that the tool yields a link rather than report content, which is behavior beyond the annotations, but adds nothing about auth needs, rate limits, or failure modes (e.g., missing slug).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no padding. It is efficient, though the phrasing ('Lien vers un exemple de rapport') is slightly ambiguous about exactly what is returned.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, so the description carries the return-value burden; it says a link is returned but not the format or behavior when slug/service is invalid. For an optional-parameter lookup tool with annotations covering safety, this is minimally adequate but leaves the agent guessing on output and error handling.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 67% schema coverage, the description compensates for the undocumented 'service' enum by explaining that 'test' maps to the example page and 'sml' to the ScanMyLove demo report. The slug and locale semantics are already well documented in the schema, so the added value centers on the service parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the resource (a link to an example report) and distinguishes two variants: a test's example page and the ScanMyLove demo report. However, it largely restates the title 'Exemple de rapport' without a crisp verb (does it return a URL string, open a page, or fetch the report?) and never distinguishes itself from siblings like get_test or get_article.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance or alternatives are given. The mention of 'pour un test' vs 'le rapport de démonstration ScanMyLove' hints at which service value to pick, but that is parameter mapping, not usage guidance for selecting this tool over siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_testFiche d un testARead-onlyIdempotentInspect
Fiche détaillée d'un test : présentation, dimensions mesurées, durée. Aucune question ni aucun résultat.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| locale | No | 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 |
| category | Yes | Slug de thème, tel que renvoyé par search_tests. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds only a scope caveat about what is not returned; it says nothing about error behavior for an invalid category/slug or lookup failure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One efficient sentence with the content summary front-loaded, followed by a short exclusion clause. No filler, though it is terse enough that the exclusion clause carries more structural weight than its content justifies.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read-only fetch with no output schema, the description sketches the returned fields and rules out questionnaire/results content. Combined with rich annotations and mostly documented parameters, an agent has enough to call it correctly; only failure modes remain unaddressed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 67%: locale and category carry full descriptions (including a cross-reference to search_tests and locale fallback behavior), while slug is undocumented but self-evident. The description adds no parameter meaning of its own, so the schema does the work — baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific resource (the detail sheet for one test) and enumerates what it contains: presentation, measured dimensions, duration. The closing clause ('Aucune question ni aucun résultat') distinguishes it from siblings like start_test and get_example_report, though the verb is implicit rather than explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is only implied via negative scoping: 'no questions, no results' hints that start_test and get_example_report are the tools for those needs, but no alternative is named and no when-to-use condition is stated. Adequate but leaves routing to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_servicesLister les servicesARead-onlyIdempotentInspect
Liste tous les services de Psychologie & Sérénité (tests, blog, livres, assistant, Salon Psy, salon communautaire, ScanMyLove, ScanMyJob) et leurs langues.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and openWorldHint=true, so the safety and idempotency profile is covered. The description adds that it returns the full catalog and each service's supported languages, but says nothing about result size or ordering.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence is just as long as it needs to be, though the long parenthetical enumeration of service names is somewhat heavy. Every element is informative, so nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter, read-only listing tool with no output schema, the description goes a good way toward compensating by naming the categories returned and noting the language dimension. Return format details (field names, ordering) remain undisclosed, which is the only real gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the baseline is 4 and there is nothing for the description to disambiguate. The mention of 'leurs langues' hints at the returned data shape but is not a parameter concern.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a clear verb ('Liste') plus resource ('services') and even enumerates the service categories covered (tests, blog, livres, assistant, Salon Psy, etc.), so the scope is unambiguous. It does not explicitly name a sibling like describe_service, but the 'all services' framing makes the list-vs-detail split inferable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit when-to-use or when-not-to-use guidance and no alternatives named. Usage is only implied by the broad, unfiltered 'tous les services' framing, which is adequate for a zero-parameter discovery tool but leaves the agent to infer that describe_service is the follow-up.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_articlesChercher des articlesBRead-onlyIdempotentInspect
Cherche dans le blog (plus de 1 500 articles en français, autant en anglais). Renvoie titres, résumés et liens. Le blog existe aussi en espagnol et en portugais (pages séparées, non cherchables ici).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| locale | No | 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 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, openWorldHint and non-destructive, so the safety profile is covered. The description adds genuine value beyond annotations by disclosing the return shape (titres, résumés, liens) and the unsearchable es/pt corpus, but stays silent on pagination and the interaction with the limit cap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three tight sentences: purpose, return values, then the language caveat, front-loaded with the primary function. No filler, though the corpus-size figures are borderline colour rather than operational detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read-only search with no output schema, the description covers the essentials an agent needs: what is searched, what comes back (titles, summaries, links), and the language-coverage caveat. The gap is the absence of any guidance on the limit/query parameters, which the schema leaves bare.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is only 33% — just 'locale' is documented, and its schema text already explains the fr/en/es/pt behaviour in more detail than the description. The description adds nothing about 'query' (syntax, matching) or 'limit' (default 10, max 30), so it fails to compensate for the undocumented parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
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 blog') and quantifies the corpus (1 500+ FR, as many EN), which distinguishes it from the sibling search_books, search_concepts and search_tests by making the 'articles/blog' scope explicit. It stops short of naming those siblings directly, so differentiation relies on inference.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides a partial when-not by stating the es/pt pages are 'non cherchables ici', which scopes the tool, but gives no positive guidance on when to prefer search_articles over get_article or the other search_* tools. Usage is implied rather than instructed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_booksChercher des livresARead-onlyIdempotentInspect
Cherche dans le catalogue de livres (fiches uniquement : le livre entier n'est pas accessible ici). Les fiches existent en fr, en, es, pt.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| topic | No | ||
| locale | No | 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 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare the read-only, non-destructive, idempotent, open-world profile, so the safety story is covered. The description adds real context beyond that: results are catalogue records only, the full book is unavailable here, and records exist in fr/en/es/pt. It still omits result format and pagination behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences, front-loaded with the core action and immediately qualified by the scope limitation and language availability. Every clause carries information; nothing is filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and 25% parameter coverage, the description should do more work: it discloses the record-only limitation but not what a result contains, how many results come back, or how query/topic are matched. Adequate as a minimum, but incomplete for a four-parameter search tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is only 25% (locale is the sole documented parameter), so description must compensate. It mentions the language set (fr, en, es, pt) which loosely maps to locale, but says nothing about query, topic, or limit semantics — leaving three of four parameters undocumented.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb and resource ('Cherche dans le catalogue de livres') and adds a meaningful scope caveat (only records/cards, not the full book). It does not name or contrast with the obvious sibling get_book, so the agent must infer the search-vs-retrieve distinction on its own.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The parenthetical 'fiches uniquement : le livre entier n'est pas accessible ici' implies that full-text access must come from another tool (likely get_book), but the description never names the alternative or states the condition for choosing it. Usage is implied rather than spelled out.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_conceptsChercher des conceptsCRead-onlyIdempotentInspect
Concepts et modèles cliniques expliqués (attachement, Gottman, schémas de Young, etc.).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds nothing behavioral beyond that: no mention of result format, ranking, pagination, or what happens on an empty query.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
It is a single tight sentence with no filler, but the brevity stems from under-specification rather than economy: the fragment omits the verb and any usage or parameter information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a search tool with no output schema and two undocumented parameters, the description is too thin. It does not convey what a call returns or how search behaves, so an agent cannot confidently invoke it versus sibling search tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% for both 'query' and 'limit', so the description carries the full burden and does not compensate. It never explains that 'query' is a free-text search term or what 'limit' controls, though the examples hint at the queryable subject matter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a domain ('concepts et modèles cliniques') and gives concrete examples (attachement, Gottman, schémas de Young), which loosely distinguishes it from the article/book/test searchers. However it is a noun phrase with no verb, never stating that it performs a search, so an agent must infer the action from the tool name.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no indication of when to choose this tool over search_articles, search_books, or search_tests, nor any prerequisites or exclusion conditions. The sentence only describes content, leaving routing entirely to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_testsChercher des testsARead-onlyIdempotentInspect
Cherche parmi les 206 tests psychologiques (fiches). Filtre par mots-clés et/ou thème. Ne renvoie ni questions ni résultats.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | Mots-clés (ex. « anxiété », « jalousie »). | |
| locale | No | 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 |
| category | No | Slug de thème (ex. anxiety, diagnostic). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, non-destructive and openWorld, so the safety profile is covered. The description adds genuinely new context by stating what the tool does NOT return ("Ne renvoie ni questions ni résultats"), which prevents an agent from expecting test items or scores. It stops short of describing pagination or ordering behaviour.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short, front-loaded sentences: what is searched, how it filters, what it does not return. No filler and no repetition of the title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 4-parameter, no-output-schema search tool, the definition covers scope, filter mechanism and the key negative about return content, which is the main ambiguity an agent would face. It could still say more about result shape or how limit interacts with the 206-item corpus, but nothing essential for correct invocation is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 75%: query, category and locale carry their own descriptions (locale quite thoroughly). The description only echoes keywords and theme, adding the combinability nuance but saying nothing about limit or how category slugs relate to free-text query. With the schema doing most of the work, the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb ("Cherche") plus the resource and its scope ("206 tests psychologiques (fiches)"), which cleanly separates it from the singular get_test and from search_articles/search_books. It does not explicitly name a sibling to contrast with, so it stops short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
"Filtre par mots-clés et/ou thème" implies how the tool is used, and the phrase "et/ou" signals the filters are combinable. But there is no explicit statement of when to pick this over get_test (browse/search vs. fetch one known sheet), so usage is only implied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
start_testLien pour passer un testARead-onlyIdempotentInspect
Donne le lien pour RÉALISER un test (anonyme, sans compte). La passation, le niveau obtenu et l'éventuel rapport détaillé payant se font sur le site, pas dans la conversation.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Slug ou id du test. | |
| locale | No | 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 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, openWorld and non-destructive, so the safety profile is covered. The description adds genuinely new behavioral context: the returned link is anonymous with no account, and the actual test pass, level scoring and paid report all happen off-conversation on the website, which tells the agent this call is a gateway, not an executor.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with what the tool produces, followed by the one non-obvious fact (the workflow continues outside the conversation). Nothing is redundant with the title or annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description correctly states that the return is a link and that everything downstream happens on the site, which is the key thing an agent needs. It could go slightly further on whether the link is one-time or shareable, but the essentials are present.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both slug and locale are already documented in the schema (including the language fallback nuance). The description adds no parameter-level detail, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: it returns the link to take a test, and clarifies the test is anonymous and account-free. However it never names or contrasts with close siblings like get_test or search_tests, so an agent gets the purpose but must infer the boundary itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage (anonymous test-taking) but never states when to pick this over get_test or search_tests. The note that execution happens on the site rather than in conversation is useful context, but it is a workflow fact, not an explicit use/when-not-to-use rule.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
11 tool updates
- First observed
describe_service - First observed
get_article - First observed
get_book - First observed
get_example_report - First observed
get_test - First observed
list_services - First observed
search_articles - First observed
search_books - First observed
search_concepts - First observed
search_tests - First observed
start_test
Related MCP Connectors
Catalogue public anonyme en lecture seule. Anonymous, read-only public catalog.
Tests, livre « Se poser les bonnes questions » et recherche plein texte, en lecture seule.
Read-only mindfulness games, guided practices, research, glossary and PanchaVikas resources.
Read-only MCP for public mental-health workflows and Evidence from 病み期の読み物.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search a French guide catalog by keyword and retrieve the full text of any published step-by-step connection guide, plus the site's llms.txt catalog as a resource. Read-only and unauthenticated, it serves only live published content.MIT
- AlicenseAqualityCmaintenanceProvides read-only access to reaction time test catalog, measurement rules, FAQ, and official links for AI clients like Claude Desktop. Cannot run tests; it only exposes documentation context.2MIT
- AlicenseNot gradedqualityCmaintenanceRead-only MCP server exposing the catalog of articles from moncompte.org. Enables AI agents to search and retrieve article content via tools.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search and retrieve French job profiles, RNCP certifications, training programs, training centers, and skills comparisons in read-only mode without requiring an account.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.