Skip to content
Logo CodeGraphContext / Documentation
CodeGraphContext/CodeGraphContext
v0.5.0 3.2k 564
Home › Reference › MCP Input Schemas

Generated MCP tool catalog

Source package version: 0.6.13. Registered tools: 29.

Generated during each documentation build from tool_definitions.py. The connected server's tools/list is authoritative for its installed version and disabled-tool configuration.

See workflows and limitations before interpreting results. Schemas describe inputs; they do not certify backend feature parity.

add_code_to_graph

Performs a one-time scan of a local folder to add its code to the graph. Ideal for indexing libraries, dependencies, or projects not being actively modified. Returns a job ID for background processing.

Argument Required Type Default Description
repo_path yes string - Path to the repository root
is_dependency no boolean false Whether this code is a dependency.
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string",
      "description": "Path to the repository root"
    },
    "is_dependency": {
      "type": "boolean",
      "description": "Whether this code is a dependency.",
      "default": false
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "repo_path"
  ]
}

check_job_status

Check the status and progress of a background job.

Argument Required Type Default Description
job_id yes string - Job ID from a previous tool call

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job ID from a previous tool call"
    }
  },
  "required": [
    "job_id"
  ]
}

list_jobs

List all background jobs and their current status.

Argument Required Type Default Description

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {}
}

find_code

Find relevant code snippets related to a keyword (e.g., function name, class name, or content).

Argument Required Type Default Description
query yes string - Keyword or phrase to search for
fuzzy_search no boolean false Whether to use fuzzy search
edit_distance no number 2 Edit distance for fuzzy search (between 0-2)
repo_path no string - Optional: Path to the repository to restrict the search to.
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword or phrase to search for"
    },
    "fuzzy_search": {
      "type": "boolean",
      "description": "Whether to use fuzzy search",
      "default": false
    },
    "edit_distance": {
      "type": "number",
      "description": "Edit distance for fuzzy search (between 0-2)",
      "default": 2
    },
    "repo_path": {
      "type": "string",
      "description": "Optional: Path to the repository to restrict the search to."
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "query"
  ]
}

analyze_code_relationships

Analyze code relationships like 'who calls this function' or 'class hierarchy'.

Argument Required Type Default Description
query_type yes string -
target yes string - The primary query target (for example, a function name, class name, or 'start_func->end_func' for call chains). For find_functions_by_argument, use a parameter name or type.
context no string - Additional context parameter: acts as a file path for precise scoping or a numeric string (e.g., depth/limit) depending on the query type.
depth no integer - Optional traversal depth for transitive caller and callee queries (1-20).
repo_path no string - Optional repository path.
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "query_type": {
      "type": "string",
      "enum": [
        "find_callers",
        "find_callees",
        "find_all_callers",
        "find_all_callees",
        "find_importers",
        "who_modifies",
        "class_hierarchy",
        "overrides",
        "dead_code",
        "call_chain",
        "module_deps",
        "variable_scope",
        "find_complexity",
        "find_functions_by_argument",
        "find_functions_by_decorator"
      ]
    },
    "target": {
      "type": "string",
      "description": "The primary query target (for example, a function name, class name, or 'start_func->end_func' for call chains). For find_functions_by_argument, use a parameter name or type."
    },
    "context": {
      "type": "string",
      "description": "Additional context parameter: acts as a file path for precise scoping or a numeric string (e.g., depth/limit) depending on the query type."
    },
    "depth": {
      "type": "integer",
      "description": "Optional traversal depth for transitive caller and callee queries (1-20)."
    },
    "repo_path": {
      "type": "string",
      "description": "Optional repository path."
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "query_type",
    "target"
  ]
}

watch_directory

Continuously monitors a directory and keeps graph updated.

Argument Required Type Default Description
repo_path yes string - Path to repository root

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string",
      "description": "Path to repository root"
    }
  },
  "required": [
    "repo_path"
  ]
}

execute_cypher_query

Run a read-only Cypher query against the code graph. On Neo4j the statement is aborted after the execute_cypher_query ceiling (TOOL_QUERY_TIMEOUTS, default 300 s) and the answer is an error with timeout_s. Avoid unbounded variable-length patterns over CALLS ([:CALLS*1..n]): they are exponential in n; use analyze_code_relationships find_all_callers/find_all_callees/call_chain instead.

