Tools on MCP Toolbox for Databases

falkordb-cypher

Mon, 01 Jan 0001 00:00:00 +0000

About

A falkordb-cypher tool executes a pre-defined Cypher statement against the graph configured on a FalkorDB source. The specified Cypher statement is executed as a parameterized statement, and specified parameters will be used according to their name: e.g. $id.

Note: This tool uses parameterized queries to prevent injections. Query parameters can be used as substitutes for arbitrary expressions. Parameters cannot be used as substitutes for identifiers, labels, relationship types, or other parts of the query.

falkordb-execute-cypher

Mon, 01 Jan 0001 00:00:00 +0000

About

A falkordb-execute-cypher tool executes a Cypher query provided by the calling agent against the graph configured on a FalkorDB source.

When readOnly is set to true, queries are dispatched with FalkorDB’s GRAPH.RO_QUERY command, so write operations are rejected by the database server itself rather than by client-side query inspection.

When allowGraphOverride is set to true, the tool exposes an additional graph parameter that lets the agent target any graph on the instance instead of the source’s default graph. Leave this off (the default) when the instance hosts graphs the agent should not reach.

falkordb-schema

Mon, 01 Jan 0001 00:00:00 +0000

About

A falkordb-schema tool extracts a complete schema description of the graph configured on a FalkorDB source: node labels and relationship types with their observed property shapes (derived from sampling up to sampleSize entities per label or type, 100 by default), indexes (including vector and full-text indexes), constraints, and graph statistics.

Compatible Sources

This tool can be used with the following database sources:

Source Name
FalkorDB Source

Example

kind: tool
name: get_schema
type: falkordb-schema
source: my-falkordb-instance
description: Use this tool to get the schema of the graph.

Output Format

{
 "graphInfo": {"name": "my_graph", "nodeCount": 2, "edgeCount": 1},
 "nodeLabels": [
 {"name": "Person", "count": 1, "properties": [{"name": "name", "types": ["STRING"]}]}
 ],
 "relationships": [
 {"type": "ACTED_IN", "count": 1, "startNode": "Person", "endNode": "Movie", "properties": []}
 ],
 "indexes": [],
 "constraints": [],
 "statistics": {"totalNodes": 2, "totalRelationships": 1}
}

Reference

field	type	required	description
type	string	true	Must be “falkordb-schema”.
source	string	true	Name of the source to extract the schema from.
description	string	true	Description of the tool that is passed to the LLM.
sampleSize	int	false	Entities sampled per label or type to derive property shapes. Defaults to 100.

falkordb-list-graphs

Mon, 01 Jan 0001 00:00:00 +0000

About

A falkordb-list-graphs tool lists the names of all graphs stored on the FalkorDB instance of a source (via GRAPH.LIST). A FalkorDB instance can host many independent graphs, so this tool is typically paired with a falkordb-execute-cypher tool configured with allowGraphOverride: true.

Compatible Sources

This tool can be used with the following database sources:

Source Name
FalkorDB Source

Example

kind: tool
name: list_graphs
type: falkordb-list-graphs
source: my-falkordb-instance
description: Use this tool to list the graphs stored on the instance.

Output Format

{"graphs": ["my_graph", "another_graph"]}

Reference

field	type	required	description
type	string	true	Must be “falkordb-list-graphs”.
source	string	true	Name of the source to list graphs from.
description	string	true	Description of the tool that is passed to the LLM.