assurance
Server Details
Loi Lemoine, simulateurs assurance emprunteur et statut produits (ORIAS 26000195).
- Status
- Healthy
- Uptime
- 99.9% over 21 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Scored across 11 tools
Each tool targets a distinct concern: workflow lifecycle (proposer/confirmer/annuler/lister), identity (jeton/opérateur), information (loi/statut/chercher), and cost calculations (simuler/comparer). Even the two insurance-cost tools are clearly separated by simulation vs comparison.
Most tools follow a clear French verb_noun pattern (chercher_contenu, simuler_cout, confirmer_action, annuler_action), with identity and reference tools using noun phrases (identite_jeton, statut_produits). The pattern is readable and predictable, though singular/plural varies (annuler_action vs lister_actions).
Eleven tools is well-scoped for an insurance information and lead-capture server. Each tool addresses a clear function without redundancy or bloat.
The surface covers the apparent domain completely: public content search, product status, legal reference, insurance cost tools, identity verification, and the full prepare/confirm/cancel/list lead workflow. No obvious dead-end or missing lifecycle step for the server's stated purpose.
Available Tools
11 toolsannuler_actionAInspect
Annule une action preparee non confirmee (scope leads.write).
| Name | Required | Description | Default |
|---|---|---|---|
| action_id | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations indicate the tool is not read-only and not destructive. The description adds the precondition that the action must be 'preparee non confirmee', but it does not disclose side effects (e.g., whether the action is deleted or marked as cancelled), nor does it mention any authorization or state change details beyond the 'leads.write' scope.
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 a single, succinct sentence that front-loads the core purpose. It contains no filler and is appropriately concise for a simple tool.
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 low-complexity tool with one parameter and no output schema, the description covers the essential purpose and precondition. It does not mention return values or error handling, but given the simplicity of the operation, this is an acceptable level of completeness.
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 schema has a single integer parameter 'action_id' with no description (0% schema coverage). The description implies that the tool cancels an action, so 'action_id' likely refers to the identifier of the action to cancel, but it does not explicitly state this or clarify how to obtain the ID. The description partially compensates but leaves some ambiguity.
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 clearly states the verb 'Annule' (cancel) and the specific resource 'action preparee non confirmee' (prepared unconfirmed action). It distinguishes this tool from the sibling 'confirmer_action' by focusing on cancellation of unconfirmed actions, making its purpose unambiguous.
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 specifies the condition 'non confirmee', implying it should be used only for prepared actions that haven't been confirmed yet. It provides a clear usage context but does not explicitly contrast with alternatives like 'confirmer_action' or mention exclusions beyond that condition.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chercher_contenuBRead-onlyInspect
Recherche dans l'index public des pages de ScoreProtect.fr (guides assurance, garanties, comparatifs).
| Name | Required | Description | Default |
|---|---|---|---|
| limite | No | ||
| requete | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false. The description adds that the search targets a public index, which usefully implies no authentication, but it does not disclose result shape, pagination, or how the limite parameter affects 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?
A single, front-loaded sentence with no redundant wording. It communicates the resource, the action, and the topic scope efficiently.
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 public search tool with read-only annotations, the core scope is mostly clear. However, with no output schema and no parameter documentation, the agent is left guessing about return format, limite semantics, and edge cases like empty results.
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% and the description does not explain either parameter. 'requete' and 'limite' are inferable from their names and the search context, but no format, defaults, examples, or constraints are provided, so the description fails to compensate for the low schema coverage.
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 a specific verb ('Recherche') on a specific resource ('l'index public des pages de ScoreProtect.fr') and narrows scope with content categories. This clearly differentiates it from sibling tools like simuler_cout_assurance_emprunteur or statut_produits.
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 guidance about when to use this tool versus the siblings, no when-not-to-use conditions, and no mention of alternatives. The 'index public' phrase gives some context but does not help an agent choose between tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
comparer_delegation_assuranceARead-onlyInspect
Compare le coût d'une assurance emprunteur groupe (banque) et déléguée (loi Lemoine) : coûts totaux et économie estimée.
| Name | Required | Description | Default |
|---|---|---|---|
| capital | Yes | ||
| duree_annees | Yes | ||
| taux_groupe_pct | Yes | ||
| taux_delegue_pct | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark the tool as read-only and non-destructive, so the safety profile is covered. The description adds that the tool produces total costs and an estimated savings figure, but does not disclose calculation assumptions, input constraints, or output format. With the annotation bar lowered, this is adequate but not rich.
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 entire description is one front-loaded sentence that says exactly what the tool does and what it returns, with no filler. It is concise while covering the core purpose and output categories.
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 four-number calculator, the description plus self-explanatory parameter names (capital, duration in years, rates as percentages) may be minimally sufficient, and it does state the two output categories. However, with no output schema, no parameter descriptions, and no mention of constraints or calculation basis, it leaves the agent to guess at currency, formula, and return shape.
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%, and the description only hints that taux_groupe_pct/taux_delegue_pct correspond to bank vs delegated scenarios; it does not explain units, acceptable ranges, or the roles of capital and duree_annees beyond their names. Parameter names carry some meaning, but the description adds almost no semantic value over the raw schema.
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 a specific action ('Compare') and identifies the exact resources: group borrower insurance vs delegated under the Lemoine law, along with outputs (total costs, estimated savings). This distinguishes it from the sibling 'simuler_cout_assurance_emprunteur', which appears to simulate a single cost scenario.
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 purpose implies the tool is for comparing bank vs delegated rates, but there is no explicit statement of when to prefer it over 'simuler_cout_assurance_emprunteur' or when not to use it. No prerequisites or exclusions are given, so an agent must infer usage from the description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
confirmer_actionAInspect
DEUXIEME etape : execute une action preparee, APRES confirmation explicite du visiteur. Scope requis: leads.write.
| Name | Required | Description | Default |
|---|---|---|---|
| action_id | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnlyHint=false and destructiveHint=false. The description adds that this is a write operation (scope leads.write) and requires explicit confirmation, which is useful. However, it does not explain side effects, idempotency, or error behavior, so it adds only moderate value beyond annotations.
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 one short sentence with all critical information front-loaded: the step, the action, the precondition, and the required scope. Every word 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 one-parameter tool with no output schema, the description covers the step, the precondition, and the required scope. It could mention that action_id must reference a pending prepared action or describe error cases, but these are minor gaps given the low complexity.
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 schema has 0% description coverage and the description does not explicitly explain the single parameter action_id. It only implies its role via 'action preparee', leaving the agent to infer that action_id identifies the prepared action. The description should have compensated for the schema gap.
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 a specific verb ('execute') and a specific resource ('action preparee'), and clearly locates it as the second step after explicit visitor confirmation. This distinguishes it from siblings like lister_actions (listing) and annuler_action (cancelling).
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 gives a clear precondition ('APRES confirmation explicite du visiteur') and positioning ('DEUXIEME etape'), which implies it should only be used after a prepared action and confirmation. It does not explicitly name alternatives or state when not to use it, but the context is clear enough.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
identite_jetonARead-onlyInspect
Renvoie les claims du jeton OAuth fourni (sub, scope, audience, expiration) — permet a un client de verifier son autorisation. Sans jeton : indique comment en obtenir un.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark the operation as read-only and non-destructive. The description adds useful behavioral context beyond that: it lists the returned claims and explains the no-token fallback behavior. It does not disclose error handling for invalid/expired tokens, but the annotations lower the burden.
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 compact, front-loaded with the core action, and every part adds value: what it returns, why it is useful, and what happens without a token. There is no filler or repetition of schema/annotation data.
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 tool with no output schema, the description covers the main needs: the returned claims are enumerated, and the no-token case is addressed. It could add how the token is supplied or what invalid-token responses look like, but these are minor 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?
The input schema has zero parameters, so the description does not need to explain parameter behavior. The phrase 'jeton OAuth fourni' implies the token comes from the request context rather than a parameter, which is consistent with the empty schema. Baseline 4 applies for a zero-parameter tool.
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 clearly states a specific verb and resource: it returns the claims of the provided OAuth token and lists the key fields (sub, scope, audience, expiration). It is distinct from sibling tools by its explicit focus on OAuth token claims, though it does not explicitly contrast itself with identite_operateur.
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 gives a clear use case: allowing a client to verify its authorization, and it explains the behavior when no token is present (indicates how to obtain one). It does not explicitly mention when not to use it or name alternatives, so it stops short of full routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
identite_operateurARead-onlyInspect
Identité publique de l'éditeur (TENDIL COURTAGE, SIREN, ORIAS, catégories) — utile pour vérifier qu'il ne s'agit pas d'un site frauduleux.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare the tool read-only and non-destructive. The description adds useful context by specifying the content is public identity data (SIREN, ORIAS, categories) and frames it as a trust/verification resource, going beyond the annotation baseline.
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 a single, focused sentence that front-loads the core purpose and immediately adds a practical use case. Every word earns its place with no redundancy.
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 informational tool, the description is nearly sufficient. It names the key returned data categories and the anti-fraud purpose. It does not describe the exact return format, but with no output schema and such a simple tool, this is a minor 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 schema has zero parameters, so no parameter documentation is required. The description does not need to explain parameters and the baseline of 4 is appropriate.
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 clearly identifies the resource: the public identity of the publisher, including specific data points (TENDIL COURTAGE, SIREN, ORIAS, categories). It lacks an explicit verb like 'returns' or 'provides', but the intent is unambiguous and it is distinct from the sibling tools.
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 states an explicit use case: verifying that the site is not fraudulent. It does not mention exclusions or alternative tools, but the guidance is clear enough for an agent to know when this tool is relevant.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
lister_actionsARead-onlyInspect
Liste les actions preparees recentes pour le jeton courant (scope leads.read).
| 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 and destructiveHint=false, so the safety profile is covered. The description adds the scope requirement but doesn't elaborate on what 'actions preparees' means, whether results are paginated, or if any state changes occur. Since annotations carry the main safety info, this is acceptable but not rich.
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 a single, concise sentence that front-loads the primary action (list) and resource (prepared actions). No filler or redundancy. It earns a top score for efficiency.
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 list tool with no output schema, the description is sufficiently complete. It specifies the scope and the resource. It could mention whether results are ordered or paginated, but these are minor gaps for such a simple operation.
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 has zero parameters, so the baseline is 4 per the guidelines. The description doesn't need to add parameter details since none exist. It correctly avoids mentioning any, which is appropriate.
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 clearly states it lists recent prepared actions for the current token, with an explicit scope (leads.read). It distinguishes from siblings like annuler_action and confirmer_action by being a list operation, though it doesn't name them directly. The verb 'Lister' plus the resource 'actions preparees' is specific enough.
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 (to view prepared actions) but provides no explicit guidance on when to prefer this over alternatives. There's no mention of when not to use it or which sibling to choose for other scenarios. However, for a list action, the context is fairly obvious.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
loi_lemoineBRead-onlyInspect
Loi Lemoine 2026 : délégation d'assurance emprunteur à tout moment, résiliation annuelle, garanties équivalentes, questionnaire de santé. Faits vérifiés.
| 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 and destructiveHint=false, covering the safety profile. The description adds the claim 'Faits vérifiés' (verified facts), which is useful context about content reliability. However, it doesn't disclose return format, whether the output is a static summary, or any limits. It adds some value beyond annotations but not rich behavioral context.
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 a single efficient sentence with topics clearly front-loaded and zero filler. It earns its place by enumerating the law's coverage. Minor deduction for lacking a clear verb, which makes it read more like a tagline than a functional statement, but there is no waste.
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 fact tool, the description lists the covered topics adequately. However, the functional nature is ambiguous—it never states what the agent receives or should relay to the user (a summary, a fact sheet, a citation). Since there is no output schema to compensate, this gap matters and keeps it from being complete.
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?
There are zero parameters, so the schema needs no description support; per the baseline, 4 is appropriate when no parameters exist. The description correctly does not attempt to document nonexistent parameters. Nothing is missing here.
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 the specific resource (Loi Lemoine 2026) and lists its key topics (delegation, annual termination, equivalent guarantees, health questionnaire), which distinguishes it from siblings. However, it lacks an explicit action verb—there's no 'returns', 'explains', or 'provides'—so the description reads like a content summary rather than a functional spec. An agent can infer it's an information-retrieval tool but only indirectly.
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 guidance is given on when to use this tool versus siblings like chercher_contenu (search content) or comparer_delegation_assurance (compare delegation). An agent cannot tell whether to pick this over chercher_contenu when a user asks about the law. The description provides no exclusions, conditions, or alternative names.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
proposer_demande_rappelBInspect
PREMIERE etape d'une ecriture : prepare une demande de rappel (email + consentement explicite OBLIGATOIRES). Retourne un action_id a confirmer par l'utilisateur. Scope requis: leads.write.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| Yes | |||
| projet | No | ||
| consent | Yes | accord explicite du visiteur (true requis) | |
| message | No | message du visiteur, sans donnees sensibles | |
| telephone | No | ||
| type_projet | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The annotations (readOnlyHint=false, destructiveHint=false) are minimal and do not cover the tool's behavior extensively, so the description bears more responsibility. It discloses that the tool is non-committal (returns an action_id to confirm) and requires explicit consent, which is useful. However, it does not describe side effects, idempotency, or what happens if consent is false, leaving some behavioral aspects opaque.
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 a single, dense sentence that front-loads the key information: it is the first step of a write, requires email and consent, and returns an action_id. It is concise and efficient, with no redundant words. Slightly more structure (e.g., separating steps) could improve readability, but it is acceptable as is.
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?
Given the tool has 7 parameters, 2 required, and no output schema, the description provides the essential workflow context (preparatory step, confirmation needed) but omits details like the return structure (only mentions action_id), error handling, and the role of optional parameters. It is sufficient for a basic call but lacks depth for an agent to anticipate all edge cases.
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?
Only 29% of parameters have schema descriptions (consent and message). The description adds no semantics for the other five parameters (name, email, projet, telephone, type_projet). It only highlights that email and consent are mandatory, which is already in the schema's required list. The description fails to compensate for the low coverage, leaving the meaning of several parameters unclear.
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 clearly states the tool's function: it is the first step of a write operation, preparing a callback request that requires email and explicit consent, and returns an action_id for later confirmation. It distinguishes itself as a preparatory step rather than the final action, which sets it apart from its sibling confirmer_action. While it doesn't name the sibling, the purpose is specific and unambiguous.
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 it should be used before confirmer_action by noting it returns an action_id to be confirmed, but it lacks explicit guidance on when to use this tool versus alternatives. It does not mention when not to use it, nor does it reference any sibling tools. The only hint is the phrase 'PREMIERE etape', which suggests a sequential workflow, but no explicit conditions or exclusions are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
simuler_cout_assurance_emprunteurARead-onlyInspect
Calcule le coût d'une assurance emprunteur (total, mensuel moyen, première année) à partir du capital, du taux annuel en % du capital et de la durée.
| Name | Required | Description | Default |
|---|---|---|---|
| capital | Yes | ||
| duree_annees | Yes | ||
| taux_annuel_pct | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, so the safety profile is covered. The description adds that it computes total, average monthly, and first-year cost, which is useful output context, but it does not disclose behavioral traits such as rounding, assumptions about rate application, or limitations. It is consistent with annotations, so no contradiction, but it adds limited behavioral depth beyond annotations.
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 a single, efficient sentence that packs the action, the resource, the outputs, and the inputs with zero waste. It is front-loaded with the verb and immediately communicates the core function, making it easy to scan.
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?
The tool is a straightforward calculation with three parameters and no output schema. The description adequately explains the inputs and the expected outputs (total, average monthly, first-year cost), which is sufficient for an agent to invoke it correctly. It lacks details on calculation methodology or edge cases, but these are not critical for basic usage. Overall, it is complete for the tool's simplicity.
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 compensate. It explicitly names each parameter: capital, taux_annuel_pct (annual rate as a percentage of capital), and duree_annees (duration). It clarifies that the rate is a percentage and the duration is in years, which adds meaning beyond the bare schema types. However, it does not specify the currency for capital, leaving some ambiguity, hence not a 5.
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 clearly states the verb 'Calcule' (calculates) and the resource 'le coût d'une assurance emprunteur' (borrower insurance cost). It also specifies the exact outputs (total, average monthly, first year) and the inputs (capital, annual rate as % of capital, duration). This fully distinguishes it from siblings like 'comparer_delegation_assurance' (which compares delegation insurance) and other unrelated tools, leaving no ambiguity about its purpose.
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 explains what the tool does but does not explicitly state when to use it versus alternatives. It implies use when a cost calculation is needed, but there is no mention of exclusions, prerequisites, or alternative routing to sibling tools. The context is clear enough for an agent to infer usage, but explicit guidance is lacking.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
statut_produitsARead-onlyInspect
État canonique et vérifiable des produits ScoreProtect (assurance emprunteur, prévoyance TNS, habitation, auto, mutuelle, professionnelle, cyber) : distribution ouverte ou non.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark this as read-only and non-destructive. The description adds value by clarifying the exact kind of state ('canonical and verifiable') and what dimension is exposed ('distribution ouverte ou non'). No contradiction with annotations.
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 a single, compact sentence with no wasted words. It front-loads the core purpose and lists scope explicitly.
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 status tool, the description covers the resource, the product scope, and the result dimension. It is complete enough for an agent to select and call it correctly, though slightly abstract terms like 'canonique' could be expanded.
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 has zero parameters and schema coverage is 100%, so there is no parameter burden for the description to carry. The baseline of 4 applies because nothing is missing.
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 clearly identifies the resource: a canonical, verifiable status of ScoreProtect products, and enumerates the product categories. It also defines the key output dimension ('open distribution or not'). It lacks an explicit verb but is specific enough to distinguish it from the listed sibling tools.
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 phrase 'canonical et vérifiable' implies this is the authoritative source for product status, and the product list gives a clear scope. However, there is no explicit guidance on when to use this tool versus alternatives like comparer_delegation_assurance or chercher_contenu.
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.
4 tool updates
- Added
annuler_action - Added
confirmer_action - Added
lister_actions - Added
proposer_demande_rappel
1 tool update
- Added
identite_jeton
6 tool updates
- First observed
chercher_contenu - First observed
comparer_delegation_assurance - First observed
identite_operateur - First observed
loi_lemoine - First observed
simuler_cout_assurance_emprunteur - First observed
statut_produits
Related MCP Connectors
Outils ScoreInvest.fr en lecture seule : taux, simulateurs, statut produits, démenti phishing.
Connect AI agents to licensed financial intermediaries in France: insurance, credit, wealth.
Calcul fiscal (IR, IFI, PER, plus-value) et retraite français — 32 régimes, sourcé et daté.
French inheritance tax engine: simulate, compare scenarios, savings estimate, premium optimizer.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenancePersonal finance MCP server providing loan simulation, budgeting, investment comparison, retirement planning, French tax optimization, and inflation calculation through natural language.11 npmMIT
- AlicenseAqualityBmaintenanceEnables transparent, indicative mortgage calculations for annuities and linear mortgages, including comparisons, product listings, and interest rate information.5MIT
- AlicenseNot gradedqualityBmaintenanceSourced, dated calculations for French income tax and pensions across 32 retirement schemes — every result carries its confidence level, its legal sources and the fiscal year, and returns non_calculable rather than a guess. Hosted remote MCP + REST, paid per call via x402 (USDC on Base); two discovery tools are free.1MIT
- FlicenseNot gradedqualityFmaintenanceFrench real estate data platform for AI agents. Identifies property owners likely to sell and tracks behavioral signals on active listings. Coverage: metropolitan France.-
Glama MCP Gateway
Add one secure layer between your agents and this server.