list_graphs
Retrieve and filter knowledge graphs to obtain graph IDs and node information for subsequent operations like adding edges or querying node details.
Instructions
List all knowledge graphs with support for filtering by status and type. This is the main tool for getting information about existing graphs and an important path for obtaining node IDs. Use cases:
View all available graphs and their basic information
Get the node list of a specific graph for subsequent edge addition or node detail queries
Filter graphs by status, such as viewing all drafts or published graphs
Filter graphs by type, such as viewing only topology or timeline graphs
Usage recommendations:
First call this tool to get the graph list and node information
Get the required graph ID and node ID from the returned data
Use these IDs to call other tools (like add_edge, get_node_details)
Recommended to use this tool to confirm the target graph's status before performing any node or edge operations
Return data:
data: List of graphs, each graph contains:
id: Graph ID (used for graphId parameter in other tools)
name: Graph name
description: Graph description
type: Graph type
status: Graph status
nodesCount: Number of nodes
edgesCount: Number of edges
createdAt: Creation time
updatedAt: Update time
publishedAt: Publication time (if published)
nodes: Node list, each node contains:
id: Node ID (used for add_edge and get_node_details tools)
name: Node name
type: Node type
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Graph status filter: - draft: Draft status, can be freely modified - published: Published status, recommended to track changes through version management - archived: Archived status, modifications not recommended | |
| type | No | Graph type filter: - topology: Component topology diagram - timeline: Timeline graph - changelog: Change log graph - requirement: Requirement documentation graph - knowledge_base: Knowledge base graph - ontology: Ontology graph |