Tools on MCP Toolbox for Databases

spanner-execute-sql

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

About

A spanner-execute-sql tool executes a SQL statement against a Spanner database.

spanner-execute-sql takes one input parameter sql and run the sql statement against the source.

Note: This tool is intended for developer assistant workflows with human-in-the-loop and shouldn’t be used for production agents.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Spanner

Example

kind: tool
name: execute_sql_tool
type: spanner-execute-sql
source: my-spanner-instance
description: Use this tool to execute sql statement.

Reference

field	type	required	description
type	string	true	Must be “spanner-execute-sql”.
source	string	true	Name of the source the SQL should execute on.
description	string	true	Description of the tool that is passed to the LLM.
readOnly	bool	false	When set to `true`, the `statement` is run as a read-only transaction. Default: `false`.

spanner-sql

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

About

A spanner-sql tool executes a pre-defined SQL statement (either googlesql or postgresql) against a Cloud Spanner database.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Spanner

GoogleSQL

For the googlesql dialect, the specified SQL statement is executed as a data manipulation language (DML) statements, and specified parameters will inserted according to their name: e.g. @name.

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

spanner-list-graphs

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

About

A spanner-list-graphs tool retrieves comprehensive schema information about graphs in a Cloud Spanner database. It returns detailed metadata including node tables, edge tables, labels and property declarations.

Features

Comprehensive Schema Information: Returns node tables, edge tables, labels and property declarations
Flexible Filtering: Can list all graphs or filter by specific graph names
Output Format Options: Choose between simple (graph names only) or detailed (full schema information) output

Use Cases

Database Documentation: Generate comprehensive documentation of your database schema
Schema Validation: Verify that expected graphs, node and edge exist
Migration Planning: Understand the current schema before making changes
Development Tools: Build tools that need to understand database structure
Audit and Compliance: Track schema changes and ensure compliance with data governance policies

This tool is read-only and executes pre-defined SQL queries against the INFORMATION_SCHEMA tables to gather metadata.

Warning

spanner-list-tables

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

About

A spanner-list-tables tool retrieves comprehensive schema information about tables in a Cloud Spanner database. It automatically adapts to the database dialect (GoogleSQL or PostgreSQL) and returns detailed metadata including columns, constraints, and indexes.

This tool is read-only and executes pre-defined SQL queries against the INFORMATION_SCHEMA tables to gather metadata. The tool automatically detects the database dialect from the source configuration and uses the appropriate SQL syntax.

Features

Automatic Dialect Detection: Adapts queries based on whether the database uses GoogleSQL or PostgreSQL dialect
Comprehensive Schema Information: Returns columns, data types, constraints, indexes, and table relationships
Flexible Filtering: Can list all tables or filter by specific table names
Output Format Options: Choose between simple (table names only) or detailed (full schema information) output

Use Cases

Database Documentation: Generate comprehensive documentation of your database schema
Schema Validation: Verify that expected tables and columns exist
Migration Planning: Understand the current schema before making changes
Development Tools: Build tools that need to understand database structure
Audit and Compliance: Track schema changes and ensure compliance with data governance policies

Compatible Sources

This tool can be used with the following database sources: