mcpbeat Sign in

valv MCP Server

local only

valv runs on your own machine — the client starts it, so there is no endpoint to ping. 68 installs a week from npm. Last commit 11 Sep 2026.

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

Installs per day peak 155 · avg 14 · -66% w/w
a month agotoday
68
Installs / week
npm · @valv/mcp
5
Stars
0 open issues
11 Sep 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 18 h ago · rules 3dff92dd89df

Evidence

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

Claims read-only, but the code runs commands packages/prisma/src/url.ts:66, packages/mcp/src/init.ts:374
  execFileSync(process.execPath, [cliPath, ...args], {
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

  execFileSync(process.execPath, [cliPath, ...args], {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

We found things in this code

Code changes quietly between releases, and nobody reads the diff of a dependency. We do, on every release — watch valv and you get told the day something new turns up.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp -- npx -y @valv/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp": {
      "args": [
        "-y",
        "@valv/mcp"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@valv/mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "mcp": {
      "args": [
        "-y",
        "@valv/mcp"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp": {
      "args": [
        "-y",
        "@valv/mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: DATABASE_URL (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.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to valv

same job, measured the same way
Quarry
by wangggym

Safety-railed database access for agents: Postgres, MySQL, Redis. Read-only by default.

166 installs/wk local only
A2db
by agentic-eng

Safe, read-only database access for AI agents. 5 databases, batch queries, SQLGlot.

102 installs/wk local only
I
Universalbench
by nikhilgogulwar

Run code, query databases, call any LLM, and commit to GitHub from your AI, safely. Free tier.

answering
Postgres
by waystation

Connect to your PostgreSQL database to query data and schemas.

answering
Safedb MCP
by narekmalk

A secure MCP server that lets AI agents query databases safely.

34 installs/wk local only
Liquid
by ertad-family

Connect your AI agent to anything — APIs, databases, and agents; read and write, auto-discovered.

55 installs/wk local only
Midplane
by midplane

Safe-by-default SQL guardrails for AI agents: AST-checked queries, per-table policy, audit log.

74 installs/wk local only
Aifordatabase MCP
by dann26parr69

Query any database in plain English or SQL through a guardrailed, read-only data layer.

34 installs/wk local only

valv — questions

Answers built from our own checks of this server.

Why is there no uptime for valv?
valv runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @valv/mcp was installed 68 times last week.
How do I connect valv?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @valv/mcp straight from npm; nothing to host, nothing to sign up for.
How many people use valv?
The npm package @valv/mcp was installed 68 times in the last week. Week over week that is -66%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is valv open source?
Yes — it is published under the MIT licence, written in TypeScript and 5 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.