valv

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-07-28T08:14:34.542492Z",
      "publishedAt": "2026-07-28T08:14:34.542492Z",
      "statusChangedAt": "2026-07-28T08:14:34.542492Z"
    }
  },
  "server": {
    "name": "sh.valv/mcp",
    "title": "valv",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.6.2",
    "packages": [
      {
        "version": "0.6.2",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@valv/mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "DATABASE_URL",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "Database connection string. PostgreSQL, MySQL, SQLite, CockroachDB, or a ClickHouse HTTP URL."
          },
          {
            "name": "VALV_PROVIDER",
            "format": "string",
            "choices": [
              "postgresql",
              "mysql",
              "sqlite",
              "clickhouse"
            ],
            "description": "Datasource provider: postgresql, mysql, sqlite, or clickhouse. Inferred from DATABASE_URL when omitted."
          },
          {
            "name": "VALV_DATABASE",
            "format": "string",
            "description": "Database name. Required for ClickHouse, whose URL does not carry one."
          },
          {
            "name": "VALV_TABLES",
            "format": "string",
            "description": "Comma-separated allow-list of tables. When set, only these are exposed to the agent."
          },
          {
            "name": "VALV_EXCLUDE",
            "format": "string",
            "description": "Comma-separated deny-list of tables, applied after the allow-list."
          },
          {
            "name": "VALV_POLICY_FILE",
            "format": "filepath",
            "description": "Path to a policy module that takes full control of access. Without it, the server is read-only across all tables."
          },
          {
            "name": "VALV_CONTEXT",
            "format": "string",
            "description": "JSON context object the policy reads, e.g. {\"tenant\":{\"id\":\"acme\"}}."
          },
          {
            "name": "VALV_HTTP_PORT",
            "format": "number",
            "description": "Serve over Streamable HTTP on this port instead of stdio."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/valv-dev/valv",
      "source": "github",
      "subfolder": "packages/mcp"
    },
    "websiteUrl": "https://valv.sh",
    "description": "Let coding agents query any SQL database safely. Read-only by default and scoped by your policies."
  }
}