Skip to main content
Glama
silamir

boondmanager-mcp-server

by silamir
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Rechercher des paiements

boond_payments_search
Read-onlyIdempotent

Search BoondManager supplier payments by purchase, company, project, resource, state, or date range. Returns paginated payment summaries; read-only.

Instructions

Recherche des paiements / règlements fournisseur dans BoondManager.

Quand : pour retrouver les règlements adossés à un achat, une société, un projet ou une ressource, ceux d'un état (paymentStates), d'une période (period: "expected" + dates) ou d'un périmètre (perimeter*). Plutôt que : boond_purchases_search pour les achats eux-mêmes, boond_provider_invoices_search pour les factures fournisseur.

  • purchaseId, companyId, projectId et resourceId sont convertis en préfixes keywords (ACH<id>, CSOC<id>, PRJ<id>, COMP<id>) et concaténés aux keywords fournis — l'API n'a pas de paramètre dédié. Pas de filtre par facture : /payments ne connaît pas de référence FACT<id>.

Returns : page de résumés des paiements (ID + libellé principal). Lecture seule.

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

  • Pagination : pageSize 1–500 (défaut 30), page 1–100 — au-delà : refus, affiner les filtres.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoNuméro de page (défaut: 1, max: 100)
sortNoChamp de tri (ex: lastName, firstName, updateDate)
flagsNoIDs de drapeaux (flags) — `boond_flags_search`.
orderNoOrdre de tri (asc/desc)
fieldsNoProjection : attributs ou relations (type#id) par résultat (ex: ['title','dependsOn']). Absent = résumé standard. Noms inconnus ignorés.
periodNoChamp de date borné par `startDate` / `endDate` : expected (échéance), performed (règlement effectif), created, updated, createdPurchase, subscription, billing.
endDateNoDate de fin (YYYY-MM-DD), à utiliser avec `period`.
keywordsNoMots-clés de recherche
pageSizeNoNombre de résultats par page (max: 500, défaut: 30)
companyIdNoFiltrer par ID société (référence keywords CSOC<id>)
contactIdNoFiltrer par ID contact (référence keywords CCON<id>)
projectIdNoFiltrer par ID projet (référence keywords PRJ<id>)
startDateNoDate de début (YYYY-MM-DD), à utiliser avec `period`.
purchaseIdNoFiltrer par ID achat (référence keywords ACH<id>)
resourceIdNoFiltrer par ID ressource (référence keywords COMP<id>)
paymentStatesNoIDs d'états de paiement — `boond://dictionary/states/payments`.
periodDynamicNoFenêtre relative appliquée à `period` (à la place de `startDate` / `endDate`) : today, thisWeek, thisMonth, lastMonth, thisYear, untilToday…
purchaseTypesNoIDs de types d'achat — `boond://dictionary/typeOf/purchases`.
paymentMethodsNoIDs de modes de paiement — `boond://dictionary/paymentMethods`.
perimeterPolesNoIDs de pôles. Conserve les entités dont le responsable appartient à ces pôles.
narrowPerimeterNoSi true, jointure ET entre les filtres `perimeter*` (au lieu de OU par défaut).
perimeterDynamicNoPérimètre dynamique relatif à l'utilisateur courant (raccourci sans avoir à connaître son propre ID). Valeurs : 'data' (mes propres données), 'managers' (mon équipe / mes N-1), 'agencies' (mes agences), 'poles' (mes pôles), 'businessUnits' (mes BU). Combinable.
deliveryPurchasesNotrue = paiements des achats liés à une prestation uniquement.
perimeterAgenciesNoIDs d'agences. Conserve les entités dont le responsable appartient à ces agences.
perimeterManagersNoIDs des managers (ressources). Conserve les entités dont le responsable est l'un de ces managers. Pour 'mon équipe / N-1 d'une personne X', passer [X_id]. Obtenir son propre ID via boond_application_current_user.
subscriptionTypesNoIDs de types d'abonnement (`setting.typeOf.subscription` via `boond_application_dictionary`).
excludeProviderInvoiceNotrue = exclure les paiements adossés à une facture fournisseur.
perimeterBusinessUnitsNoIDs de business units. Conserve les entités dont le responsable appartient à ces BU.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
countYesNombre d'éléments retournés sur cette page
itemsYes
totalNoNombre total de résultats côté BoondManager

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv2.18.0
    • changedInput schema / properties / fields / description
      Previous value: -"Projection : attributs à afficher par résultat (ex: ['title','updateDate']). Absent = résumé standard. Noms inconnus ignorés."New value: +"Projection : attributs ou relations (type#id) par résultat (ex: ['title','dependsOn']). Absent = résumé standard. Noms inconnus ignorés."
  2. Changed34 schema fields changedv2.17.0
    • changedInput schema / properties / companyId / description
      Previous value: -"Filtrer par ID société"New value: +"Filtrer par ID société (référence keywords CSOC<id>)"
    • addedInput schema / properties / companyId / pattern
      Added value: +"^\\d+$"
    • addedInput schema / properties / contactId
      Added value: +{
+  "description": "Filtrer par ID contact (référence keywords CCON<id>)",
+  "pattern": "^\\d+$",
+  "type": "string"
+}
    • addedInput schema / properties / deliveryPurchases
      Added value: +{
+  "description": "true = paiements des achats liés à une prestation uniquement.",
+  "type": "boolean"
+}
    • changedInput schema / properties / endDate / description
      Previous value: -"Date de fin (YYYY-MM-DD)"New value: +"Date de fin (YYYY-MM-DD), à utiliser avec `period`."
    • addedInput schema / properties / endDate / pattern
      Added value: +"^\\d{4}-\\d{2}-\\d{2}$"
    • addedInput schema / properties / excludeProviderInvoice
      Added value: +{
+  "description": "true = exclure les paiements adossés à une facture fournisseur.",
+  "type": "boolean"
+}
    • addedInput schema / properties / flags
      Added value: +{
+  "description": "IDs de drapeaux (flags) — `boond_flags_search`.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / invoiceId
      Removed value: -{
-  "description": "Filtrer par ID facture",
-  "type": "string"
-}
    • addedInput schema / properties / narrowPerimeter
      Added value: +{
+  "description": "Si true, jointure ET entre les filtres `perimeter*` (au lieu de OU par défaut).",
+  "type": "boolean"
+}
    • addedInput schema / properties / order
      Added value: +{
+  "description": "Ordre de tri (asc/desc)",
+  "enum": [
+    "asc",
+    "desc"
+  ],
+  "type": "string"
+}
    • changedInput schema / properties / page / description
      Previous value: -"Numéro de page (max: 100)"New value: +"Numéro de page (défaut: 1, max: 100)"
    • changedInput schema / properties / pageSize / description
      Previous value: -"Résultats par page"New value: +"Nombre de résultats par page (max: 500, défaut: 30)"
    • addedInput schema / properties / paymentMethods
      Added value: +{
+  "description": "IDs de modes de paiement — `boond://dictionary/paymentMethods`.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / paymentStates
      Added value: +{
+  "description": "IDs d'états de paiement — `boond://dictionary/states/payments`.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / perimeterAgencies
      Added value: +{
+  "description": "IDs d'agences. Conserve les entités dont le responsable appartient à ces agences.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / perimeterBusinessUnits
      Added value: +{
+  "description": "IDs de business units. Conserve les entités dont le responsable appartient à ces BU.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / perimeterDynamic
      Added value: +{
+  "description": "Périmètre dynamique relatif à l'utilisateur courant (raccourci sans avoir à connaître son propre ID). Valeurs : 'data' (mes propres données), 'managers' (mon équipe / mes N-1), 'agencies' (mes agences), 'poles' (mes pôles), 'businessUnits' (mes BU). Combinable.",
+  "items": {
+    "enum": [
+      "data",
+      "agencies",
+      "poles",
+      "businessUnits",
+      "managers"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / perimeterManagers
      Added value: +{
+  "description": "IDs des managers (ressources). Conserve les entités dont le responsable est l'un de ces managers. Pour 'mon équipe / N-1 d'une personne X', passer [X_id]. Obtenir son propre ID via boond_application_current_user.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / perimeterPoles
      Added value: +{
+  "description": "IDs de pôles. Conserve les entités dont le responsable appartient à ces pôles.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / period
      Added value: +{
+  "description": "Champ de date borné par `startDate` / `endDate` : expected (échéance), performed (règlement effectif), created, updated, createdPurchase, subscription, billing.",
+  "enum": [
+    "created",
+    "updated",
+    "createdPurchase",
+    "subscription",
+    "expected",
+    "performed",
+    "billing"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / periodDynamic
      Added value: +{
+  "description": "Fenêtre relative appliquée à `period` (à la place de `startDate` / `endDate`) : today, thisWeek, thisMonth, lastMonth, thisYear, untilToday…",
+  "enum": [
+    "today",
+    "yesterday",
+    "tomorrow",
+    "thisWeek",
+    "lastWeek",
+    "nextWeek",
+    "thisMonth",
+    "lastMonth",
+    "nextMonth",
+    "thisTrimester",
+    "lastTrimester",
+    "nextTrimester",
+    "thisSemester",
+    "lastSemester",
+    "nextSemester",
+    "thisYear",
+    "lastYear",
+    "nextYear",
+    "thisFiscalYear",
+    "lastFiscalYear",
+    "nextFiscalYear",
+    "untilToday"
+  ],
+  "type": "string"
+}
    • changedInput schema / properties / projectId / description
      Previous value: -"Filtrer par ID projet"New value: +"Filtrer par ID projet (référence keywords PRJ<id>)"
    • addedInput schema / properties / projectId / pattern
      Added value: +"^\\d+$"
    • changedInput schema / properties / purchaseId / description
      Previous value: -"Filtrer par ID achat"New value: +"Filtrer par ID achat (référence keywords ACH<id>)"
    • addedInput schema / properties / purchaseId / pattern
      Added value: +"^\\d+$"
    • addedInput schema / properties / purchaseTypes
      Added value: +{
+  "description": "IDs de types d'achat — `boond://dictionary/typeOf/purchases`.",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • changedInput schema / properties / resourceId / description
      Previous value: -"Filtrer par ID ressource"New value: +"Filtrer par ID ressource (référence keywords COMP<id>)"
    • addedInput schema / properties / resourceId / pattern
      Added value: +"^\\d+$"
    • addedInput schema / properties / sort
      Added value: +{
+  "description": "Champ de tri (ex: lastName, firstName, updateDate)",
+  "type": "string"
+}
    • changedInput schema / properties / startDate / description
      Previous value: -"Date de début (YYYY-MM-DD)"New value: +"Date de début (YYYY-MM-DD), à utiliser avec `period`."
    • addedInput schema / properties / startDate / pattern
      Added value: +"^\\d{4}-\\d{2}-\\d{2}$"
    • addedInput schema / properties / subscriptionTypes
      Added value: +{
+  "description": "IDs de types d'abonnement (`setting.typeOf.subscription` via `boond_application_dictionary`).",
+  "items": {
+    "maximum": 9007199254740991,
+    "minimum": -9007199254740991,
+    "type": "integer"
+  },
+  "type": "array"
+}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "count": {
+      "description": "Nombre d'éléments retournés sur cette page",
+      "type": "number"
+    },
+    "items": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "attributes": {
+            "additionalProperties": {},
+            "description": "Attributs projetés (présent si `fields` est fourni)",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "id": {
+            "type": "string"
+          },
+          "summary": {
+            "description": "Résumé standard (absent si `fields` est fourni)",
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "total": {
+      "description": "Nombre total de résultats côté BoondManager",
+      "type": "number"
+    }
+  },
+  "required": [
+    "count",
+    "items"
+  ],
+  "type": "object"
+}
  3. Changed1 schema field changedv2.12.2
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
  4. 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"
+}
  5. Changed3 schema fields changedv2.8.0
    • addedInput schema / properties / projectId
      Added value: +{
+  "description": "Filtrer par ID projet",
+  "type": "string"
+}
    • addedInput schema / properties / purchaseId
      Added value: +{
+  "description": "Filtrer par ID achat",
+  "type": "string"
+}
    • addedInput schema / properties / resourceId
      Added value: +{
+  "description": "Filtrer par ID ressource",
+  "type": "string"
+}
  6. First observedv2.1.0

TDQS

A4.8/5.0
Behavior5/5

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

Les annotations déclarent déjà readOnly/idempotent/non-destructif, mais la description ajoute des comportements non structurés : conversion des IDs en préfixes `keywords` (ACH/CSOC/PRJ/COMP), absence de filtre par facture, `fields` comme projection côté MCP jamais transmise à l'API, et refus de pagination au-delà des bornes. C'est un apport substantiel au-delà des 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?

Structure front-loadée avec des étiquettes (« Quand », « Plutôt que », « Returns ») puis des puces ciblées ; chaque phrase apporte une information opérationnelle. Le texte est dense mais reste proportionné à un outil à 28 paramètres.

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?

Un output schema existe, donc les valeurs de retour n'ont pas à être détaillées ; la description couvre néanmoins projection `fields`, bornes de pagination et sémantique des filtres convertis. L'agent dispose de tout le nécessaire pour appeler correctement l'outil.

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?

La couverture du schéma est de 100 %, donc le plancher serait 3 ; la description va plus loin en expliquant que `purchaseId`/`companyId`/`projectId`/`resourceId` sont concaténés aux `keywords` fournis car l'API n'a pas de paramètre dédié, et que `fields` projette côté MCP en ignorant les noms inconnus. Ces précisions dépassent le libellé du schéma.

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?

Il s'agit d'un verbe + ressource spécifiques (« Recherche des paiements / règlements fournisseur ») avec un périmètre clair. La description identifie explicitement les siblings voisins qu'elle n'est pas (`boond_purchases_search`, `boond_provider_invoices_search`), ce qui permet à un agent de choisir sans ouvrir les schémas.

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?

Sections « Quand : » et « Plutôt que : » nomment explicitement les alternatives et les conditions de sélection (par achat/société/projet/ressource, par état, par période, par périmètre). Rien n'est laissé à l'inférence.

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