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
}
}
}