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