Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
IDHALL_BASE_URLNoOverrides the IDhall instance URL, which is otherwise inferred from the JWT iss claim.
IDHALL_LANGUAGENoLanguage setting for the MCP server.
IDHALL_TIMEZONENoTimezone setting for the MCP server.
IDHALL_API_TOKENYesYour 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_HOSTSNoAllowed 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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 endpoint_id avant d'inspecter son schéma avec idhall_get_endpoint_spec ou d'appeler idhall_api_request.

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 /api/v1/reference/endpoints/{endpoint_id} si absent. Exemple d'endpoint_id : GET__ideas, POST__ideas, PATCH__ideas__(id).

idhall_list_ideasB

Liste les initiatives IDhall avec pagination, projection (props) et filtres (filter).

idhall_count_ideasB

Compte le nombre d'initiatives correspondant au filtre donné (IdeaFilter).

idhall_get_ideaA

Récupère les détails d'une initiative par son ID. Passez props pour obtenir plus que {id, title}.

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 (POST /api/v1/ideas).

idhall_create_idea_draftC

Crée une initiative à l'état brouillon (POST /api/v1/ideas/draft).

idhall_publish_idea_draftB

Publie une initiative brouillon existante (POST /api/v1/ideas/{id}/publish).

idhall_update_ideaA

Modifie partiellement une initiative existante (PATCH /api/v1/ideas/{id}).

Ne passez dans fields que les propriétés à modifier.

idhall_delete_ideaB

Supprime définitivement une initiative (DELETE /api/v1/ideas/{id}).

idhall_get_idea_stageB

Retourne l'étape de traitement en cours d'une initiative (GET /api/v1/ideas/{id}/stages/current).

idhall_transition_idea_stageB

Fait avancer ou annule l'étape de traitement d'une initiative.

Actions supportées :

  • standby, change-approver, request-details, request-expertise

  • approve--request-implementation-schedule, approve--launch-implementation, approve--end-implementation

  • reject, end-implementation, close

  • cancel (annule la dernière étape via DELETE /api/v1/ideas/{id}/stages/current)

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 (POST /api/v1/ideas/{id}/action-plan/tasks).

idhall_update_action_plan_taskC

Modifie une tâche d'un plan d'action (PATCH /api/v1/ideas/{id}/action-plan/tasks/{task_id}).

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 (DELETE /api/v1/ideas/{id}/action-plan/tasks/{task_id}).

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 (PUT /api/v1/ideas/{id}/memo).

idhall_get_idea_tagsC

Récupère les tags associés à une initiative.

idhall_manage_idea_tagsC

Ajoute (add), remplace (replace) ou supprime (remove) des tags sur une initiative.

idhall_get_opportunity_analysisC

Récupère l'analyse d'opportunité d'une initiative.

idhall_list_usersC

Liste les utilisateurs IDhall avec pagination, projection (props) et filtres (UserFilter).

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 idhall_search_endpoints et idhall_get_endpoint_spec.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.9/5.0

Scored across 33 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count3/5

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.

Completeness3/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues