axiom_graph_list

axiom_graph.mcp.server.axiom_graph_list(project_root, node_type=None, tag=None, parent_id=None, location=None, max_results=60, offset=0)

List nodes, optionally filtered by node_type, tag, parent_id, or location.

To list all functions in a file, pass location – e.g. location="snakemake_gen.py" returns every node whose source location contains that substring. This collapses the common two-step pattern (search for node ID -> list children) into a single call. Combine with node_type to restrict to functions only.

To list all functions inside a module by ID, pass parent_id – e.g. parent_id="pm_mvp::pm.method" returns every function defined in that module via one-hop composes edges. This is faster and more precise than axiom_graph_graph for simple child enumeration.

Output always starts with a [N of M results] header line. Results are capped at max_results (default 60) to prevent accidental full-project dumps. Raise max_results explicitly if you need more.

Parameters:

project_root str

Absolute path to the indexed project.

node_type str | None

e.g. atomic_process (functions/methods) or composite_process (modules). Aliases "function" and "module" are also accepted.

tag str | None

Only return nodes with this tag.

parent_id str | None

If provided, return only the direct children of this node (one-hop composes edges). Useful for listing all functions in a module without reading the file. Tags are ignored when parent_id is set.

location str | None

File path substring filter. Any node whose level_3_location contains this string is included.

max_results int

Maximum rows returned (default 60). The count header always shows total before the cap.

offset int

Starting index for pagination (default 0).

Return type:

str