Ontology

Overview

Query, create, and navigate your business model.

Prerequisites

API key with the MCP preset and required scopes
Configured MCP client (see Configuration)

Quick start examples

Discover and search your ontology

List your available espaces :

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

Search entities by keyword :

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

View entity details :

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

Discovery

`ontology_describe`

[DISCOVERY] Get a high-level business overview of an ontology structure.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`statistics`	object
`topObjectTypes`	object[]
`topLinkTypes`	object[]
`edgeTypes`	object[]
`businessDescription`	string

Example

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

Queries

`ontology_query_nodes`

[QUERY] Search and filter nodes (ObjectTypes, LinkTypes) in an ontology.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`nodes`	object[]
`total`	number
`hasMore`	boolean

Example

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

`ontology_query_edges`

[QUERY] Search and filter edges (relationships) between nodes in an ontology.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`edges`	object[]
`total`	number
`hasMore`	boolean

Example

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

`ontology_search`

[SEARCH] Full-text search across ontology entities and relations.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`results`	object[]
`total`	number
`took`	number
`query`	string

Example

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

`ontology_semantic_query`

[NL QUERY] Ask questions about the ontology in natural language.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`answer`	string
`entities`	object[]
`relationships`	object[]
`explanation`	string
`metadata`	object

Example

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

CRUD Nodes

`ontology_get_node`

[QUERY] Get complete details of a single node by ID or name.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`node`	object	null

Example

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

CRUD Relationships

`ontology_get_edge_properties`

[SCHEMA] Get detailed edge properties including cardinality, cascade rules, and constraints.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`edges`	object[]
`total`	number
`summary`	object

`ontology_get_neighbors`

[GRAPH] Get all neighbors of a node in a single efficient call.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Example

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

`ontology_traverse`

[GRAPH] Traverse the ontology graph from a starting node up to N levels deep.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`root`	object
`graph`	object
`paths`	object[]
`stats`	object

`ontology_find_path`

[GRAPH] Find shortest path(s) between two nodes in the ontology graph.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`found`	boolean
`source`	object
`target`	object
`paths`	object[]
`stats`	object

Schemas and Properties

`ontology_get_property_schema`

[SCHEMA] Get complete property schema of a node with validation rules, tags, and metadata.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`nodeId`	string
`nodeName`	string
`nodeDisplayName`	string
`nodeType`	string
`properties`	object[]
`summary`	object

`ontology_analyze_schema`

[ANALYSIS] Deep analysis of ontology schema: types, properties, patterns, metrics.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`summary`	object
`nodeTypes`	object[]
`patterns`	object
`recommendations`	string[]

`ontology_value_types`

[TYPES] Manage reusable value type definitions for property standardization.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`operation`	string
`valueType`	object
`valueTypes`	object[]
`total`	number

Kinetic Actions

`ontology_list_actions`

[DISCOVERY] List Kinetic actions (automations) attached to entities.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`actions`	object[]
`count`	number

`ontology_get_action`

[READ] Get detailed information about a specific Kinetic action, including execution stats.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`action`	object
`stats`	object

`ontology_action_history`

[READ] View the execution history for a Kinetic action.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`executions`	object[]
`count`	number
`actionId`	string

Instances

`ontology_list_instances`

List instances (records) of a given object type.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`instances`	object[]
`total`	number
`hasMore`	boolean

`ontology_get_instance`

Get full details of a specific object instance by ID.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`id`	string
`objectTypeId`	string
`displayName`	string	null
`data`	object
`version`	number
`externalId`	string	null
`createdAt`	string
`updatedAt`	string

`ontology_search_instances`

Search object instances by their JSONB data fields.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`instances`	object[]
`total`	number
`hasMore`	boolean

Export

`ontology_export`

