get_schema
Get the schema of the Bauplan data store.
LABSCO SUMMARY
A read-only SQL window onto Bauplan's data store, scoped to one branch and namespace.
The three tools follow the natural order of exploring data — see what tables exist, read the one you care about, then query it — and run_query is limited to SELECT, so an agent can answer questions from the data without any risk of changing it.
What it is
A minimalist server for Bauplan, which manages Iceberg tables in S3, giving an assistant three tools to explore and query the data in a configured namespace.
What you get
- list_tables lists the tables in the configured namespace
- get_schema returns a table's schema
- run_query runs a read-only SELECT against a table
Requirements
A Bauplan API key, plus the branch and namespace to work in; supports both stdio and SSE transports. Runs through uvx on Python.
Setup effort
One command plus a key — uvx mcp-bauplan, then supply credentials
USE CASES
01
Finding your way around a namespace
list_tables shows the tables and get_schema reveals a table's columns, so a query can be written against real structure.
02
Answering a question from the data
run_query runs a SELECT and returns the rows, read-only by design.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
list_tables
List all data tables in the Bauplan data store.
run_query
Query the Bauplan data store using SQL.
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected. Queries are SELECT only; pipeline execution, query generation and resources are work in progress, not shipped.
Requires
- uvx on PATH
- Python 3.10 or later
- BAUPLAN_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx mcp-bauplanMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-bauplan": {
"command": "<YOUR_PATH_TO_UVX>",
"args": [
"mcp-bauplan"
],
"env": {
"BAUPLAN_API_KEY": "<YOUR_BAUPLAN_API_KEY>",
"BAUPLAN_BRANCH": "<YOUR_BAUPLAN_BRANCH>",
"BAUPLAN_NAMESPACE": "<YOUR_BAUPLAN_NAMESPACE>",
"BAUPLAN_TIMEOUT": "query-timeout-secs"
}
}
}
}
