valv
Rank #19,872sh.valv/mcp
Let coding agents query any SQL database safely. Read-only by default and scoped by your policies.
valv is a Model Context Protocol (MCP) server published by valv-dev. It ranks #19,872 of 132,046 servers tracked on MCP Toplist, and its repository has 5 GitHub stars. valv is listed across 2 registries — Official MCP and Glama, with 1 tracked version. It was first listed on Jul 28, 2026 and most recently updated on Jul 28, 2026.
Ranks ahead of 112,174 of 132,046 servers on MCP Toplist.
Use valv
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add valv -e "DATABASE_URL=<your DATABASE_URL>" -e "VALV_PROVIDER=<your VALV_PROVIDER>" -e "VALV_DATABASE=<your VALV_DATABASE>" -e "VALV_TABLES=<your VALV_TABLES>" -e "VALV_EXCLUDE=<your VALV_EXCLUDE>" -e "VALV_POLICY_FILE=<your VALV_POLICY_FILE>" -e "VALV_CONTEXT=<your VALV_CONTEXT>" -e "VALV_HTTP_PORT=<your VALV_HTTP_PORT>" -- npx -y @valv/mcpReplace each placeholder with your own value before saving.
[mcp_servers.valv]
command = "npx"
args = ["-y", "@valv/mcp"]
[mcp_servers.valv.env]
DATABASE_URL = "<your DATABASE_URL>"
VALV_PROVIDER = "<your VALV_PROVIDER>"
VALV_DATABASE = "<your VALV_DATABASE>"
VALV_TABLES = "<your VALV_TABLES>"
VALV_EXCLUDE = "<your VALV_EXCLUDE>"
VALV_POLICY_FILE = "<your VALV_POLICY_FILE>"
VALV_CONTEXT = "<your VALV_CONTEXT>"
VALV_HTTP_PORT = "<your VALV_HTTP_PORT>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"valv": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<your DATABASE_URL>",
"VALV_PROVIDER": "<your VALV_PROVIDER>",
"VALV_DATABASE": "<your VALV_DATABASE>",
"VALV_TABLES": "<your VALV_TABLES>",
"VALV_EXCLUDE": "<your VALV_EXCLUDE>",
"VALV_POLICY_FILE": "<your VALV_POLICY_FILE>",
"VALV_CONTEXT": "<your VALV_CONTEXT>",
"VALV_HTTP_PORT": "<your VALV_HTTP_PORT>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"valv": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<your DATABASE_URL>",
"VALV_PROVIDER": "<your VALV_PROVIDER>",
"VALV_DATABASE": "<your VALV_DATABASE>",
"VALV_TABLES": "<your VALV_TABLES>",
"VALV_EXCLUDE": "<your VALV_EXCLUDE>",
"VALV_POLICY_FILE": "<your VALV_POLICY_FILE>",
"VALV_CONTEXT": "<your VALV_CONTEXT>",
"VALV_HTTP_PORT": "<your VALV_HTTP_PORT>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"valv": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<your DATABASE_URL>",
"VALV_PROVIDER": "<your VALV_PROVIDER>",
"VALV_DATABASE": "<your VALV_DATABASE>",
"VALV_TABLES": "<your VALV_TABLES>",
"VALV_EXCLUDE": "<your VALV_EXCLUDE>",
"VALV_POLICY_FILE": "<your VALV_POLICY_FILE>",
"VALV_CONTEXT": "<your VALV_CONTEXT>",
"VALV_HTTP_PORT": "<your VALV_HTTP_PORT>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"valv": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<your DATABASE_URL>",
"VALV_PROVIDER": "<your VALV_PROVIDER>",
"VALV_DATABASE": "<your VALV_DATABASE>",
"VALV_TABLES": "<your VALV_TABLES>",
"VALV_EXCLUDE": "<your VALV_EXCLUDE>",
"VALV_POLICY_FILE": "<your VALV_POLICY_FILE>",
"VALV_CONTEXT": "<your VALV_CONTEXT>",
"VALV_HTTP_PORT": "<your VALV_HTTP_PORT>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"valv": {
"command": "npx",
"args": [
"-y",
"@valv/mcp"
],
"env": {
"DATABASE_URL": "<your DATABASE_URL>",
"VALV_PROVIDER": "<your VALV_PROVIDER>",
"VALV_DATABASE": "<your VALV_DATABASE>",
"VALV_TABLES": "<your VALV_TABLES>",
"VALV_EXCLUDE": "<your VALV_EXCLUDE>",
"VALV_POLICY_FILE": "<your VALV_POLICY_FILE>",
"VALV_CONTEXT": "<your VALV_CONTEXT>",
"VALV_HTTP_PORT": "<your VALV_HTTP_PORT>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/sh.valv%2Fmcp)<a href="https://mcptoplist.com/server/sh.valv%2Fmcp"><img src="https://mcptoplist.com/badge/sh.valv%2Fmcp.svg" alt="MCP Toplist: Top 25% of 132,046" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries
valv-dev
Available versions (1)
| Version | Published |
|---|---|
| 0.6.2 | Jul 28, 2026 |
Frequently asked questions
- Who maintains valv?
- valv is maintained by valv-dev, which publishes 1 MCP server (1 total version) tracked on MCP Toplist.
- Is valv listed on the Official MCP Registry?
- Yes — valv is listed on the Official MCP Registry, alongside Glama.
- How many versions does valv have?
- MCP Toplist tracks 1 version of valv, most recently published on Jul 28, 2026.
- Where can I find the source code for valv?
- The source code for valv is hosted at github.com/valv-dev/valv.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.