Valv MCP Server

Let coding agents query any SQL database safely. Read-only by default and scoped by your policies.

Local serverstdio

What is the Valv MCP Server?

Valv is an MCP integration. Let coding agents query any SQL database safely. Read-only by default and scoped by your policies.

Packages and local setup

The published npm package is @valv/mcp, version 0.6.2. Its declared MCP transport is stdio.

The package declares DATABASE_URL (required): Database connection string. PostgreSQL, MySQL, SQLite, CockroachDB, or a ClickHouse HTTP URL.; VALV_PROVIDER: Datasource provider: postgresql, mysql, sqlite, or clickhouse. Inferred from DATABASE_URL when omitted.; VALV_DATABASE: Database name. Required for ClickHouse, whose URL does not carry one.; VALV_TABLES: Comma-separated allow-list of tables. When set, only these are exposed to the agent.; VALV_EXCLUDE: Comma-separated deny-list of tables, applied after the allow-list.; VALV_POLICY_FILE: Path to a policy module that takes full control of access. Without it, the server is read-only across all tables.; VALV_CONTEXT: JSON context object the policy reads, e.g. {"tenant":{"id":"acme"}}.; VALV_HTTP_PORT: Serve over Streamable HTTP on this port instead of stdio..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.6.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related databases MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
DATABASE_URLDatabase connection string. PostgreSQL, MySQL, SQLite, CockroachDB, or a ClickHouse HTTP URL.Yes
VALV_PROVIDERDatasource provider: postgresql, mysql, sqlite, or clickhouse. Inferred from DATABASE_URL when omitted.Optional
VALV_DATABASEDatabase name. Required for ClickHouse, whose URL does not carry one.Optional
VALV_TABLESComma-separated allow-list of tables. When set, only these are exposed to the agent.Optional
VALV_EXCLUDEComma-separated deny-list of tables, applied after the allow-list.Optional
VALV_POLICY_FILEPath to a policy module that takes full control of access. Without it, the server is read-only across all tables.Optional
VALV_CONTEXTJSON context object the policy reads, e.g. {"tenant":{"id":"acme"}}.Optional
VALV_HTTP_PORTServe over Streamable HTTP on this port instead of stdio.Optional