mcp-bauplan
@marcoeg
About mcp-bauplan
An MCP server to interact with data and run pipeline using 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"
}
}
}
}Tools
3- 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
FAQ from mcp-bauplan
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.
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.
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.
Basic information
More Data & Analytics MCP servers
MCP Simple PubMed
andybrandtMCP server for searching and querying PubMed medical papers/research database
Google Ads MCP
cohnenAn MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th
Sugra API MCP
Sugra Systems, Inc.Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl
PubMed Analysis MCP Server
DarkroasterA PubMed MCP server.
Subtext
Subtext by FullstorySession replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can
Comments