Warehouse MCP server
io.github.kalehdoo/warehouse-mcp·v0.4.2Production MCP server for Postgres, Oracle, Snowflake, BigQuery, Redshift, DuckDB, MotherDuck.
0 stars52 downloads/wk
Reviews
Write oneNobody has reviewed Warehouse yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Warehouse tools (13, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
column_statsReturn min, max, null count, distinct count, and (for numeric columns) average for one column.
count_rowsReturn the row count for a table. Cheap (single COUNT(*)), and answers 'how big is this?' before the agent decides whether to scan it. Especially useful on cloud warehouses where bytes scanned costs money.
describe_tableReturn column names, types, and nullability for a table or view.
find_columnsSearch column names across the warehouse using a SQL LIKE pattern (use % for wildcards). Returns matching (schema, table, column, type) tuples. Optionally scope to one schema. On BigQuery, schema is required because INFORMATION_SCHEMA is per-dataset.
get_foreign_keysReturn declared foreign-key relationships (from_schema/from_table/from_column → to_schema/to_table/to_column). Optionally scope to a schema or a single table. BigQuery only returns informational FKs that were explicitly declared.
get_view_definitionReturn the SQL body of a view. Useful when business logic lives in views — the model can reason about a view's semantics by reading its definition.
list_schemasList all schemas (or BigQuery datasets) visible to the configured warehouse role.
list_tablesList tables and views in a given schema.
querywrite actionExecute a single read-only SELECT against the configured warehouse. Returns columns and rows. A LIMIT (or FETCH FIRST on Oracle) is auto-applied if the SQL omits one.
sample_tableReturn up to N sample rows from a table (capped at 100).
search_valueFind a literal value across the text columns of a table (exact match). Scans up to 10 text columns and returns up to 100 hits.
time_seriesGroup a table by a date/timestamp column into buckets (hour/day/week/month/quarter/year) and return a count or aggregate per bucket. Saves the agent from constructing dialect-specific date truncation. Returns rows ordered chronologically.
top_valuesReturn the top-K most frequent non-null values in a column with their counts.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan46 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 101 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Warehouse compares
Against every graded Databases MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 30% of 802 Databases servers
- Tools
- 13
- the typical Databases server has 8
- Tools that change things
- 8%
- typical: 10%. Fewer write tools means less an agent can break
- Downloads a week
- 52
- more than 40% of 324 Databases servers with a package
What its tools let an agent do: 12 read · 1 change
Install Warehouse in Claude Code, Cursor or VS Code
Runs npx -y warehouse-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add warehouse-mcp -- npx -y warehouse-mcp
What the publisher says
From the Warehouse repository's README, as published. We do not edit it. Read it on GitHub
warehouse-mcp
Production MCP (Model Context Protocol) server for your data warehouse. Read-only enforcement, five-tier role-based access, optional warehouse-role impersonation (for native RLS / CLS), JSONL audit log, optional output PII masking, optional semantic-metadata layer (glossary + table docs) with per-session toggle. Self-host the Docker image, install via npx, or wait for the upcoming managed cloud variant.
Status: v0.4.x — production-ready for the v1 warehouse list. See CHANGELOG for what shipped in each release.
Demo Videos
Warehouse MCP in action using Cursor
Supported warehouses
Databricks SQL is a fast-follow.
Tools exposed (16, all read-only)
Roles (five tiers)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Warehouse: common questions
- Is Warehouse MCP server safe?
- Mostly: it is graded B (72/100). Read the Warehouse safety report
- How do I install Warehouse?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Warehouse need an API key?
- Yes. The registry entry asks for
MCP_API_KEYS,MOTHERDUCK_TOKEN,PG_PASSWORD,ORACLE_PASSWORD. - Is Warehouse maintained?
- The last commit was 137 days ago (2026-06-18). The latest release is v0.4.2.
- What can I use instead of Warehouse?
- Servers from other publishers that do the same job: Faucet MCP server, DBHub MCP server and Appwrite MCP server.
- How does Warehouse compare with other Databases MCP servers?
- safety score 72/100 (higher than 30% of 802 Databases servers); tools 13 (the typical Databases server has 8); tools that change things 8% (typical: 10%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Warehouse
Same job from other publishers: the closest match first, then the best rated.
- FaucetSQL database to MCP tools and REST API: PostgreSQL, MySQL, SQL Server, Oracle, SQLite, Snowflake.not reviewedEstablishedA
- DBHubToken-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLitenot reviewedWidely usedA
- AppwriteBuild and deploy backends: auth, Postgres/MySQL/vector databases, storage, functions, hosting, CDNnot reviewedEstablishedA
- Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or PostgresDouble-entry books an agent keeps as the user: invoices, VAT returns, 174 country packs.not reviewedEstablishedA
- Run402x402 pay-per-call infra for agents: $0.03 image generation, Postgres, auth, storage, functions.not reviewedEstablishedB