Skip to content
MCP server

Provenza

Governed MCP gateway: approved tools only, each call policy-checked and recorded

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.1
Listing updated
2 days ago

About Provenza

Provenza is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Provenza is open-source, self-hosted governance for AI agents, and this package lets an MCP client reach tools through it. Each call is checked against the agent's rights, organization policies, a tool registry, behaviour rules and a circuit breaker before it runs. Denied calls raise an error, calls needing a human decision are held until a person approves, and results are signed with the agent's own key and sealed into a tamper-evident audit log with receipts verifiable offline.

An admin issues a one-time enrollment token under Agents then New agent; keys are generated on the agent's machine and only the public key goes to the server. The Python SDK fails closed when the server is unreachable. Standalone mode writes a local signed, hash-chained log that stores hashes of arguments and results, never content. Optional keychain storage and post-quantum hybrid keys (Ed25519 with ML-DSA-65) are available.

It needs a self-hosted Provenza server and URL.

Install

Run in a terminal

claude mcp add provenza --env PROVENZA_URL='<PROVENZA_URL>' --env PROVENZA_TOKEN='<PROVENZA_TOKEN>' -- uvx provenza

Add to claude_desktop_config.json

{
  "mcpServers": {
    "provenza": {
      "command": "uvx",
      "args": [
        "provenza"
      ],
      "env": {
        "PROVENZA_URL": "<PROVENZA_URL>",
        "PROVENZA_TOKEN": "<PROVENZA_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "provenza": {
      "command": "uvx",
      "args": [
        "provenza"
      ],
      "env": {
        "PROVENZA_URL": "<PROVENZA_URL>",
        "PROVENZA_TOKEN": "<PROVENZA_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "provenza": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "provenza"
      ],
      "env": {
        "PROVENZA_URL": "<PROVENZA_URL>",
        "PROVENZA_TOKEN": "<PROVENZA_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "provenza": {
      "command": "uvx",
      "args": [
        "provenza"
      ],
      "env": {
        "PROVENZA_URL": "<PROVENZA_URL>",
        "PROVENZA_TOKEN": "<PROVENZA_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "provenza": {
      "command": "uvx",
      "args": [
        "provenza"
      ],
      "env": {
        "PROVENZA_URL": "<PROVENZA_URL>",
        "PROVENZA_TOKEN": "<PROVENZA_TOKEN>"
      }
    }
  }
}

Configuration

  • PROVENZA_URLYour self-hosted Provenza, e.g. https://provenza.example.comRequired
  • PROVENZA_TOKENOne-time enrollment token (Agents -> New agent); needed on the first start only
  • PROVENZA_AGENT_NAMEAgent name on this machine (default: mcp)

What it does

Policy checks
Rights, policies, registry and behaviour checked before each call.
Human approval holds
Calls needing approval wait, then run once after sign-off.
Signed audit log
Results are signed and sealed in a tamper-evident log.
Fail-closed SDK
Tools do not run if the server is unreachable.
Local identity keys
Keys generated on the agent's machine.
Delegation chains
Agents can delegate tasks with scoped tools and expiry.

Good for

  • Gate which tools an agent may call
  • Require approval before a report is emailed
  • Keep a verifiable record of agent actions
  • Restrict a standalone agent to an allow list

Pricing

Open source

Prices change. Check stickstock.lol before you buy.

Provenza FAQ

Does it need a server?

Connected mode needs your self-hosted Provenza at PROVENZA_URL; standalone mode runs without one.

What happens if the server goes down?

The SDK fails closed unless fail_open=True is set.

Does the audit log store my data?

The local log stores only hashes of arguments and results.

How is an agent enrolled?

With a one-time enrollment token from Agents then New agent.

Is Provenza free?

Yes. Provenza is open source, so you can use and self-host it for free.

How do I add Provenza to Claude Code?

Run this command in your terminal: claude mcp add provenza --env PROVENZA_URL='<PROVENZA_URL>' --env PROVENZA_TOKEN='<PROVENZA_TOKEN>' -- uvx provenza

What are the best alternatives to Provenza?

The closest alternatives to Provenza are REA, Claude Code Ultimate Guide, Agent Roast, Midplane and Leash.

Alternatives to Provenza

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  3. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  4. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  5. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security