Skip to main content
Glama

Ficiel MCP

by io.ficiel
OverviewDiscussionsAdmin

Modifier le profil de Kord

ficiel_edit_agent_profile
DestructiveIdempotent

Modifie le profil STRUCTURÉ de Kord, comme l'écran de configuration, champ par champ : niche, positionnement, préréglage de ton (friendly, direct, warm, professional), tutoiement ou vouvoiement, emojis, langue de réponse, critères « qualifié » et « non qualifié », questions du script, action de fin (booking = rendez-vous, link = lien, handoff = passage à un humain), portrait de la cible, objections, canal de conversion, origine des conversations et ce que la personne a reçu avant d'écrire, problèmes déclarés, sources texte, retrait d'une source (lien ou texte), lien de réservation. Seuls les champs fournis changent ; une liste fournie REMPLACE la liste entière. Un texte trop long est REFUSÉ, jamais coupé. Le prompt de Kord est recompilé aussitôt. Chaque modification crée une version : ficiel_list_agent_config_versions la montre en entier, ficiel_restore_agent_config_version la restaure. Les instructions libres ne sont pas touchées (ficiel_edit_agent_prompt). Portée « write » requise.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nicheNoNiche en quelques mots (200 caractères au plus).
emojisNoEmojis : jamais, ou ponctuellement.
addressNoTutoiement ou vouvoiement.
languageNoLangue de réponse ; auto = la langue du message reçu.
questionsNoListe ENTIÈRE des questions du script (remplace l'existante), dans l'ordre.
objectionsNoListe ENTIÈRE des objections fréquentes de vos prospects (remplace l'existante).
pain_pointsNoVos problèmes déclarés avec vos messages (liste entière). N'entre pas dans le prompt.
positioningNoPositionnement : qui vous êtes, ce que vous vendez, à qui (8 000 caractères au plus).
pre_contactNoCe que la personne a reçu avant d'écrire (guide, vidéo, promesse).
tone_presetNoPréréglage de ton.
booking_linkNoLien de réservation partagé par Kord (adresse complète en https://). Chaîne vide = aucun lien.
flow_sourcesNoD'où viennent les conversations (liste entière).
moment_appelNoQuand Kord propose l'appel : dès qu'un lead qualifié parle du prix (prix), après deux ou trois échanges qualifiés (apres_echanges), ou seulement si le lead le demande (sur_demande).
text_sourcesNoListe ENTIÈRE des sources TEXTE de Kord. Les sources lien et leur résumé de page restent intactes (elles s'ajoutent dans l'application).
closing_actionNoAction de fin de script.
remove_sourcesNoSources à retirer, lien ou texte, désignées par leur adresse ou leur libellé exact. Une source introuvable fait refuser toute la modification.
target_profileNoPortrait de la cible, écrit par vous (8 000 caractères au plus).
conversion_detailNoPrécision sur la conversion (1 000 caractères au plus).
conversion_channelNoCanal de conversion préféré : appel, lien, autre.
qualified_criteriaNoListe ENTIÈRE des critères « qualifié » (remplace l'existante, 2 000 caractères par élément).
disqualified_criteriaNoListe ENTIÈRE des critères « non qualifié » (remplace l'existante).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / moment_appel
      Added value: +{
+  "description": "Quand Kord propose l'appel : dès qu'un lead qualifié parle du prix (prix), après deux ou trois échanges qualifiés (apres_echanges), ou seulement si le lead le demande (sur_demande).",
+  "enum": [
+    "prix",
+    "apres_echanges",
+    "sur_demande"
+  ],
+  "type": "string"
+}
  2. Changed2 schema fields changed
    • addedInput schema / properties / booking_link
      Added value: +{
+  "description": "Lien de réservation partagé par Kord (adresse complète en https://). Chaîne vide = aucun lien.",
+  "maxLength": 500,
+  "type": "string"
+}
    • addedInput schema / properties / remove_sources
      Added value: +{
+  "description": "Sources à retirer, lien ou texte, désignées par leur adresse ou leur libellé exact. Une source introuvable fait refuser toute la modification.",
+  "items": {
+    "maxLength": 500,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 20,
+  "type": "array"
+}
  3. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Goes well beyond the annotations (destructiveHint, idempotentHint, readOnlyHint=false) with concrete behavioral rules: partial updates ('Seuls les champs fournis changent'), list replacement semantics, hard rejection of over-long text ('REFUSÉ, jamais coupé'), immediate prompt recompilation, automatic version creation, and the required 'write' scope. This is the kind of operational detail an agent cannot infer from structured fields.

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?

Front-loaded with the core purpose and behavioral rules, and every sentence carries information. It is long, however, and enumerating all 21 fields overlaps heavily with the schema, which a leaner definition could omit.

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 a 21-parameter, all-optional mutation tool with no output schema, the description supplies the missing context: replacement semantics, validation behavior, versioning side effects, auth scope, and the sibling to use for prompt-only edits. Nothing needed to invoke it correctly appears absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, but the description adds cross-parameter semantics the schema states only locally: list fields replace the whole list, and remove_sources is validated atomically. It also glosses the closing_action and tone_preset enums in prose, adding marginal value over the schema.

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 precise verb and resource ('Modifie le profil STRUCTURÉ de Kord, comme l'écran de configuration, champ par champ') and enumerates the editable fields, so the agent knows exactly what this mutates. It explicitly distinguishes itself from the sibling ficiel_edit_agent_prompt ('Les instructions libres ne sont pas touchées').

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?

Clear context for use (structured profile editing, field by field) and it routes to alternatives: ficiel_edit_agent_prompt for free instructions, ficiel_list_agent_config_versions / ficiel_restore_agent_config_version for versions. It does not state when NOT to use it beyond that boundary (e.g., relationship to ficiel_get_agent_config for reading first), so it stops short of full when/when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Ficiel MCP toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources