Examples
On this page
The following examples demonstrate how to use the SingleStore MCP Server with the Claude Desktop.
-
Run the following command in the terminal:
uvx singlestore-mcp-server init -
Restart Claude Desktop.
Note
When using third-party tools such as Claude with the SingleStore MCP server, a permission prompt appears requesting access to run actions like run_
.
You can choose one of the following options:
-
Allow once: Approves the action for a single use.
-
Allow always: Grants persistent access for future requests.
-
Decline: Denies the request.
For improved security, SingleStore recommends selecting Allow once during initial setup or testing.

Create a Notebook in Personal Space
This example creates a notebook in personal space.
Create a notebook named myrag in personal space. In this notebook, write a python code to create a RAG application. The RAG application will use arxiv papers as data source, SingleStore as vector database, Gemma model as the LLM, and use LangChain orchestration framework.
Once the prompt is submitted, the following tools will run to perform the relative task:
-
choose_
: Selects the organization.organization -
set_
: Sets the organization.organization -
create_
: Creates a notebook with a comprehensive RAG application that uses ArXiv papers, SingleStore as the vector database, Gemma as the LLM, and LangChain orchestration framework.notebook_ file -
upload_
: Uploads the notebook to your personal space with the name myrag.notebook_ file

The notebook is created with the MCP integration.

Query a Database
This example creates a table, ingests data into the table, and queries the inserted data.sales
and an associated table.
Create a new database named sales in <your_workspace> under <your_workspace_group> of <your_organization>, and then create a table called SalesData with the following columns:- Date: Text- Store_ID: Big integer (20), nullable- ProductID: Text- Product_Name: Text,- Product_Category: Text- Quantity_Sold: Big integer (20), nullable- Price: Float, nullable- Total_Sales: Float, nullable
Once the prompt is submitted, the following tools will run to perform the relative task:
-
choose_
: Checks the organization information.organization -
set_
: Sets the organization to the specified organization.organization -
workspace_
: Checks and finds information on the specified workspace group.groups_ info -
workspaces_
: Checks and finds information on the specified workspace.info -
run_
: Creates the specified database.sql -
run_
: Creates the specified tables.sql

To ingest data using a pipeline, enter the following prompt:
Create a pipeline SalesData_pipeline using 's3://singlestoreloaddata/SalesData/*.csv'
Once the prompt is submitted, the following tool will run to perform the relative task:
-
run_
: Creates the pipeline in thesql sales
database.

To start the pipeline, enter the following prompt:
Start the pipeline
Once the prompt is submitted, the following tool will run to perform the relative task:
-
run_
: Starts the pipeline.sql

To query the data in the table, enter the following prompt:
Identify the top three stores with the highest sales in the Electronics category.
Once the prompt is submitted, the following tool will run to perform the relative task:
-
run_
: Queries thesql SalesData
table to find the top three stores with the highest sales in the Electronics category.

Create a Scheduled Job
This example creates a notebook in shared space and schedules the job.
Create a notebook named SalesData in the shared space. In the notebook, use the SalesData table from the sales database in <your_workspace> under <your_workspace_group> of <your_organization>, to generate appropriate visualizations based on the data.
Once the prompt is submitted, the following tools will run to perform the relative task:
-
choose_
: Checks the organization information.organization -
set_
: Sets the organization to the specified organization.organization -
workspace_
: Checks and finds information on the specified workspace group.groups_ info -
workspaces_
: Checks and finds information on the specified workspace.info -
run_
: Explores SalesData table structure.sql -
run_
: Understands the sample data of the table.sql -
run_
: Understands the aggregate information of the table.sql -
run_
: Explores the distinct product categories.sql -
create_
: Creates the SalesData notebook file.notebook_ file -
upload_
: Uploads the SalesData notebook file in shared space.notebook_ file

The notebook is created in the shared space in the Cloud Portal.

To schedule the notebook, enter the following prompt:
Create a schedule job using the SalesData notebook, with the name of job as SalesJob, start executions "Now", with "Weekly" "Recurring" schedule mode. Save all the execution results.
Once the prompt is submitted, the following tool will run to perform the relative task:
-
create_
: Creates a scheduled job using SalesData notebook in weekly recurring schedule mode.job_ from_ notebook

Last modified: August 14, 2025