ontologie

---

title: Ontologie sidebar_label: Ontologie (65) sidebar_position: 1 doc_type: reference

Ontologie

En bref

Interrogez, creez et naviguez dans votre modele metier.

Prerequis

• Cle API avec le preset MCP et les scopes requis
• Client MCP configure (voir Configuration)

Exemples minimaux

Decouvrir et rechercher dans votre ontologie

1. Listez vos espaces disponibles :

{
  "name": "ontology_list_espaces",
  "arguments": {}
}

2. Recherchez des entites par mot-cle :

{
  "name": "ontology_search",
  "arguments": {
    "query": "fournisseur",
    "limit": 10
  }
}

3. Consultez les details d'une entite :

{
  "name": "ontology_get_node",
  "arguments": {
    "nodeId": "uuid-de-lentite"
  }
}

---

Decouverte

ontology_list_espaces

Liste les espaces (canvas) disponibles dans votre workspace. Point d'entree ideal pour decouvrir votre ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
includeNodeCounts	boolean	Non	Include the count of nodes in each espace (defaut : true)
limit	number	Non	Maximum number of espaces to return (defaut : 50)
status	choix (active, archived, all)	Non	Filter by espace status (defaut : "active")

Reponse

Champ	Type	Description
espaces	array
defaultEspaceId	string
defaultEspaceName	string
total	number

Exemple

{
  "name": "ontology_list_espaces",
  "arguments": {}
}

Astuce : Utilisez le defaultEspaceId de la reponse pour les autres outils ontologie.

Outils lies : ontology_describe, ontology_query_nodes

---

ontology_describe

Resume la structure de votre ontologie : types d'entites, relations, statistiques.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
espaceId	string (uuid)	Non	Identifiant de l'espace a decrire
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
format	choix (summary, detailed, statistics)	Non	Format de sortie (summary ou detailed) (defaut : "summary")
includeTopEntities	number	Non	Number of top entities to include in the summary (defaut : 10)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
isDefault	boolean
wasAutoResolved	boolean
statistics	object
totalNodes	number
objectTypeCount	number
linkTypeCount	number
edgeCount	number
topObjectTypes	array
displayName	string
description	string
connectionCount	number
topLinkTypes	array
usageCount	number
edgeTypes	array
type	string
count	number
businessDescription	string

Exemple

{
  "name": "ontology_describe",
  "arguments": {
    "format": "summary"
  }
}

Outils lies : ontology_query_nodes, ontology_get_node, ontology_analyze_schema

---

Requetes

ontology_query_nodes

Recherche et filtre les entites de votre ontologie par type, nom ou proprietes.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
limit	number	Non	Nombre maximum de resultats (max : 100) (defaut : 100)
nodeType	choix (ObjectType, LinkType)	Non	Type d'entite a filtrer (ObjectType, LinkType)
offset	number	Non	Decalage pour la pagination (defaut : 0)
search	string	Non	Search nodes by name (case-insensitive)
status	choix (active, draft, archived, all)	Non	Filter by status (defaut : "active")

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
nodes	array
total	number
hasMore	boolean

Exemple

{
  "name": "ontology_query_nodes",
  "arguments": {
    "nodeType": "ObjectType",
    "limit": 20
  }
}

Outils lies : ontology_get_node, ontology_get_neighbors, ontology_search

---

ontology_query_edges

Liste les relations (liens) entre entites avec filtres optionnels.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
edgeType	string	Non	Filter by edge type (e.g., "belongs_to", "references")
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
includeNodeNames	boolean	Non	Include source/target node names in results (defaut : true)
limit	number	Non	Nombre maximum de resultats (max : 100) (defaut : 100)
nodeId	string	Non	Filter edges connected to this node (either as source or target)
offset	number	Non	Decalage pour la pagination (defaut : 0)
sourceId	string	Non	Identifiant de l'entite source
targetId	string	Non	Identifiant de l'entite cible

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
edges	array
total	number
hasMore	boolean

Exemple

{
  "name": "ontology_query_edges",
  "arguments": {
    "limit": 20
  }
}

Outils lies : ontology_get_neighbors, ontology_traverse, ontology_get_edge_properties

---

ontology_search

Recherche en texte integral dans les entites de votre ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
query	string	Oui	Terme de recherche en texte integral
espaceId	string (uuid)	Non	Espace/canvas ID (optional, auto-resolves to default)
espaceName	string	Non	Alternative: espace name
includeProperties	boolean	Non	Include property details in results (defaut : false)
limit	number	Non	Nombre maximum de resultats (max : 100) (defaut : 20)
nodeType	choix (ObjectType, LinkType)	Non	Filtrer par type d'entite
offset	number	Non	Decalage pour la pagination (defaut : 0)

Reponse

Champ	Type	Description
results	array
total	number
took	number
query	string

Exemple

{
  "name": "ontology_search",
  "arguments": {
    "query": "fournisseur",
    "limit": 10
  }
}

Outils lies : ontology_get_node, ontology_get_neighbors, ontology_explain_search

