MCP Bauplan MCP Server

1. Create _or edit the Claude Desktop configuration file located at: - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` -

Local serverstdioPython

What is the MCP Bauplan MCP server?

MCP Bauplan MCP server exists for a simple reason — assistants are far more useful when they can act on MCP Bauplan directly instead of describing what you should do. 1. Create _or edit the Claude Desktop configuration file located at: - On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - On Windows: %APPDATA%/Claude/claude_desktop_config.json.

What you get

  • Get Bauplan data tables and their schemas in the configured namespace
  • Query Bauplan data tables using SQL (SELECT only)

What the assistant can call

Once MCP Bauplan is connected, these are the calls the assistant has available:

  • list_tables — - Lists all the tables in the configured namespace
  • get_schema — - Get the schema of a data tables
  • run_query — - Run a SELECT query on the specified table
  • Setup — 2. Clone the Repository: bash git clone https://github.com/marcoeg/mcp-bauplan cd mcp-nvd

Configuration and credentials

You will need 4 environment variables: BAUPLAN_API_KEY, BAUPLAN_BRANCH, BAUPLAN_NAMESPACE, BAUPLAN_TIMEOUT. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

Installation goes through your MCP client rather than a global install: point it at @modelcontextprotocol/inspector on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. MCP Bauplan's toolset — list_tables, get_schema, run_query and 1 more — is a fair guide to whether it matches your workflow. It is maintained by marcoeg; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against MCP Bauplan's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp bauplan mcp server does with a few real requests.

Available tools

ToolWhat it does
list_tables- Lists all the tables in the configured namespace
get_schema- Get the schema of a data tables
run_query- Run a SELECT query on the specified table
Setup2. **Clone the Repository**: bash git clone https://github.com/marcoeg/mcp-bauplan cd mcp-nvd

How to install the MCP Bauplan MCP server

{
  "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",
        // Optional
        "BAUPLAN_TIMEOUT": "query-timeout-secs" // default 30 seconds
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
BAUPLAN_API_KEYCredential the server authenticates with.Yes
BAUPLAN_BRANCHConfiguration value read at startup.Optional
BAUPLAN_NAMESPACEConfiguration value read at startup.Optional
BAUPLAN_TIMEOUTConfiguration value read at startup.Optional

Example prompts to try

  • Use MCP Bauplan to list tables.
  • Use MCP Bauplan to get schema.
  • Use MCP Bauplan to run query.

Frequently asked questions

It connects MCP Bauplan to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (list_tables, get_schema, run_query, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Bauplan directly.