Valv MCP Server

Let agents query your database. Just not all of it. valv gives an agent structured tools to read your database - and, opt-in, to write to it. The model emits a structured query (or insert/update/delete) - never SQL - and valv validates it against your schema, scopes it to the current user with policies you write in code, compiles it to your database's SQL, and runs it.

People connecting coding agent tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-23 · ★ 3 · #64 OF 194 MAINTAINED CODING AGENT · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Valv

before you install - you'll need

DATABASE_URL

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add valv-dev-valv -- npx -y @valv/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "valv-dev-valv": {
      "command": "npx",
      "args": [
        "-y",
        "@valv/mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @valv/mcp - the @valv scope differs from the repo owner (valv-dev); confirm it's the project's official package

registry vendor namespace sh.valv - domain-verified with the official MCP registry

03 · Who maintains Valv

valv is maintained by valv-dev. It's the only MCP server we track from this author; the repo dates to May 2026.

04 · Facts

repository: github.com/valv-dev/valv
website: https://valv.sh/
category: coding agent - ranked #64 of 194 actively-maintained coding agent servers as of 2026-08-25.
registry: sh.valv/mcp (active, first published 2026-07-28)
packages: npm:@valv/mcp

05 · Valv FAQ

What is Valv?

Is Valv still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-23. We re-verify nightly.

How do I install Valv?

Run `npx -y @valv/mcp`. The README documents one environment variable (DATABASE_URL) to set first. You can also paste the ready-made client config above.

Does Valv run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

06 · Alternatives to Valv

Alternatives to Valv

Maintained coding agent servers if Valv isn't the fit.

Pairs well with

Servers that cover what Valv doesn't - only shown when the pairing reason fits the companion.

More coding agent MCP servers · Vap E · Codehelper · AI Context · Rulemorph MCP Server · Axis

More TypeScript MCP servers · Can LII (vaquill-ai) · Dokploy MCP · Vugola MCP · PageIndex MCP · Memento · see all