---

ontology_semantic_query

Recherche semantique en langage naturel dans votre ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
query	string	Oui	Question ou phrase en langage naturel
espaceId	string (uuid)	Non	Filter to a specific espace/canvas
includeExplanation	boolean	Non	Include step-by-step query explanation (defaut : true)
maxResults	number	Non	Maximum number of entity results (defaut : 20)

Reponse

Champ	Type	Description
answer	string
entities	array
id	string
name	string
type	string
properties	record
relationships	array
sourceId	string
targetId	string
explanation	string
metadata	object
totalTimeMs	number
entitiesFound	number

Exemple

{
  "name": "ontology_semantic_query",
  "arguments": {
    "query": "Quels sont les types de contrats ?"
  }
}

Outils lies : ontology_query_nodes, ontology_search, ontology_traverse

---

ontology_explain_search

Explique le scoring et le classement des resultats de recherche.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
query	string	Oui	The search query to analyze (min 2 characters)
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
nodeId	string (uuid)	Non	Specific node ID to explain (if omitted, explains top results)
topK	number	Non	Number of top results to explain (defaut : 5)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
query	string
explanations	array
searchConfig	object
usesTsvector	boolean
weightedScoring	boolean
prefixMatchingEnabled	boolean
suggestions	array

Outils lies : ontology_search, ontology_get_node

---

CRUD Noeuds

ontology_get_node