[EXPORT] Export the ontology structure as JSON.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espaces`	object[]
`objectTypes`	object[]
`linkTypes`	object[]
`totalNodes`	number
`totalEdges`	number
`exportedAt`	string

`ontology_stats`

[STATS] Get ontology statistics: entity counts, type counts, property averages.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`workspaceStats`	object	null
`espaceStats`	object[]

History

`ontology_get_history`

[READ] Time-travel query: get historical state of a node at a specific point in time.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`node`	object
`historicalState`	object	null
`currentState`	object
`events`	object[]
`stats`	object

`ontology_impact_analysis`

[GRAPH] Analyze the impact of changing or deleting a node.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`espace`	object
`analyzedNode`	object
`downstream`	object[]
`upstream`	object[]
`summary`	object
`deletionSimulation`	object

Other

`context_pack`

[DISCOVER] Assemble bounded, LLM-ready context for a given query.


Scope	`mcp.read`
Read-only	Yes
Destructive	No
Idempotent	Yes

`df_plan_action`

[EXECUTE] Dry-run a business action — returns a signed plan artifact WITHOUT executing.


Scope	`mcp.plan.write`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`planId`	string
`planHash`	string
`canRun`	boolean
`canApply`	boolean
`applyBlockedReason`	string
`effects`	unknown[]
`blockedBy`	object[]
`risk`	string
`expiresAt`	string
`proof`	object

`df_plan_inspect`

[DISCOVERY] Inspect a plan artifact (signed mutation intent).


Scope	`mcp.plan.write`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`plan`	unknown

`df_plan_list`

[DISCOVERY] List plan artifacts in the workspace.


Scope	`mcp.plan.write`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`plans`	object[]
`count`	number

`df_plan_verify`

[ACTION] Verify if a plan artifact can be applied.


Scope	`mcp.plan.write`
Read-only	Yes
Destructive	No
Idempotent	Yes

Response

Field	Type	Description
`planId`	string
`canApply`	boolean
`checks`	object[]
`reasons`	object[]

Troubleshooting

Code	Message	Solution
404	Espace not found	Check the ID with `ontology_list_espaces`.
403	Insufficient scope	Add the `mcp.write` scope to your API key.

Need help?

Send feedback about this page

Overview​

Prerequisites​

Quick start examples​

Discover and search your ontology​

Discovery​

ontology_describe​

Queries​

ontology_query_nodes​

ontology_query_edges​

ontology_search​

ontology_semantic_query​

CRUD Nodes​

ontology_get_node​

CRUD Relationships​

ontology_get_edge_properties​

Graph Navigation​

ontology_get_neighbors​

ontology_traverse​

ontology_find_path​

Schemas and Properties​

ontology_get_property_schema​

ontology_analyze_schema​

ontology_value_types​

Kinetic Actions​

ontology_list_actions​

ontology_get_action​

ontology_action_history​

Instances​

ontology_list_instances​

ontology_get_instance​

ontology_search_instances​

Export​

ontology_export​

ontology_stats​

History​

ontology_get_history​

ontology_impact_analysis​

Other​

context_pack​

df_plan_action​

df_plan_inspect​

df_plan_list​

df_plan_verify​

Troubleshooting​

Need help?​

Overview

Prerequisites

Quick start examples

Discover and search your ontology

Discovery

`ontology_describe`

Queries

`ontology_query_nodes`

`ontology_query_edges`

`ontology_search`

`ontology_semantic_query`

CRUD Nodes

`ontology_get_node`

CRUD Relationships

`ontology_get_edge_properties`

Graph Navigation

`ontology_get_neighbors`

`ontology_traverse`

`ontology_find_path`

Schemas and Properties

`ontology_get_property_schema`

`ontology_analyze_schema`

`ontology_value_types`

Kinetic Actions

`ontology_list_actions`

`ontology_get_action`

`ontology_action_history`

Instances

`ontology_list_instances`

`ontology_get_instance`

`ontology_search_instances`

Export

`ontology_export`

`ontology_stats`

History

`ontology_get_history`

`ontology_impact_analysis`

Other

`context_pack`

`df_plan_action`

`df_plan_inspect`

`df_plan_list`

`df_plan_verify`

Troubleshooting

Need help?