GitHits
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
AI governance & security gateway for MCP: approved tools, policy-checked calls, signed audit proofs
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 4/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 16/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Provenza. Sigue https://mcp.popnx.com/i/kironovlaziz-del-provenza.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 17 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Provenza (créala en el sitio del autor) · 1 ajuste(s) que rellenar (PROVENZA_URL) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Provenza para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "provenza": { "command": "uvx", "args": [ "provenza" ], "env": { "PROVENZA_URL": "your-value", "PROVENZA_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PROVENZA_TOKEN, PROVENZA_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Provenza aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
PROVENZA_URL Su instancia autoalojada de Provenza, p. ej. https://provenza.example.com Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"provenza": {
"command": "uvx",
"args": [
"provenza"
],
"env": {
"PROVENZA_URL": "your-value",
"PROVENZA_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Provenza y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Provenza o muestra una herramienta de Provenza en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PROVENZA_AGENT_NAME Nombre del agente en esta máquina (predeterminado: mcp) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Provenza
Provenza se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Provenza
B · Otros en Ciberseguridad que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Provenza (créala en el sitio del autor) · 1 ajuste(s) que rellenar (PROVENZA_URL) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Provenza para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user provenza --env PROVENZA_URL=your-value --env PROVENZA_TOKEN=your-value -- uvx provenza 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PROVENZA_TOKEN, PROVENZA_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Provenza aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
PROVENZA_URL Su instancia autoalojada de Provenza, p. ej. https://provenza.example.com Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user provenza --env PROVENZA_URL=your-value --env PROVENZA_TOKEN=your-value -- uvx provenzaCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Provenza en la lista como conectado
Usa Provenza y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Provenza o muestra una herramienta de Provenza en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PROVENZA_AGENT_NAME Nombre del agente en esta máquina (predeterminado: mcp) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Provenza (créala en el sitio del autor) · 1 ajuste(s) que rellenar (PROVENZA_URL) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Provenza para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "provenza": { "command": "uvx", "args": [ "provenza" ], "env": { "PROVENZA_URL": "your-value", "PROVENZA_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PROVENZA_TOKEN, PROVENZA_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Provenza aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
PROVENZA_URL Su instancia autoalojada de Provenza, p. ej. https://provenza.example.com Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de Provenza, PROVENZA_TOKEN, PROVENZA_URL está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Provenza y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Provenza o muestra una herramienta de Provenza en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PROVENZA_AGENT_NAME Nombre del agente en esta máquina (predeterminado: mcp) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Provenza (créala en el sitio del autor) · 1 ajuste(s) que rellenar (PROVENZA_URL) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Provenza para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "provenza": { "type": "stdio", "command": "uvx", "args": [ "provenza" ], "env": { "PROVENZA_URL": "your-value", "PROVENZA_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PROVENZA_TOKEN, PROVENZA_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Provenza aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
PROVENZA_URL Su instancia autoalojada de Provenza, p. ej. https://provenza.example.com Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de Provenza, PROVENZA_TOKEN, PROVENZA_URL está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Provenza y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Provenza o muestra una herramienta de Provenza en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PROVENZA_AGENT_NAME Nombre del agente en esta máquina (predeterminado: mcp) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user provenza --env PROVENZA_URL=your-value --env PROVENZA_TOKEN=your-value -- uvx provenzaClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"provenza": {
"command": "uvx",
"args": [
"provenza"
],
"env": {
"PROVENZA_URL": "your-value",
"PROVENZA_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"provenza": {
"command": "uvx",
"args": [
"provenza"
],
"env": {
"PROVENZA_URL": "your-value",
"PROVENZA_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"provenza": {
"type": "stdio",
"command": "uvx",
"args": [
"provenza"
],
"env": {
"PROVENZA_URL": "your-value",
"PROVENZA_TOKEN": "your-value"
}
}
}
}PROVENZA_URL obligatorio envPROVENZA_TOKEN secreto obligatorio envPROVENZA_AGENT_NAME envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: provenzaSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub kironovlaziz-del, dueña del repo
Último cambio de código: anteayer
Usa Apache-2.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Aún no revisado
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/kironovlaziz-del-provenza)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: PROVENZA_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez anteayer, y la última versión (0.2.2) llegó al registro hace 3 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
Sonatype component intelligence: versions, security analysis, and Trust Score recommendations
Easily find and fix security issues in your applications leveraging Snyk platform capabilities.
Your AI agent is smart enough to code all day. Local firewall & zero-loss runtime.
Security scanning for AI agents: SAST, SCA, secrets, IaC, DAST, ranked by real risk.
| Este Provenza | GitHits | Dependency Management MCP Server | Snyk MCP | TokenSafe | Draugr | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | En la nube o instalado en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | En la nube o instalado en tu equipo | Se instala en tu equipo |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 5/5 | 3/4 | 3/3 | 5/5 | 3/3 |
| Licencia | Apache-2.0 | Apache-2.0 | – | Apache-2.0 | MIT | Apache-2.0 |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Governed, signed and auditable actions for AI agents.
pip install provenza
from provenza import Agent
agent = Agent("support-bot") # reads PROVENZA_URL and PROVENZA_TOKEN
@agent.tool(name="zendesk.read") def open_tickets(status: str = "open") -> list: return zendesk.tickets.list(status=status)
open_tickets() # checked by Provenza, run, recorded and signed
In connected mode (when PROVENZA_URL is set):
ProvenzaDenied (a PermissionError);ProvenzaApprovalRequired.In both cases the attempt is recorded. Once a person approves the held call, make exactly the same call again: it runs once, within an hour.
try:
send_report(to="cfo@example.com") except ProvenzaApprovalRequired as held: if agent.wait_for_approval(held.action_id)["decision"] == "approved": send_report(to="cfo@example.com") # the same call: runs once
3. The result is recorded and signed with the agent's own key. Provenza
seals it into its signed audit log, so you can download a receipt for it that is verifiable offline.
The SDK fails closed: if the server cannot be reached, the tool does not run and the SDK raises ProvenzaUnavailable. Pass fail_open=True to run anyway and log the call locally as unchecked.
In standalone mode (no server), calls run and are written to a local, signed, hash-chained audit log. You can restrict them with allowed_tools=[...].
Only hashes of arguments and results are written to the local audit log, never the content.
An admin issues a one-time enrollment token in Provenza (Agents → New agent). The agent's keys are generated on its own machine, and only the public key goes to the server:
export PROVENZA_URL=https://provenza.example.com
export PROVENZA_TOKEN=pvz_enr_... # used once; afterwards the identity file is enough
The identity is stored in ~/.config/provenza/agents/ .json (mode 600). The SDK refuses to load it if other users can read it. It is the same file tools/provenza_sign.py enroll writes, so you can enroll with the CLI and run with the SDK.
To keep the private keys in the OS keychain instead:
pip install 'provenza[keychain]'
Agent("bot", key_store="keychain")
For post-quantum hybrid keys (Ed25519 + ML-DSA-65):
pip install 'provenza[pq]'
Agent("bot", hybrid=True)
agent.fingerprint is the value to give whoever verifies the agent's signatures.
with agent.chain(chain_id): # act inside a delegation chain
open_tickets()
task = agent.current_task() # the task a person gave this agent, signed if task: with agent.task(task["id"]): # each call names it; one outside it is refused open_tickets()
agent.delegate(other_agent_id, "summarize Q3", ["read"], tools=["db.read"], expires_in=600)
chk = agent.check("files.delete", {"path": p}) # ask for something that is not a decorated tool if chk.allowed: delete(p) agent.record(chk, {"deleted": True})
Async tools work the same way (async def). If a call ran but could not be recorded on the server (the server went down mid-call), the SDK does not hide the result. It writes a signed gap entry to the local audit log and emits a ProvenzaWarning.
A governed call costs the SDK's own work plus round-trips to the server. The SDK's own work was measured against an in-process server (no network) on 2026-10-11:
record_mode | round-trips before the tool returns | median | p95 |
|---|---|---|---|
"sync" (default) | 2 (check, record) | 0.42 ms | 0.59 ms |
"background" | 1 (check) | 0.15 ms | 0.33 ms |
Add your network round-trip (×2 or ×1) and the server's checks.
With "sync", the record is on the server when the tool returns.
With "background", records are sent from a queue, in order. A failure becomes a signed gap in the local audit log, the same as in sync mode. flush() / aflush() wait for the queue, and close() and interpreter exit drain it. A process that is killed loses whatever is still queued; that is the price of not waiting.
Refusals are always recorded before the exception is raised, so ProvenzaDenied.action_id is known at once.
import provenza.auto
provenza.auto.instrument(agent) # httpx (sync and async) and requests
Every direct call from this process to an AI provider becomes a governed action. That covers the OpenAI, Anthropic, Mistral, Cohere and Gemini SDKs, LangChain's provider clients, or plain HTTP. The provider hosts come from your organization's AI domain catalog (Shadow AI), and the server decides each call:
| catalog status | result |
|---|---|
blocked | refused; incident ai_domain_blocked |
allowed | sent, unless a policy refuses it |
| not classified | sent, unless a policy refuses it; recorded for an admin to classify |
Only the host, method, path (without the query string), and the hash and size of the body are recorded. The prompt is never recorded.
A refusal comes back as an HTTP answer: 403 with an OpenAI-style error body and x-should-retry: false. Provider SDKs therefore raise their usual permission error with Provenza's reason and do not retry. With the server unreachable, nothing is sent (503). Other hosts, and calls to Provenza itself, are untouched. provenza.auto.uninstrument() puts everything back.
Behind a Provenza egress proxy (proxy/ in the repository) the agent has two options. It can send its key and let the proxy check every request, or it can check a request itself and send the check id:
body = json.dumps({"amount": 1000}).encode()
chk = agent.proxy_check("stripe", "POST", "/v1/charges", body=body) if chk.allowed: httpx.post("http://127.0.0.1:8443/stripe/v1/charges", content=body, headers=chk.proxy_headers)
path, query and body must be exactly what goes on the wire. The proxy refuses any other request under that check. The proxy records the request, so it is not passed to record().
agent.proxy_request_headers(...) (same arguments) returns the headers to send: the check's, or, while Provenza is unreachable, only the agent's signed request. A proxy that enforces the signed policy then judges it by the signed release alone until its local kill switch stops it, and Provenza records the request when it is back (docs/pvp/edge.md, section 6).
An API registered in Provenza (Gateways → HTTP tools) is called through Provenza, and the agent never holds its key. The call is checked, made and recorded in one step. A tool that takes a credential is called through the egress proxy, which holds it - Provenza itself holds no credential:
agent = Agent("billing-bot", egress_proxy="http://127.0.0.1:8443") # or PROVENZA_EGRESS_PROXY
out = agent.invoke("crm.set_tier", {"id": "42", "tier": "gold"}) out["status"], out["body"] # a refusal raises ProvenzaDenied agent.http_tools() # names, descriptions and input schemas, for the model
Through a proxy the HTTP request itself is signed too (X-Provenza-Request), which a proxy in enforce mode requires on every path. For clients that cannot sign (a stock OpenAI or MCP client) run the proxy's agent mode next to the agent with this identity file (provenza-proxy -agent-identity …, proxy/README.md).
Is this host confined to the Provenza egress proxy, its only way out? Run the check at start-up and then periodically. With Require confined egress on, an agent acts only while its latest check is confined. See docs/egress-lockdown.md.
agent.egress_selfcheck() # {"verdict": "confined" | "open", ...}
An allowed check carries a permit signed by the organization. The agent sends it with the call:
chk = agent.check("crm.update", payload)
if chk.allowed: httpx.post("https://crm-tool.internal/update", json=payload, headers=chk.permit_headers) agent.record(chk, output)
The tool runs nothing without a valid permit for exactly this call:
from provenza.permit import PermitMiddleware, PermitVerifier, require_permit
verifier = PermitVerifier("https://provenza.example.com", org="provenza") app = PermitMiddleware(app, verifier, tool="crm.update") # any ASGI app: FastAPI, Starlette, ...
@require_permit(verifier, "db.read") # or a plain function def read(query: str): ...
The verifier checks the signature against the organization's JWKS, the tool, the hash of the JSON body (it must be the checked input) and the expiry. It then redeems the permit with Provenza, so it is used once across every replica of the tool. If Provenza cannot be reached, it refuses.
Each framework is an optional extra. The SDK never requires one: crewai and autogen-core even need conflicting protobuf versions.
Through Provenza's gateways. The call goes through the server, which holds the provider credentials, so it is enforced whatever the agent's code does.
# pip install 'provenza[openai]'
from provenza.integrations.openai import gateway_client, wrap client = gateway_client(agent) # an openai.OpenAI pointed at the LLM gateway, with the agent's key client = wrap(existing_client, agent) # or a copy of one you already configured
from provenza.integrations.mcp import connection, client_config conn = connection(agent) # {"url": ".../api/v1/mcp", "headers": {...}}
MCP clients that start a local command (Claude Desktop, Claude Code, Cursor, Windsurf, Gemini CLI, VS Code): provenza-mcp is the same gateway over stdio. Issue an enrollment token in Provenza (Agents → New agent) and add:
{"mcpServers": {"provenza": {
"command": "uvx", "args": ["--from", "provenza", "provenza-mcp"], "env": {"PROVENZA_URL": "https://provenza.example.com", "PROVENZA_TOKEN": "pvz_enr_..."}}}}
From version 0.2.2 "args": ["provenza"] is enough. On the first start the agent enrolls: its keys are made on that machine, and the token can then be removed. The client sees only the tools an administrator approved, and every call is checked against the organization's policies and recorded. Set PROVENZA_AGENT_NAME to run more than one agent on a machine.
Through the LLM gateway, the server checks allowed models and providers, policies and limits; it stores no prompt or answer. Every model the organization has routed (OpenAI, Anthropic, Azure, …) is reached through this one OpenAI-compatible endpoint. Streaming is not supported yet.
Tool wrappers. These keep the tool's name, description and argument schema, so the model sees no difference:
# pip install 'provenza[langchain]'
from provenza.integrations.langchain import govern_tools tools = govern_tools(agent, [search, read_file]) # a refusal reaches the model as the tool's answer
from provenza.integrations.autogen import govern_tools tools = govern_tools(agent, [FunctionTool(lookup, description="...")])
from provenza.integrations.crewai import govern_tools researcher = crewai.Agent(role="...", goal="...", tools=govern_tools(agent, [search_tool]))
prefix= namespaces the names policies see, so prefix="kb." turns