Argument Required Type Default Description
cypher_query yes string - The Cypher query to execute
params no object {} Optional named parameters passed to the Cypher query.
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "cypher_query": {
      "type": "string",
      "description": "The Cypher query to execute"
    },
    "params": {
      "type": "object",
      "description": "Optional named parameters passed to the Cypher query.",
      "default": {}
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "cypher_query"
  ]
}

add_package_to_graph

Add a package to the graph.

Argument Required Type Default Description
package_name yes string -
language yes string -
is_dependency no boolean true
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "package_name": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "enum": [
        "python",
        "javascript",
        "typescript",
        "java",
        "c",
        "go",
        "ruby",
        "php",
        "cpp"
      ]
    },
    "is_dependency": {
      "type": "boolean",
      "default": true
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "package_name",
    "language"
  ]
}

find_dead_code

Find potentially unused functions.

Argument Required Type Default Description
exclude_decorated_with no array []
repo_path no string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "exclude_decorated_with": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": []
    },
    "repo_path": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

calculate_cyclomatic_complexity

Calculate complexity of a function.

Argument Required Type Default Description
function_name yes string -
path no string - Optional file path to disambiguate the function.
repo_path no string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "function_name": {
      "type": "string"
    },
    "path": {
      "type": "string",
      "description": "Optional file path to disambiguate the function."
    },
    "repo_path": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "function_name"
  ]
}

find_most_complex_functions

Find most complex functions.

Argument Required Type Default Description
limit no integer 10
repo_path no string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10
    },
    "repo_path": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

list_indexed_repositories

List all indexed repositories.

Argument Required Type Default Description
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

delete_repository

DESTRUCTIVE AND IRREVERSIBLE. Permanently deletes a repository and every node and relationship belonging to it from the graph. There is no undo, and recovering the data requires a full re-index, which can take a long time on a large repository. Only call this when the user has explicitly asked for that repository to be removed.

Argument Required Type Default Description
repo_path yes string - The path of the repository to delete.
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string",
      "description": "The path of the repository to delete."
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "repo_path"
  ]
}

visualize_graph_query

Generate a Neo4j visualization URL for a Cypher query.

Argument Required Type Default Description
cypher_query yes string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "cypher_query": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "cypher_query"
  ]
}

list_watched_paths

List all watched directories.

Argument Required Type Default Description

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {}
}

unwatch_directory

Stop watching a directory.

Argument Required Type Default Description
repo_path yes string -

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string"
    }
  },
  "required": [
    "repo_path"
  ]
}

load_bundle

Load a pre-indexed graph bundle (.cgc) into the database. Note that clear_existing=True is DESTRUCTIVE AND IRREVERSIBLE — see its description before setting it.

Argument Required Type Default Description
bundle_name yes string - Name of the bundle to load from the registry, or a path to a local .cgc file.
clear_existing no boolean false DESTRUCTIVE AND IRREVERSIBLE. When true, the existing repository data is deleted from the graph before the bundle is imported — this discards previously indexed content, not just a previous copy of this bundle. Leave false unless the user has explicitly asked to replace what is already indexed.
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "bundle_name": {
      "type": "string",
      "description": "Name of the bundle to load from the registry, or a path to a local .cgc file."
    },
    "clear_existing": {
      "type": "boolean",
      "default": false,
      "description": "DESTRUCTIVE AND IRREVERSIBLE. When true, the existing repository data is deleted from the graph before the bundle is imported — this discards previously indexed content, not just a previous copy of this bundle. Leave false unless the user has explicitly asked to replace what is already indexed."
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  },
  "required": [
    "bundle_name"
  ]
}

search_registry_bundles

Search registry bundles.

Argument Required Type Default Description
query no string -
unique_only no boolean false

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "unique_only": {
      "type": "boolean",
      "default": false
    }
  }
}

get_repository_stats

Get repository statistics.

Argument Required Type Default Description
repo_path no string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

discover_codegraph_contexts

Discover .codegraphcontext folders.

Argument Required Type Default Description
repo_path no string -
max_depth no integer 1

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string"
    },
    "max_depth": {
      "type": "integer",
      "default": 1
    }
  }
}

switch_context

Switch active graph context. Refuses while any indexing job is PENDING or RUNNING — wait for check_job_status / list_jobs, then retry.

Argument Required Type Default Description
context_path yes string -
save no boolean true

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "context_path": {
      "type": "string"
    },
    "save": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "context_path"
  ]
}

list_graphs

List all available graphs in the FalkorDB instance. Each graph typically corresponds to an indexed repository. Use the graph names with the 'graph_name' parameter in other tools.

