valv
Let coding agents query any SQL database safely. Read-only by default and scoped by your…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.6.2
- Listing updated
- 4 days ago
About valv
valv is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.
Let coding agents query any SQL database safely. Read-only by default and scoped by your policies.
Install
Run in a terminal
claude mcp add mcp --env DATABASE_URL='<DATABASE_URL>' -- npx -y @valv/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Configuration
DATABASE_URLDatabase connection string. PostgreSQL, MySQL, SQLite, CockroachDB, or a ClickHouse HTTP URL.RequiredVALV_PROVIDERDatasource provider: postgresql, mysql, sqlite, or clickhouse. Inferred from DATABASE_URL when omitted.VALV_DATABASEDatabase name. Required for ClickHouse, whose URL does not carry one.VALV_TABLESComma-separated allow-list of tables. When set, only these are exposed to the agent.VALV_EXCLUDEComma-separated deny-list of tables, applied after the allow-list.VALV_POLICY_FILEPath to a policy module that takes full control of access. Without it, the server is read-only across all tables.VALV_CONTEXTJSON context object the policy reads, e.g. {"tenant":{"id":"acme"}}.VALV_HTTP_PORTServe over Streamable HTTP on this port instead of stdio.
Pricing
Open source
Prices change. Check valv.sh before you buy.
valv FAQ
Is valv free?
Yes. valv is open source, so you can use and self-host it for free.
How do I add valv to Claude Code?
Run this command in your terminal: claude mcp add mcp --env DATABASE_URL='<DATABASE_URL>' -- npx -y @valv/mcp
What are the best alternatives to valv?
The closest alternatives to valv are Midplane, PlatypusDB, Lorebase, Sovaria and model2data studio.
Alternatives to valv

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

PlatypusDB
MCP serverGives MCP clients access to your PlatypusDB database connections, scoped per agent
Runs locally- Open source
- Databases

Lorebase
MCP serverLets agents read and change a governed, versioned Postgres knowledge graph
Runs locally- Open source
- Knowledge and memory
Sovaria
MCP serverManage a Sovaria backend (Postgres, auth, storage, functions) from an AI assistant
Not checked yet- 4 tools
- Remote
- Freemium
- Databases

model2data studio
MCP serverGenerate realistic connected test data, dbt projects and dashboards from a schema
- Remote
- Freemium
- Databases

semlayer
MCP serverInfers a semantic layer from your data warehouse and serves it to agents
Runs locally- Free
- Databases