MCP Bauplan

@marcoeg

Repository

Basic information

About MCP Bauplan

An MCP server to interact with data and run pipeline using Bauplan

#mcp-bauplan#data-interaction#pipeline-management

MCP Bauplan config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "/path/to/uvx",
      "args": [
        "mcp-bauplan"
      ],
      "env": {
        "BAUPLAN_API_KEY": "your-api-key",
        "BAUPLAN_BRANCH": "your-branch",
        "BAUPLAN_NAMESPACE": "your-namespace",
        "BAUPLAN_TIMEOUT": "query-timeout-secs"
      }
    }
  }
}

MCP Bauplan tools

- Lists all the tables in the configured namespace

- Get the schema of a data tables

- Run a SELECT query on the specified table

Overview

What is mcp-bauplan?

mcp-bauplan is a minimalist Model Context Protocol (MCP) server that enables AI assistants to interact with data tables and run queries on Bauplan, a data store of Iceberg tables in S3.

How to use mcp-bauplan?

Install via uvx mcp-bauplan and configure it in your Claude Desktop config file with environment variables BAUPLAN_API_KEY, BAUPLAN_BRANCH, and BAUPLAN_NAMESPACE. Optionally set BAUPLAN_TIMEOUT. It supports both STDIO and SSE transports. For SSE, run uvx mcp-bauplan --transport sse --port 9090 with a .env file.

Key features of mcp-bauplan

Lists all tables in the configured namespace
Retrieves the schema of any data table
Runs SELECT-only SQL queries on tables
Supports both STDIO and SSE transports
Configurable query timeout (default 30 seconds)

Use cases of mcp-bauplan

Discover available Iceberg tables in a Bauplan namespace
Inspect table schemas before writing queries
Run ad‑hoc SELECT queries from an AI chat interface
Validate data or explore dataset content without a separate client

Frequently asked questions

What are the runtime dependencies?

Python 3.10 or higher, the `uv` package manager, and a valid Bauplan API key.

What transports are supported?

Both STDIO and SSE transports are supported. You can switch between them in the MCP Inspector during development.

How do I get a Bauplan API key?

Request one at [https://www.bauplanlabs.com/#join](https://www.bauplanlabs.com/#join).

What types of queries can I run?

Only `SELECT` queries are allowed. No data modification commands are supported.

Where are my data tables stored?

Bauplan manages Iceberg tables in S3. The server reads from the configured namespace and branch.

Comments

More Data & Analytics MCP servers

Kyrodata — Brazil Trade, Crop & Commodity Data

Kyrodata

Brazilian foreign-trade data from MDIC/ComexStat (exports and imports, 2000 to 2026, by HS code, NCM, partner country and bloc) plus crop production, supply-and-demand balances, growing-season climate and commodity forec

Hunter MCP

Hunter.io

Hunter MCP connects AI assistants and agents to Hunter’s B2B data, enabling them to find companies and contacts, discover and verify professional email addresses, enrich leads, and manage lead lists using natural-languag

YouTube MCP Server

HasData

Hosted YouTube MCP server for search, video metadata, channel data and timestamped transcripts. Connect Claude, Cursor or other MCP clients with HasData; no YouTube API key required.

Zillow MCP Server