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
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 4/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 16/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Provenza. Folge https://mcp.popnx.com/i/kironovlaziz-del-provenza.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 17. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Provenza (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (PROVENZA_URL) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Provenza für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "provenza": { "command": "uvx", "args": [ "provenza" ], "env": { "PROVENZA_URL": "your-value", "PROVENZA_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROVENZA_TOKEN, PROVENZA_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Provenza wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
PROVENZA_URL Ihre selbst gehostete Provenza, z. B. https://provenza.example.com Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
SettingsDeveloperEdit Config
{
"mcpServers": {
"provenza": {
"command": "uvx",
"args": [
"provenza"
],
"env": {
"PROVENZA_URL": "your-value",
"PROVENZA_TOKEN": "your-value"
}
}
}
}Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Provenza und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Provenza nutzt, oder ein Werkzeug von Provenza in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
PROVENZA_AGENT_NAME Name des Agenten auf diesem Rechner (Standard: mcp) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Provenza noch nicht verbinden
Provenza läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Provenza verbinden kann
B · Andere in Cybersicherheit, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Provenza (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (PROVENZA_URL) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Provenza für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user provenza --env PROVENZA_URL=your-value --env PROVENZA_TOKEN=your-value -- uvx provenza 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROVENZA_TOKEN, PROVENZA_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Provenza wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
PROVENZA_URL Ihre selbst gehostete Provenza, z. B. https://provenza.example.com Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user provenza --env PROVENZA_URL=your-value --env PROVENZA_TOKEN=your-value -- uvx provenzaErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Provenza sollte in der Liste als verbunden erscheinen
Nutze Provenza und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Provenza nutzt, oder ein Werkzeug von Provenza in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
PROVENZA_AGENT_NAME Name des Agenten auf diesem Rechner (Standard: mcp) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Provenza (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (PROVENZA_URL) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Provenza für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "provenza": { "command": "uvx", "args": [ "provenza" ], "env": { "PROVENZA_URL": "your-value", "PROVENZA_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROVENZA_TOKEN, PROVENZA_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Provenza wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
PROVENZA_URL Ihre selbst gehostete Provenza, z. B. https://provenza.example.com Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
In den Einstellungen von Provenza ist PROVENZA_TOKEN, PROVENZA_URL leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Provenza und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Provenza nutzt, oder ein Werkzeug von Provenza in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
PROVENZA_AGENT_NAME Name des Agenten auf diesem Rechner (Standard: mcp) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Provenza (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (PROVENZA_URL) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Provenza für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "provenza": { "type": "stdio", "command": "uvx", "args": [ "provenza" ], "env": { "PROVENZA_URL": "your-value", "PROVENZA_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei PROVENZA_TOKEN, PROVENZA_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Provenza wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: uv --version
Einmal installieren, gilt für alles, was uv braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
PROVENZA_URL Ihre selbst gehostete Provenza, z. B. https://provenza.example.com Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
VS Code fragt nach einer Bestätigung; klicke Install
In den Einstellungen von Provenza ist PROVENZA_TOKEN, PROVENZA_URL leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Provenza und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Provenza nutzt, oder ein Werkzeug von Provenza in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
PROVENZA_AGENT_NAME Name des Agenten auf diesem Rechner (Standard: mcp) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
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 erforderlich envPROVENZA_TOKEN geheim erforderlich envPROVENZA_AGENT_NAME envBeschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
pypi: provenzaBasierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto kironovlaziz-del bestätigt, dem das Repo gehört
Code zuletzt geändert: gestern
Nutzt Apache-2.0
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Noch nicht geprüft
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/kironovlaziz-del-provenza)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Das musst du eintragen: PROVENZA_TOKEN
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.2.2) kam vorgestern in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.
In derselben Kategorie: GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
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.
| Dieser Provenza | GitHits | Dependency Management MCP Server | Snyk MCP | TokenSafe | Draugr | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | In der Cloud oder auf deinem Rechner | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | In der Cloud oder auf deinem Rechner | Wird auf deinem Rechner installiert |
| Braucht Schlüssel | Ja | Nein | Nein | Nein | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Nein | Nein |
| Basisprüfungen | 3/3 | 5/5 | 3/4 | 3/3 | 5/5 | 3/3 |
| Lizenz | Apache-2.0 | Apache-2.0 | – | Apache-2.0 | MIT | Apache-2.0 |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
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