Argument Required Type Default Description

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {}
}

generate_report

Generate codegraph report.

Argument Required Type Default Description
output_path no string -
include_java no boolean false
god_node_limit no integer 15
complexity_limit no integer 15
cross_module_limit no integer 20

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "output_path": {
      "type": "string"
    },
    "include_java": {
      "type": "boolean",
      "default": false
    },
    "god_node_limit": {
      "type": "integer",
      "default": 15
    },
    "complexity_limit": {
      "type": "integer",
      "default": 15
    },
    "cross_module_limit": {
      "type": "integer",
      "default": 20
    }
  }
}

find_java_spring_endpoints

Find Spring endpoints.

Argument Required Type Default Description
http_method no string -
path_pattern no string -
repo_path no string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "http_method": {
      "type": "string"
    },
    "path_pattern": {
      "type": "string"
    },
    "repo_path": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

find_java_spring_beans

Find Spring beans.

Argument Required Type Default Description
stereotype no string -
repo_path no string -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "stereotype": {
      "type": "string",
      "enum": [
        "CONTROLLER",
        "REST_CONTROLLER",
        "SERVICE",
        "REPOSITORY",
        "COMPONENT",
        "CONFIGURATION"
      ]
    },
    "repo_path": {
      "type": "string"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

find_datasource_nodes

Query datasource nodes.

Argument Required Type Default Description
kind no string -
name no string -
include_columns no boolean -
graph_name no string - Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "mysql",
        "cassandra",
        "redis"
      ]
    },
    "name": {
      "type": "string"
    },
    "include_columns": {
      "type": "boolean"
    },
    "graph_name": {
      "type": "string",
      "description": "Optional: Name of the FalkorDB graph to query. Each indexed repository can have its own graph. Use 'list_graphs' to see available graphs. Defaults to the server's configured graph name."
    }
  }
}

simulate_metrics

Calculate repository architectural metrics (coupling, cohesion, circular dependencies, complexity, and maintainability).

Argument Required Type Default Description
repo_path no string - Path to the repository (defaults to current workspace).

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string",
      "description": "Path to the repository (defaults to current workspace)."
    }
  }
}

simulate_architectural_change

Simulate architectural modifications (service decomposition, adding/removing dependencies, deleting nodes) and compare metrics against the baseline.

Argument Required Type Default Description
repo_path no string - Path to the repository (defaults to current workspace).
changes yes array - List of simulation mutation steps.

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string",
      "description": "Path to the repository (defaults to current workspace)."
    },
    "changes": {
      "type": "array",
      "description": "List of simulation mutation steps.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "decompose",
              "remove_dependency",
              "add_dependency",
              "remove_node"
            ]
          },
          "mapping": {
            "type": "object",
            "description": "For decompose: mapping of node_id/path to service name."
          },
          "source": {
            "type": "string",
            "description": "For dependencies: source node id or name."
          },
          "target": {
            "type": "string",
            "description": "For dependencies: target node id or name."
          },
          "rel_type": {
            "type": "string",
            "description": "Optional: relationship type (e.g. CALLS, IMPORTS)."
          },
          "node_id": {
            "type": "string",
            "description": "For remove_node: node id, path, or name to delete."
          }
        },
        "allOf": [
          {
            "if": {
              "properties": {
                "type": {
                  "enum": [
                    "add_dependency",
                    "remove_dependency"
                  ]
                }
              }
            },
            "then": {
              "required": [
                "source",
                "target"
              ]
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "remove_node"
                }
              }
            },
            "then": {
              "required": [
                "node_id"
              ]
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "decompose"
                }
              }
            },
            "then": {
              "required": [
                "mapping"
              ]
            }
          }
        ],
        "required": [
          "type"
        ]
      }
    }
  },
  "required": [
    "changes"
  ]
}

analyze_architectural_evolution

Analyze repository growth trend and identify Technical Debt Hotspots (combining code complexity and Git commit churn).

Argument Required Type Default Description
repo_path no string - Path to the repository (defaults to current workspace).
commits no integer 50 Number of commits to analyze (default: 50).

Complete input schema

Enums, nested mutation steps and other constraints are included below.

{
  "type": "object",
  "properties": {
    "repo_path": {
      "type": "string",
      "description": "Path to the repository (defaults to current workspace)."
    },
    "commits": {
      "type": "integer",
      "description": "Number of commits to analyze (default: 50).",
      "default": 50
    }
  }
}