Tools on MCP Toolbox for Databases

vector-assist-apply-spec

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

About

The vector-assist-apply-spec tool automatically executes all the SQL recommendations associated with a specific vector specification (spec_id) or table. It runs the necessary commands in the correct sequence to provision the workload, marking each step as applied once successful.

Use this tool when the user has reviewed the generated recommendations from a defined (or modified) spec and is ready to apply the changes directly to their database instance to finalize the vector search setup. Under the hood, this tool connects to the target database and executes the vector_assist.apply_spec function.

vector-assist-define-spec

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

About

The vector-assist-define-spec tool defines a new vector specification by capturing the user’s intent and requirements for a vector search workload. It generates a complete, ordered set of SQL recommendations required to set up the database, embeddings, and vector indexes.

Use this tool at the very beginning of the vector setup process when an agent or user first wants to configure a table for vector search, generate embeddings, or create a new vector index. Under the hood, this tool connects to the target database and executes the vector_assist.define_spec function to generate the necessary specifications.

vector-assist-delete-spec

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

About

The vector-assist-delete-spec tool deletes an existing vector specification using its spec_id.

Use this tool when a user explicitly requests to delete, remove, or clean up an existing vector specification which was created in the context of the vector assist tools. Under the hood, this tool connects to the target database and executes the vector_assist.delete_spec function.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud SQL for PostgreSQL Source

Requirements

Tip

vector-assist-generate-query

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

About

The vector-assist-generate-query tool generates optimized SQL queries for vector search by leveraging the metadata and vector specifications defined in a specific spec_id. It serves as the primary actionable tool for generating the executable SQL required to retrieve relevant results based on vector similarity.

The tool contextually understands requirements such as distance functions, quantization, and filtering to ensure the resulting query is compatible with the corresponding vector index. Additionally, it can automatically handle iterative index scans for filtered queries and calculate the necessary search parameters (like ef_search) to meet a target recall.

vector-assist-get-spec

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

About

The vector-assist-get-spec tool retrieves the details of an existing vector specification using its unique spec_id.

Use this tool to retrieve a vector specification which was created in the context of the vector assist tools. It allows users to inspect the detailed parameters and current state of a particular vector setup. Under the hood, this tool connects to the target database and executes the vector_assist.get_spec function.

Compatible Sources

This tool can be used with the following database sources:

vector-assist-improve-query-recall

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

About

The vector-assist-improve-query-recall tool is designed to troubleshoot and optimize existing vector search workloads when a user reports irrelevant results, poor accuracy, or degraded recall.

It determines the optimal tuning parameter (such as hnsw.ef_search) for an active vector index to improve the search results. The tool evaluates the target recall and outputs an actionable SQL query recommendation (e.g., SET hnsw.ef_search TO ...) that must be executed as a next action using the execute_sql tool.

vector-assist-list-specs

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

About

The vector-assist-list-specs tool lists all defined vector specifications for a given table and column name.

Use this tool to list vector specifications which were created in the context of the vector assist tools. It provides a high-level overview of existing vector setups. Under the hood, this tool connects to the target database and executes the vector_assist.list_specs function.

Compatible Sources

This tool can be used with the following database sources:

vector-assist-modify-spec

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

About

The vector-assist-modify-spec tool modifies an existing vector specification (identified by a required spec_id) with new parameters or overrides. Upon modification, it automatically recalculates and refreshes the list of generated recommendations by vector_assist.define-spec to match the updated spec requirements.

Use this tool when a user or agent wants to adjust or fine-tune the configuration of an already defined vector spec (such as changing the target recall, embedding model, or quantization) before actually executing the setup commands. Under the hood, this tool connects to the target database and executes the vector_assist.modify_spec function to generate the updated specifications.