Recupere les details complets d'une entite par son identifiant ou son nom.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
nodeId	string (uuid)	Non	Identifiant unique de l'entite
nodeName	string	Non	Node name to retrieve (alternative to nodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean

Exemple

{
  "name": "ontology_get_node",
  "arguments": {
    "nodeId": "uuid-de-lentite"
  }
}

Outils lies : ontology_get_neighbors, ontology_query_nodes, ontology_get_property_schema

---

ontology_create_node

Cree une nouvelle entite (ObjectType ou LinkType) dans l'ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
name	string	Oui	Nom de la nouvelle entite
position	object	Oui
type	choix (ObjectType, LinkType)	Oui	Type d'entite a creer (ObjectType ou LinkType)
x	number	Oui
color	string	Non	Node color (hex)
description	string	Non	Description of the node
displayName	string	Non	Human-readable display name
espaceId	string (uuid)	Non	Identifiant de l'espace cible
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
icon	string	Non	Icon name
properties	array	Non	Proprietes de l'entite (objet cle-valeur)
y	number	Non	Position on canvas

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
success	boolean
nodeId	string
type	string
version	number

Exemple

{
  "name": "ontology_create_node",
  "arguments": {
    "type": "ObjectType",
    "name": "Fournisseur",
    "properties": {
      "description": "Entite representant un fournisseur"
    }
  }
}

Outils lies : ontology_update_node, ontology_delete_node, ontology_get_node

---

ontology_update_node

Met a jour les proprietes d'une entite existante.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
position	object	Oui
updates	object	Oui
x	number	Oui
color	string	Non
description	string	Non
displayName	string	Non
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
expectedVersion	number	Non	Expected version for OCC (optional)
icon	string	Non	Fields to update
name	string	Non
nodeId	string (uuid)	Non	Identifiant de l'entite a modifier
nodeName	string	Non	Node name to update (alternative to nodeId, case-insensitive)
properties	array	Non	Nouvelles proprietes (fusion avec l'existant)
status	choix (active, draft, archived)	Non
y	number	Non

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
success	boolean
nodeId	string
version	number
updatedFields	array

Outils lies : ontology_get_node, ontology_create_node, ontology_delete_node

---

ontology_delete_node

Supprime une entite de l'ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
cascade	boolean	Non	Also delete connected edges (default: true to prevent orphan edges) (defaut : true)
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
nodeId	string (uuid)	Non	Node ID to delete
nodeName	string	Non	Node name to delete (alternative to nodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
success	boolean
nodeId	string
deletedEdges	number

Outils lies : ontology_get_node, ontology_get_neighbors, ontology_impact_analysis

---

CRUD Relations

ontology_create_edge

Cree une relation entre deux entites.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
edgeType	string	Oui	Type/name of the relationship (e.g., "belongs_to", "references", "owns")
displayName	string	Non	Human-readable display name for the relationship
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
sourceNodeId	string (uuid)	Non	Source node UUID
sourceNodeName	string	Non	Source node name (alternative to sourceNodeId, case-insensitive)
targetNodeId	string (uuid)	Non	Target node UUID
targetNodeName	string	Non	Target node name (alternative to targetNodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
success	boolean
edgeId	string
edgeType	string
source	object
target	object
version	number

Outils lies : ontology_update_edge, ontology_delete_edge, ontology_get_edge_properties

---

ontology_update_edge

Met a jour les proprietes d'une relation existante.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
edgeId	string	Oui	Edge ID to update
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
success	boolean
edgeId	string
previousVersion	number
newVersion	number
updatedFields	array

Outils lies : ontology_create_edge, ontology_delete_edge, ontology_get_edge_properties

---

ontology_delete_edge

Supprime une relation entre entites.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
edgeId	string	Oui	Edge ID to delete
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
force	boolean	Non	Skip confirmation warnings (e.g., for cascade effects) (defaut : false)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
success	boolean
edgeId	string
deletedEdgeType	string
source	object
target	object
canUndo	boolean

Outils lies : ontology_create_edge, ontology_update_edge, ontology_impact_analysis

---

ontology_get_edge_properties

Recupere les proprietes detaillees d'une relation (cardinalite, cascade).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
edgeId	string	Non	Specific edge ID to retrieve properties for
edgeType	string	Non	Filter by edge/relationship type (e.g., "belongs_to", "references")
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
limit	number	Non	Maximum results to return (defaut : 50)
sourceNodeId	string (uuid)	Non	Filter edges originating from this node
sourceNodeName	string	Non	Filter edges originating from node with this name (case-insensitive)
targetNodeId	string (uuid)	Non	Filter edges pointing to this node
targetNodeName	string	Non	Filter edges pointing to node with this name (case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
edges	array
total	number
summary	object
totalEdges	number
cardinalityDistribution	record
cascadeDeleteCount	number
bidirectionalCount	number
withConstraintsCount	number

Outils lies : ontology_query_edges, ontology_impact_analysis, ontology_get_property_schema

---

Navigation graphe

ontology_get_neighbors

Liste les entites directement connectees a une entite donnee (entrants et sortants).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
direction	choix (in, out, both)	Non	Direction des relations (in, out, both) (defaut : "both")
edgeTypes	array	Non	Filter by specific edge types (e.g., ["belongs_to", "references"])
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
limit	number	Non	Nombre maximum de voisins (defaut : 50)
nodeId	string	Non	Identifiant de l'entite centrale
nodeName	string	Non	Node name (alternative to nodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
inbound	array
outbound	array
stats	object
inCount	number
outCount	number
totalConnections	number
hasMoreInbound	boolean
hasMoreOutbound	boolean

Exemple

{
  "name": "ontology_get_neighbors",
  "arguments": {
    "nodeId": "uuid-de-lentite",
    "direction": "both"
  }
}

Outils lies : ontology_traverse, ontology_query_edges, ontology_get_node

---

ontology_traverse

Parcourt le graphe en largeur (BFS) depuis une entite avec limite de profondeur.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
direction	choix (in, out, both)	Non	Direction of edges to follow: in, out, or both (defaut : "both")
edgeTypes	array	Non	Filter by specific edge types
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
includeProperties	boolean	Non	Include node properties in output (increases response size) (defaut : false)
maxDepth	number	Non	Maximum traversal depth (1-5, default: 2) (defaut : 2)
maxNodes	number	Non	Maximum total nodes to return (safety limit) (defaut : 100)
startNodeId	string	Non	Starting node ID for traversal
startNodeName	string	Non	Starting node name (alternative to startNodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
graph	object
nodes	array
edges	array
paths	array
stats	object
nodesVisited	number
edgesTraversed	number
maxDepthReached	number
truncated	boolean

Outils lies : ontology_get_neighbors, ontology_find_path, ontology_analyze_schema

---

ontology_find_path

Trouve le chemin le plus court entre deux entites du graphe.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
algorithm	choix (bfs, dijkstra)	Non	Algorithm: bfs (shortest hop count) or dijkstra (minimum weight) (defaut : "bfs")
direction	choix (out, in, both)	Non	Direction of edges to follow (defaut : "both")
edgeTypes	array	Non	Filter by specific edge types
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
findAllPaths	boolean	Non	If true, find all paths up to maxPaths (slower) (defaut : false)
maxDepth	number	Non	Maximum path length (1-10, default: 5) (defaut : 5)
maxNodesExplored	number	Non	Safety limit: max nodes to explore before stopping (100-50000, default: 10000) (defaut : 10000)
maxPaths	number	Non	Maximum number of paths to return when findAllPaths=true (defaut : 5)
sourceNodeId	string (uuid)	Non	Source node UUID
sourceNodeName	string	Non	Source node name (alternative to sourceNodeId, case-insensitive)
targetNodeId	string (uuid)	Non	Target node UUID
targetNodeName	string	Non	Target node name (alternative to targetNodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
found	boolean
paths	array
stats	object
algorithm	enum
nodesExplored	number
edgesExplored	number
executionTimeMs	number
pathsFound	number
shortestPathLength	number
hitExplorationLimit	boolean

Outils lies : ontology_traverse, ontology_impact_analysis, ontology_get_neighbors

---

ontology_reference_graph

Recupere le graphe de references entre types d'entites.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
sourceId	string (uuid)	Oui	ID of the ontology element
sourceType	choix (objectType, linkType, property, interface, sharedProperty, action)	Oui	Type of ontology element
changeType	choix (rename, delete, modify_type, add_required, remove, deprecate)	Non	If provided, calculates impact severity for this change type

Reponse

Champ	Type	Description
consumers	array
impact	object
items	array
summary	object
totalConsumers	number
breakingCount	number
riskyCount	number
safeCount	number

Outils lies : ontology_impact_analysis, ontology_get_node, ontology_describe

---

Schemas et proprietes

ontology_get_property_schema

Recupere le schema de proprietes avec regles de validation pour un type d'entite.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
includeMetadata	boolean	Non	Include metadata flags (indexable, searchable, sortable) (defaut : true)
includeTags	boolean	Non	Include property tags (pii, encrypted, sensitive) (defaut : true)
includeValidation	boolean	Non	Include validation rules (format, min, max, pattern) (defaut : true)
nodeId	string (uuid)	Non	Node ID to retrieve schema for
nodeName	string	Non	Node name to retrieve schema for (alternative to nodeId, case-insensitive)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
nodeId	string
nodeName	string
nodeDisplayName	string
nodeType	string
properties	array
summary	object
totalProperties	number
requiredCount	number
uniqueCount	number
computedCount	number
withValidationCount	number
piiTaggedCount	number
indexableCount	number

Outils lies : ontology_get_node, ontology_analyze_schema, ontology_get_edge_properties

---

ontology_analyze_schema

Analyse approfondie de la structure du schema de l'ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
analyzePatterns	boolean	Non	Analyze graph patterns (hubs, leaves, potential cycles) (defaut : true)
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
focus	string	Non	Focus on a specific node name for detailed analysis
includeUsageStats	boolean	Non	Include instance counts and relationship usage statistics (defaut : true)
nodeType	choix (ObjectType, LinkType, all)	Non	Filter by node type (default: all) (defaut : "all")

Reponse

Champ	Type	Description
espace	object
id	string
name	string
isDefault	boolean
wasAutoResolved	boolean
nodeTypes	array
recommendations	array

Outils lies : ontology_describe, ontology_traverse, ontology_get_property_schema

---

ontology_value_types

Liste les types de valeurs disponibles pour les proprietes.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
operation	choix (list, get)	Oui	Operation to perform
category	string	Non	Filter by category (e.g. "text", "numeric", "temporal")
limit	number	Non	Max results (for list) (defaut : 50)
search	string	Non	Search filter on name/description
valueTypeId	string (uuid)	Non	Value type ID (required for get)

Reponse

Champ	Type	Description
operation	string
valueType	object
id	string
name	string
displayName	string
description	string
baseType	string
constraints	record
formatting	record
examples	array
category	string
version	number
status	string
valueTypes	array
typeSource	string
total	number

Outils lies : ontology_get_property_schema, ontology_get_node, ontology_describe

---

ontology_computed_properties

Recupere les proprietes calculees d'une entite.

Scope	mcp.read
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
objectTypeId	string (uuid)	Oui	ObjectType ID
operation	choix (list, create, evaluate)	Oui	Operation to perform
computationType	choix (formula, aggregation)	Non	Computation type (required for create)
dataType	string	Non	Data type of the computed value (required for create)
description	string	Non	Property description
entityInstanceId	string (uuid)	Non	Entity instance to evaluate against (required for evaluate)
formula	string	Non	Formula expression (for create with formula type)
name	string	Non	Property name (required for create)
propertyId	string (uuid)	Non	Computed property ID (required for evaluate)

Reponse

Champ	Type	Description
operation	string
properties	array
id	string
name	string
displayName	string
dataType	string
computationType	string
formula	string
status	string
dependsOnProperties	array
created	object
evaluation	object
value	unknown
cached	boolean
durationMs	number
errors	array

Outils lies : ontology_get_property_schema, ontology_get_node, ontology_update_node

---

Donnees d'entites

ontology_query_entity_data

Interroge les donnees metier stockees dans les instances d'entites.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
entityId	string (uuid)	Oui	UUID of the ontology entity (node) to query data for
limit	number	Non	Number of records to return (default: 50, max: 500) (defaut : 50)
offset	number	Non	Pagination offset (default: 0) (defaut : 0)
streamId	string (uuid)	Non	Filter to a specific stream if the entity has multiple linked streams

Reponse

Champ	Type	Description
records	array
columns	array
streamInfo	object
streamId	string
streamName	string
tableName	string
displayLabel	string
groupLabel	string
sourceId	string
sourceName	string
sourceType	string
availableStreams	array
total	number
pagination	object
limit	number
offset	number
hasMore	boolean

Outils lies : ontology_entity_data_schema, ontology_get_node, ontology_write_entity_data

---

ontology_entity_data_schema

Recupere le schema de donnees d'un type d'entite.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
entityId	string (uuid)	Oui	UUID of the ontology entity (node) to get schema for
streamId	string (uuid)	Non	Filter to a specific stream if the entity has multiple linked streams

Reponse

Champ	Type	Description
columns	array
name	string
type	string
nullable	boolean
streamInfo	object
streamId	string
streamName	string
tableName	string
sourceId	string
sourceName	string
sourceType	string
availableStreams	array
displayLabel	string

Outils lies : ontology_query_entity_data, ontology_write_entity_data, ontology_get_node

---

ontology_write_entity_data

Ecrit des donnees metier dans une instance d'entite.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
entityId	string (uuid)	Oui	UUID of the ontology entity (node) to write data for
operation	choix (create, update, delete)	Oui	Operation type: create, update, or delete
data	record	Non	Data to write (required for create/update). Keys are column names.
rowId	string	Non	Identifiant de ligne pour les operations de mise a jour ou suppression
streamId	string (uuid)	Non	Specific stream to target if entity has multiple linked streams

Reponse

Champ	Type	Description
success	boolean
operation	string
rowId	string
message	string
affectedRows	number

Outils lies : ontology_query_entity_data, ontology_entity_data_schema

---

Actions Kinetic

ontology_list_actions

Liste les actions Kinetic disponibles sur une entite.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
entityId	string (uuid)	Non	Filter actions for a specific entity. Omit to list all workspace actions.
espaceId	string (uuid)	Non	Filter actions for a specific espace (canvas).

Reponse

Champ	Type	Description
actions	array
count	number

Outils lies : ontology_execute_action, ontology_get_action, ontology_action_history

---

ontology_get_action

Recupere les details d'une action Kinetic specifique.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
actionId	string (uuid)	Oui	UUID of the Kinetic action to retrieve

Outils lies : ontology_list_actions, ontology_execute_action, ontology_action_history

---

ontology_execute_action

Execute une action Kinetic sur une entite.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
actionId	string (uuid)	Oui	UUID of the Kinetic action to execute
params	record	Non	Optional parameters to pass to the action

Reponse

Champ	Type	Description
success	boolean
executionId	string
status	string
output	unknown
error	string
durationMs	number

Outils lies : ontology_list_actions, ontology_get_action, ontology_action_history

---

ontology_action_history

Consulte l'historique d'execution des actions sur une entite.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
actionId	string (uuid)	Oui	UUID of the Kinetic action to get history for
limit	number	Non	Number of execution records to return (default: 20, max: 100) (defaut : 20)

Reponse

Champ	Type	Description
executions	array
count	number
actionId	string

Outils lies : ontology_get_action, ontology_execute_action, ontology_list_actions

---

Instances

ontology_list_instances

Liste les instances d'un type d'entite (Digital Twin).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
objectTypeId	string (uuid)	Oui	Object type ID to list instances for
limit	number	Non	Nombre maximum de resultats (defaut : 20)
offset	number	Non	Decalage pour la pagination (defaut : 0)

Reponse

Champ	Type	Description
instances	array
id	string
objectTypeId	string
displayName	string
data	record
createdAt	string
updatedAt	string
total	number
hasMore	boolean

---

ontology_get_instance

Recupere les details d'une instance specifique.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
instanceId	string (uuid)	Oui	The instance ID

Reponse

Champ	Type	Description
id	string
objectTypeId	string
displayName	string
data	record
version	number
externalId	string
createdAt	string
updatedAt	string

---

ontology_create_instance

Cree une nouvelle instance d'un type d'entite.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
data	record	Oui	Instance data (key-value pairs matching the object type schema)
objectTypeId	string (uuid)	Oui	Object type ID for the new instance
displayName	string	Non	Display name for the instance
externalId	string	Non	Optional external system ID

Reponse

Champ	Type	Description
id	string
objectTypeId	string
displayName	string
createdAt	string

---

ontology_update_instance

Met a jour une instance existante.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
instanceId	string (uuid)	Oui	Instance ID to update
data	record	Non	Updated data fields (merged with existing)
displayName	string	Non	Updated display name
expectedVersion	number	Non	Expected version for OCC (optimistic concurrency)

Reponse

Champ	Type	Description
id	string
version	number
updatedAt	string

---

ontology_delete_instance

Supprime une instance.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
instanceId	string (uuid)	Oui	Instance ID to delete

Reponse

Champ	Type	Description
id	string
deleted	boolean

---

ontology_search_instances

Recherche dans les instances d'un type d'entite.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
query	string	Oui	Search query to match against instance data fields
limit	number	Non	Nombre maximum de resultats (defaut : 20)
objectTypeId	string (uuid)	Non	Optional: narrow search to a specific object type
offset	number	Non	Decalage pour la pagination (defaut : 0)

Reponse

Champ	Type	Description
instances	array
id	string
objectTypeId	string
displayName	string
matchedField	string
matchedValue	string
createdAt	string
total	number
hasMore	boolean

---

Scenarios

ontology_create_scenario

Cree un scenario de simulation (what-if) sur l'ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
name	string	Oui	Scenario name
baseSnapshotId	string (uuid)	Non	Optional base snapshot to fork from
description	string	Non	Scenario description

Reponse

Champ	Type	Description
id	string
name	string
status	string
createdAt	string

---

ontology_list_scenarios

Liste les scenarios de simulation disponibles.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
limit	number	Non	Nombre maximum de resultats (defaut : 20)
offset	number	Non	Decalage pour la pagination (defaut : 0)
status	choix (draft, active, applied, discarded)	Non	Filter by status

Reponse

Champ	Type	Description
scenarios	array
id	string
name	string
description	string
status	string
mutationCount	number
createdBy	string
createdAt	string
total	number
hasMore	boolean

---

ontology_add_mutation

Ajoute une mutation a un scenario existant.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
entityId	string (uuid)	Oui	Entity ID to mutate
entityType	string	Oui	Type of entity to mutate (instance, node, edge)
operation	choix (create, update, delete)	Oui	Mutation operation
scenarioId	string (uuid)	Oui	Scenario ID
data	record	Non	Mutation data (for create/update)

Reponse

Champ	Type	Description
id	string
scenarioId	string
operation	string
createdAt	string

---

ontology_scenario_impact

Analyse l'impact d'un scenario sur l'ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
scenarioId	string (uuid)	Oui	Scenario ID to analyze

Reponse

Champ	Type	Description
scenarioId	string
scenarioName	string
totalMutations	number
impactSummary	object
creations	number
updates	number
deletions	number
affectedEntityTypes	array
mutations	array
id	string
entityType	string
entityId	string
operation	string

---

ontology_apply_scenario

Applique un scenario, rendant ses mutations permanentes.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
scenarioId	string (uuid)	Oui	Scenario ID to apply
dryRun	boolean	Non	Preview only without applying (defaut : false)

Reponse

Champ	Type	Description
scenarioId	string
applied	boolean
mutationsApplied	number
errors	array
status	string

---

ontology_compare_scenarios

Compare deux scenarios cote a cote.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
scenarioIds	array	Oui	Scenario IDs to compare (2-10)
objectTypeId	string (uuid)	Non	Filter comparison to specific object type

Reponse

Champ	Type	Description
scenarioIds	array
instances	array
instanceId	string
displayName	string
objectTypeId	string
diffs	array
overlap	object
total	number
modified	number
unique	record

---

Pipelines

ontology_list_pipelines

Liste les pipelines de traitement de l'ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
limit	number	Non	Nombre maximum de resultats (defaut : 20)
offset	number	Non	Decalage pour la pagination (defaut : 0)
status	choix (active, inactive, error, all)	Non	(defaut : "all")

Reponse

Champ	Type	Description
pipelines	array
id	string
name	string
sourceType	string
targetObjectTypeId	string
status	string
lastRunAt	string
createdAt	string
total	number
hasMore	boolean

---

ontology_get_pipeline

Recupere les details d'un pipeline specifique.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
pipelineId	string (uuid)	Oui	Pipeline ID

Reponse

Champ	Type	Description
id	string
name	string
sourceType	string
sourceConfig	record
targetObjectTypeId	string
fieldMappings	record
status	string
schedule	string
lastRunAt	string
createdAt	string
updatedAt	string

---

ontology_run_pipeline

Lance l'execution d'un pipeline.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
pipelineId	string (uuid)	Oui	Pipeline ID to execute
force	boolean	Non	Force execution even if already running (defaut : false)

Reponse

Champ	Type	Description
runId	string
pipelineId	string
status	string
startedAt	string

---

ontology_pipeline_status

Consulte le statut d'execution d'un pipeline.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
pipelineId	string (uuid)	Oui	Pipeline ID
runId	string (uuid)	Non	Specific run ID (omit for latest)

Reponse

Champ	Type	Description
runId	string
pipelineId	string
pipelineName	string
status	string
startedAt	string
completedAt	string
recordsProcessed	number
errorCount	number
triggeredBy	string

---

ontology_create_pipeline

Cree un nouveau pipeline de traitement.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
blocks	array	Oui	Pipeline blocks (nodes)
name	string	Oui	Pipeline name
scheduleConfig	object	Oui
connections	array	Non	Connections between blocks (edges)
cron_expression	string	Non	Schedule configuration
description	string	Non	Pipeline description
trigger	choix (manual, on_sync, cron)	Non	(defaut : "manual")

Reponse

Champ	Type	Description
pipelineId	string
name	string
blockCount	number
status	string

---

ontology_preview_pipeline_block

Previsualise le resultat d'un bloc de pipeline sans l'executer.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
blockId	string	Oui	Block ID to preview data at
pipelineId	string (uuid)	Oui	Pipeline ID
limit	number	Non	Max rows to return (default 100) (defaut : 100)

Reponse

Champ	Type	Description
blockId	string
rowCount	number
schema	array
name	string
type	string
sampleRows	array
warnings	array

---

Templates

ontology_list_templates

Liste les templates d'ontologie disponibles.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
category	string	Non	Filter by template category
limit	number	Non	Nombre maximum de resultats (defaut : 20)

Reponse

Champ	Type	Description
templates	array
id	string
name	string
description	string
category	string
version	string
nodeCount	number
edgeCount	number
total	number

---

ontology_get_template

Recupere les details d'un template.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
templateId	string (uuid)	Oui	Template ID

Reponse

Champ	Type	Description
id	string
name	string
description	string
category	string
version	string
nodeCount	number
edgeCount	number
schema	record
createdAt	string

---

ontology_import_template

Importe un template dans votre ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
templateId	string (uuid)	Oui	Template ID to import
espaceId	string (uuid)	Non	Target espace (canvas) ID. If omitted, creates a new one.
prefix	string	Non	Optional prefix for imported node names

Reponse

Champ	Type	Description
templateId	string
templateName	string
espaceId	string
nodesImported	number
edgesImported	number
status	string

---

Vues sauvegardees

ontology_list_saved_views

Liste les vues sauvegardees de l'ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
objectTypeId	string (uuid)	Oui	Object type ID to list saved views for

Reponse

Champ	Type	Description
views	array
id	string
name	string
description	string
isDefault	boolean
columnCount	number
hasFilters	boolean
hasSorts	boolean
createdBy	string
createdAt	string
total	number

---

ontology_apply_saved_view

Applique une vue sauvegardee au canvas.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
viewId	string (uuid)	Oui	Saved view ID to apply
limit	number	Non	Nombre maximum de resultats (defaut : 20)
offset	number	Non	Decalage pour la pagination (defaut : 0)

Reponse

Champ	Type	Description
view	object
id	string
name	string
objectTypeId	string
columns	array
filters	record
sorts	array
field	string
order	string
instances	array
displayName	string
data	record
createdAt	string
updatedAt	string
total	number
hasMore	boolean

---

Simulation

ontology_generate_parametric

Genere un scenario parametrique avec variations automatiques.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
parameterValues	record	Oui	Parameter name-value pairs
templateId	string (uuid)	Oui	Parametric template ID
name	string	Non	Optional name for generated scenario

Reponse

Champ	Type	Description
scenarioId	string
mutationCount	number
templateName	string

---

ontology_run_simulation

Lance une simulation temporelle sur l'ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
action	object	Oui
condition	array	Oui
endDate	string	Oui	ISO 8601 end date
field	string	Oui
name	string	Oui
operator	string	Oui
rules	array	Oui
scenarioId	string (uuid)	Oui	Scenario to simulate
startDate	string	Oui	ISO 8601 start date
stepUnit	choix (day, week, month)	Oui	Time step unit
timeConfig	object	Oui
type	string	Oui
formula	string	Non
priority	number	Non	Simulation rules to evaluate at each step
target_field	string	Non
value	unknown	Non

Reponse

Champ	Type	Description
runId	string
status	string
totalSteps	number
currentStep	number

---

ontology_list_simulation_steps

Liste les etapes d'une simulation en cours.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
runId	string (uuid)	Oui	Simulation run ID
fromStep	number	Non	Start step index (inclusive)
toStep	number	Non	End step index (inclusive)

Reponse

Champ	Type	Description
runId	string
steps	array
stepIndex	number
stepTime	string
kpiValues	record
rulesFired	array
mutationsApplied	number
durationMs	number
totalSteps	number

---

ontology_execute_solver

Execute un solveur d'optimisation sur l'ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
solverId	string (uuid)	Oui	Solver definition ID to execute

Reponse

Champ	Type	Description
runId	string
status	string
bestObjectiveValue	number
constraintsSatisfied	number
constraintsViolated	number
mutationCount	number
durationMs	number
justification	string

---

ontology_apply_solver

Applique les resultats d'un solveur a l'ontologie.

Scope	mcp.write
Lecture seule	Non
Destructif	Non
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
runId	string (uuid)	Oui	Solver run ID to apply
scenarioName	string	Non	Optional name for the created scenario

Reponse

Champ	Type	Description
scenarioId	string
mutationCount	number

---

Export

ontology_export

Exporte l'ontologie au format YAML.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
espaceId	string (uuid)	Non	Export a specific espace (canvas). Omit for all espaces.
format	choix (json)	Non	Export format (defaut : "json")
includeInstances	boolean	Non	Include entity instances (can be large) (defaut : false)

Reponse

Champ	Type	Description
espaces	array
id	string
name	string
objectTypes	array
type	string
properties	array
espaceId	string
linkTypes	array
sourceId	string
targetId	string
totalNodes	number
totalEdges	number
exportedAt	string

Outils lies : ontology_describe, ontology_list_espaces, ontology_export_graphml, ontology_export_rdf

---

ontology_export_graphml

Exporte l'ontologie au format GraphML.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
filters	object	Oui
options	object	Oui
colorScheme	choix (category, status, monochrome)	Non	Color scheme for nodes (defaut : "category")
edgeTypes	array	Non	Filter to specific edge types
espaceId	string (uuid)	Non	Export a specific espace. Omit for default espace.
includePositions	boolean	Non	Include node canvas positions (defaut : true)
includeProperties	boolean	Non	Include node/edge properties in export (defaut : true)
nodeTypes	array	Non	Filter to specific node types
status	choix (active, inactive, all)	Non	Filter by node status (default: active) (defaut : "active")

Reponse

Champ	Type	Description
graphml	string
nodeCount	number
edgeCount	number
format	string

Outils lies : ontology_export_rdf, ontology_export, ontology_generate_docs

---

ontology_export_rdf

Exporte l'ontologie au format RDF/OWL.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
options	object	Oui
baseUri	string	Non	Base URI for RDF resources (default: http://dataforge.io)
espaceId	string (uuid)	Non	Export a specific espace. Omit for default espace.
format	choix (turtle, rdf-xml, n-triples, json-ld)	Non	RDF format (default: turtle) (defaut : "turtle")
includeMetadata	boolean	Non	Include generation metadata in output (defaut : true)

Reponse

Champ	Type	Description
rdf	string
format	string
tripleCount	number
nodeCount	number
edgeCount	number

Outils lies : ontology_export_graphml, ontology_export, ontology_generate_docs

---

ontology_generate_docs

Genere la documentation automatique de l'ontologie.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
options	object	Oui
espaceId	string (uuid)	Non	Generate docs for a specific espace. Omit for default.
format	choix (markdown, html, json)	Non	Output format (default: markdown) (defaut : "markdown")
includeExamples	boolean	Non	Include example queries (defaut : false)
includeSchema	boolean	Non	Include data schema section (defaut : true)
includeStatistics	boolean	Non	Include node/edge statistics (defaut : true)
language	choix (en, fr)	Non	Documentation language (defaut : "en")

Reponse

Champ	Type	Description
documentation	string
format	string
sections	array
nodeCount	number
edgeCount	number

Outils lies : ontology_export_graphml, ontology_export_rdf, ontology_describe

---

ontology_stats

Affiche les statistiques de l'ontologie (noeuds, relations, types).

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
espaceId	string (uuid)	Non	Get stats for a specific espace. Omit for workspace-level stats.
includeEspaceBreakdown	boolean	Non	Include per-espace breakdown in workspace stats (defaut : false)

Reponse

Champ	Type	Description
workspaceStats	object
totalEntities	number
totalObjectTypes	number
totalLinkTypes	number
avgPropertiesPerType	number
espaceCount	number
lastEntityUpdate	string
statsRefreshedAt	string
statusBreakdown	record
espaceStats	array
espaceId	string
objectTypesCount	number
linkTypesCount	number

Outils lies : ontology_describe, ontology_list_espaces

---

Historique

ontology_get_history

Consulte l'historique des modifications d'une entite.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
asOf	string	Non	ISO timestamp to get state at (e.g., "2024-01-15T10:30:00Z")
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
includeEvents	boolean	Non	Include list of events in response (defaut : true)
limit	number	Non	Maximum number of events to return (defaut : 50)
nodeId	string (uuid)	Non	Node ID to get history for
nodeName	string	Non	Node name (alternative to nodeId, case-insensitive)
sequenceNumber	number	Non	Event sequence number to get state at

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
node	object
currentVersion	number
events	array
stats	object
totalEvents	number
createdAt	string
lastModifiedAt	string
undoneEvents	number

Outils lies : ontology_get_node, ontology_query_nodes

---

ontology_impact_analysis

Analyse l'impact en cascade d'une modification sur les entites liees.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
direction	choix (downstream, upstream, both)	Non	Analysis direction: downstream (dependents), upstream (dependencies), or both (defaut : "downstream")
espaceId	string (uuid)	Non	Espace ID (optional - uses default espace if not provided)
espaceName	string	Non	Espace name (alternative to espaceId, case-insensitive)
includeEdgeDetails	boolean	Non	Include edge properties (cardinality, cascade rules) in output (defaut : true)
maxDepth	number	Non	Maximum cascade depth (1-10, default: 3) (defaut : 3)
maxNodesExplored	number	Non	Safety limit: max nodes to explore before stopping (100-50000, default: 5000) (defaut : 5000)
nodeId	string (uuid)	Non	Node UUID to analyze
nodeName	string	Non	Node name (alternative to nodeId, case-insensitive)
simulateDelete	boolean	Non	Simulate deletion to identify cascade deletes (defaut : true)

Reponse

Champ	Type	Description
espace	object
id	string
name	string
wasAutoResolved	boolean
downstream	array
upstream	array
summary	object
totalDownstream	number
totalUpstream	number
cascadeDeleteCount	number
criticalImpactCount	number
highImpactCount	number
mediumImpactCount	number
lowImpactCount	number
maxDepthReached	number
hitExplorationLimit	boolean
deletionSimulation	object
wouldDelete	array
wouldOrphan	array
wouldBreakRequired	array
totalAffected	number
recommendation	string

Outils lies : ontology_find_path, ontology_get_edge_properties, ontology_delete_node

---

---

Depannage

Code	Message	Solution
404	Espace non trouve	Verifiez l'identifiant avec ontology_list_espaces.
403	Scope insuffisant	Ajoutez le scope mcp.write a votre cle API.

Besoin d'aide ?

Ecrivez-nous : Support et contact.