Provenza
Governed MCP gateway: approved tools only, each call policy-checked and recorded
- 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 provenzaAdd 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.comRequiredPROVENZA_TOKENOne-time enrollment token (Agents -> New agent); needed on the first start onlyPROVENZA_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Claude Code Ultimate Guide
MCP serverMCP 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
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security
Zero-log MCP server with 49 tools for AI guardrails, secret scanning and EU compliance
- 49 tools
- Remote
- Freemium
- Security