MindsDB's MCP Server Usage and Tools

MindsDB is an MCP server that enables your MCP applications to answer questions over large-scale federated data spanning databases, data warehouses, and SaaS applications.

​

Start MindsDB as an MCP Server

Follow the steps below to use MindsDB as an MCP server.

1. Install MindsDB locally via Docker or Docker Desktop.

2. Set the MINDSDB_MCP_ACCESS_TOKEN environment variable to enable user authentication for accessing MindsDB’s MCP Server.

3. Connect your data source and/or upload files to MindsDB in order to ask questions over your data.

   Sample Data

4. Run MindsDB enabling its MCP API on port 47337 by default.

   docker run --name mindsdb_container_name -e MINDSDB_APIS='mcp' -e MINDSDB_MCP_ACCESS_TOKEN=abc123 -p 47337:47337 mindsdb/mindsdb

   The following environment variables are set in the Docker container:

   • MINDSDB_APIS defines the MindsDB’s APIs to be started.
   • MINDSDB_MCP_ACCESS_TOKEN defines the MCP access token used to access MindsDB’s MCP Server from MCP Clients.
   Alternatively, you can use the MINDSDB_APIS environment variable to define the list of APIs to be started.

   export MINDSDB_APIS='mcp'

   If you run MindsDB via PyPI, you can define APIs as below.

   python -m mindsdb --api=mcp

​

MCP Tools

MindsDB MCP API exposes a set of tools that enable users to interact with their data and extract valuable insights.

1. List Databases

The list_databases tool lists all data sources connected to MindsDB.

2. Query

The query tool executes queries on the federated data to extract data relevant to answering a given question.