MCPIdhall
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IDHALL_BASE_URL | No | Overrides the IDhall instance URL, which is otherwise inferred from the JWT iss claim. | |
| IDHALL_LANGUAGE | No | Language setting for the MCP server. | |
| IDHALL_TIMEZONE | No | Timezone setting for the MCP server. | |
| IDHALL_API_TOKEN | Yes | Your personal IDhall JWT token (My Account > Login & Security > REST API authentication tokens). Required for local stdio mode; remote clients supply it via the Authorization: Bearer header. | |
| IDHALL_ALLOWED_HOSTS | No | Allowed hosts setting for the MCP server, used in Docker/team-server deployments. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Serveur MCP pour l'API REST IDhall (Humanperf Software, v1). Chaque appel s'exécute avec le jeton JWT personnel de l'utilisateur et respecte ses droits IDhall. Note importante : les appels GET retournent uniquement des champs minimaux (id, title) par défaut ; utilisez le paramètre props pour demander des propriétés supplémentaires, et utilisez idhall_search_endpoints + idhall_get_endpoint_spec pour découvrir les propriétés exactes ou les endpoints spécialisés avant d'appeler idhall_api_request.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| idhall_aboutA | Retourne les informations sur la version d'IDhall et de son API REST. |
| idhall_whoamiB | Identifie l'utilisateur associé au jeton JWT courant et récupère sa fiche IDhall. |
| idhall_search_endpointsA | Recherche dans le catalogue local des 208 endpoints IDhall v1 (zéro appel réseau). Utilisez cet outil pour trouver l'endpoint exact et son |
| idhall_get_endpoint_specA | Retourne le schéma complet (paramètres, payload, classes, réponse) d'un endpoint IDhall. Lit d'abord le catalogue local ; interroge |
| idhall_list_ideasB | Liste les initiatives IDhall avec pagination, projection ( |
| idhall_count_ideasB | Compte le nombre d'initiatives correspondant au filtre donné ( |
| idhall_get_ideaA | Récupère les détails d'une initiative par son ID. Passez |
| idhall_get_idea_input_availabilityA | Retourne les propriétés disponibles/requises pour créer (idea_id=None) ou modifier une initiative. |
| idhall_create_ideaA | Crée et publie immédiatement une nouvelle initiative dans IDhall ( |
| idhall_create_idea_draftC | Crée une initiative à l'état brouillon ( |
| idhall_publish_idea_draftB | Publie une initiative brouillon existante ( |
| idhall_update_ideaA | Modifie partiellement une initiative existante ( Ne passez dans |
| idhall_delete_ideaB | Supprime définitivement une initiative ( |
| idhall_get_idea_stageB | Retourne l'étape de traitement en cours d'une initiative ( |
| idhall_transition_idea_stageB | Fait avancer ou annule l'étape de traitement d'une initiative. Actions supportées :
|
| idhall_get_idea_implementationC | Récupère les informations de mise en œuvre d'une initiative. |
| idhall_update_idea_implementation_progressC | Met à jour l'état d'avancement de la mise en œuvre d'une initiative. |
| idhall_list_action_plan_tasksC | Liste les tâches du plan d'action d'une initiative. |
| idhall_create_action_plan_taskC | Ajoute une tâche au plan d'action d'une initiative ( |
| idhall_update_action_plan_taskC | Modifie une tâche d'un plan d'action ( |
| idhall_update_task_progressC | Met à jour l'avancement d'une tâche d'un plan d'action. |
| idhall_delete_action_plan_taskC | Supprime une tâche d'un plan d'action ( |
| idhall_list_idea_contributionsC | Liste les contributions d'une initiative. |
| idhall_add_idea_contributionC | Ajoute une contribution (commentaire) à une initiative. |
| idhall_get_idea_memoC | Récupère le mémo d'une initiative. |
| idhall_set_idea_memoB | Définit ou remplace le mémo d'une initiative ( |
| idhall_get_idea_tagsC | Récupère les tags associés à une initiative. |
| idhall_manage_idea_tagsC | Ajoute ( |
| idhall_get_opportunity_analysisC | Récupère l'analyse d'opportunité d'une initiative. |
| idhall_list_usersC | Liste les utilisateurs IDhall avec pagination, projection ( |
| idhall_get_userB | Récupère la fiche d'un utilisateur IDhall par son ID. |
| idhall_list_reference_itemsC | Liste les éléments d'un référentiel IDhall (plans, sites, organizations, categories, risks, stakeholders, etc.). |
| idhall_api_requestA | Exécute un appel arbitraire vers n'importe lequel des 208 endpoints de l'API REST IDhall v1. Avant d'utiliser cet outil sur un endpoint spécialisé (ex: audits, parties prenantes/contacts,
ressources/pièces jointes, critères d'opportunité, lots de plan d'action), consultez son schéma
avec |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 33 tools
Most tools target a distinct resource+action (idea CRUD, draft lifecycle, stages, action-plan tasks, contributions, memo, tags, users, reference items), and the descriptions clarify the tricky pairs like create_idea vs create_idea_draft and update_action_plan_task vs update_task_progress. The main ambiguity is idhall_api_request, a catch-all that can do anything every other tool can, but the descriptions steer agents to the specialized tools first and to api_request only as fallback.
Almost all tools use the predictable `idhall_` prefix plus verb_noun in snake_case (list_ideas, get_idea, create_action_plan_task, delete_action_plan_task). Minor deviations are idhall_about and idhall_whoami (no verb_noun) and idhall_manage_idea_tags, which uses a generic verb where add/remove/replace would be more explicit.
33 tools is heavy for a single server, exceeding the comfortable 3-15 band, though it mirrors a large (208-endpoint) API and groups those endpoints into coherent domain tools rather than one-tool-per-endpoint. The presence of search_endpoints/get_endpoint_spec/api_request as a metatool layer partly justifies the breadth, but the surface still feels large for an agent to navigate.
Core idea lifecycle is well covered (create/draft/publish/update/delete, stages, implementation, tasks CRUD, memo, tags, contributions), so no major dead ends for the main workflow. However, several named sub-domains—audits, stakeholders/contacts, attachments/resources, opportunity criteria, plan lots—are reachable only through the raw api_request, and contributions have add/list but no edit or delete.