Skip to main content
Glama
fauguste

boondmanager-mcp-server

by fauguste
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Rechercher des positionnements

boond_positionings_search
Read-onlyIdempotent

Search positionings to track candidate and resource placements across projects. Filter results by candidate, opportunity, resource, company, contact, or product.

Instructions

Recherche des positionnements (placement de candidats/ressources sur des projets/opportunités) dans BoondManager.

Quand : pour suivre l'avancement des profils proposés, plusieurs affaires confondues. Plutôt que : les onglets positionings (boond_candidates_positionings, boond_opportunities_positionings, boond_resources_positionings) quand on part d'une entité connue.

L'API ne propose pas de paramètres de filtre dédiés : le filtrage par entité liée passe par des références dans keywords (AO=opportunité, CAND=candidat, COMP=ressource, CSOC=société, CCON=contact, PROD=produit). Les filtres *Id ci-dessous sont convertis automatiquement en ces références.

Args:

  • keywords (string, optional): Termes de recherche (références d'entités acceptées)

  • candidateId, resourceId, opportunityId, companyId, contactId, productId (string, optional): Filtrer par entité liée (convertis en références keywords)

  • page, pageSize: Pagination

Returns: Liste des positionnements correspondants.

  • fields : projection côté MCP, jamais transmise à l'API — remplace le résumé par les seuls attributs listés (noms inconnus ignorés). À utiliser sur les grosses pages.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoNuméro de page (max: 100)
fieldsNoProjection : attributs à afficher par résultat (ex: ['title','updateDate']). Absent = résumé standard. Noms inconnus ignorés.
keywordsNoMots-clés de recherche. L'API y accepte aussi des références d'entités (AO<id>, CAND<id>, COMP<id>...) — les filtres *Id ci-dessous sont convertis automatiquement en de telles références.
pageSizeNoRésultats par page
companyIdNoFiltrer par ID société (envoyé à l'API comme référence keywords CSOC<id>)
contactIdNoFiltrer par ID contact (envoyé à l'API comme référence keywords CCON<id>)
productIdNoFiltrer par ID produit (envoyé à l'API comme référence keywords PROD<id>)
resourceIdNoFiltrer par ID ressource (envoyé à l'API comme référence keywords COMP<id>)
candidateIdNoFiltrer par ID candidat (envoyé à l'API comme référence keywords CAND<id>)
opportunityIdNoFiltrer par ID opportunité (envoyé à l'API comme référence keywords AO<id>)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv2.12.2
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
  2. Changed1 schema field changedv2.9.0
    • addedInput schema / properties / fields
      Added value: +{
+  "description": "Projection : attributs à afficher par résultat (ex: ['title','updateDate']). Absent = résumé standard. Noms inconnus ignorés.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
  3. Changed8 schema fields changedv2.7.0
    • changedInput schema / properties / candidateId / description
      Previous value: -"Filtrer par ID candidat"New value: +"Filtrer par ID candidat (envoyé à l'API comme référence keywords CAND<id>)"
    • addedInput schema / properties / companyId
      Added value: +{
+  "description": "Filtrer par ID société (envoyé à l'API comme référence keywords CSOC<id>)",
+  "type": "string"
+}
    • addedInput schema / properties / contactId
      Added value: +{
+  "description": "Filtrer par ID contact (envoyé à l'API comme référence keywords CCON<id>)",
+  "type": "string"
+}
    • changedInput schema / properties / keywords / description
      Previous value: -"Mots-clés de recherche"New value: +"Mots-clés de recherche. L'API y accepte aussi des références d'entités (AO<id>, CAND<id>, COMP<id>...) — les filtres *Id ci-dessous sont convertis automatiquement en de telles références."
    • changedInput schema / properties / opportunityId / description
      Previous value: -"Filtrer par ID opportunité"New value: +"Filtrer par ID opportunité (envoyé à l'API comme référence keywords AO<id>)"
    • addedInput schema / properties / productId
      Added value: +{
+  "description": "Filtrer par ID produit (envoyé à l'API comme référence keywords PROD<id>)",
+  "type": "string"
+}
    • removedInput schema / properties / projectId
      Removed value: -{
-  "description": "Filtrer par ID projet",
-  "type": "string"
-}
    • changedInput schema / properties / resourceId / description
      Previous value: -"Filtrer par ID ressource"New value: +"Filtrer par ID ressource (envoyé à l'API comme référence keywords COMP<id>)"
  4. First observedv2.1.0

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint:false. The description adds non-obvious behavior: the API has no dedicated filter parameters, filtering requires keyword references (AO<id>, CAND<id>, etc.), and `fields` is a client-side projection never sent to the API. 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.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections (purpose, when, alternative, API constraint, args, returns, fields note). Every sentence adds value; there is no filler. It is slightly redundant with the schema in the Args block, but remains organized and front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, alternatives, parameter semantics, and field projection, but the return value is only described as 'Liste des positionnements correspondants'. With no output schema, it does not describe the standard summary format or the shape of each positioning result, leaving an agent uncertain about what it will receive.

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 coverage is 100%, so the baseline is 3. The description adds the reference mapping (AO, CAND, COMP, CSOC, CCON, PROD) and clarifies that *Id filters are automatically converted to keyword references. It also explains that `fields` is an MCP-side projection, not transmitted to the API, which goes beyond the schema's per-parameter text.

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 the specific action 'Recherche des positionnements' and defines the resource (placement de candidats/ressources sur des projets/opportunités). It explicitly contrasts with per-entity siblings by naming 'boond_candidates_positionings', 'boond_opportunities_positionings', and 'boond_resources_positionings', so an agent can distinguish it at a glance.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit 'Quand' (track candidate progress across multiple deals) and 'Plutôt que' (use the entity-specific positionings tabs when starting from a known entity) sections. This gives clear when-to-use vs alternative guidance, rare for tool descriptions.

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

Deploy Server

Other Tools