Point One Percent — pop-pay

Die Laufzeitsicherheitsschicht für den Handel mit KI-Agenten. Drop-in CLI + MCP-Server. Kartendaten werden direkt über CDP in das Browser-DOM injiziert — sie gelangen niemals in das Kontextfenster des Agenten. Ein halluzinierter Prompt kann keinen Geldbeutel leeren, den er nicht sehen kann.

Installation

Wählen Sie Ihre bevorzugte Methode:

pipx install "pop-pay[mcp]"

pip install "pop-pay[mcp]"

uv tool install "pop-pay[mcp]"

pip install "pop-pay"                  # core (keyword guardrail + mock provider)
pip install "pop-pay[mcp,browser]"     # CDP injection (browser automation)
pip install "pop-pay[mcp,llm]"         # LLM guardrails (OpenAI, Ollama, vLLM, OpenRouter)
pip install "pop-pay[stripe]"          # Stripe virtual card issuing
pip install "pop-pay[langchain]"       # LangChain integration
pip install "pop-pay[all]"             # everything

Alle Installationspfade stellen die CLI-Binärdateien bereit: pop-launch, pop-init-vault, pop-unlock und pop-pay (Dashboard-Launcher).

Verwenden Sie Node.js / JavaScript? Schauen Sie sich pop-pay (npm) an — npm i -g pop-pay oder brew install 100xpercent/tap/pop-pay. Dasselbe Sicherheitsmodell, dasselbe Vault-Format, unabhängiger Release-Zyklus — sicher zwischen Runtimes zu wechseln.

Related MCP server: 🍋 LemonCake — Billing & budgets for AI agents

Schnellstart (CLI)

1. Initialisieren Sie den verschlüsselten Anmeldedaten-Vault

pop-init-vault

Dies verschlüsselt Ihre Kartendaten in ~/.config/pop-pay/vault.enc (AES-256-GCM). Für stärkeren Schutz (blockiert Agenten mit Shell-Zugriff):

pop-init-vault --passphrase   # one-time setup
pop-unlock                     # run once per session

2. Starten Sie Chrome mit CDP-Remote-Debugging

pop-launch

Öffnet eine Chromium-Instanz auf http://localhost:9222, in die pop-pay Anmeldedaten injiziert. Ihr Agent (via MCP, Browser-Automatisierung oder x402) steuert dann den Checkout-Flow — Kartendaten verlassen niemals den Browser-Prozess.

3. Öffnen Sie das Monitoring-Dashboard (optional)

pop-pay

Echtzeitansicht der Zahlungsaktivitäten des Agenten, der Budgetauslastung und der Ablehnungsprotokolle.

4. Verbinden Sie Ihren Agenten

Zwei unterstützte Integrationspfade:

• MCP-Server — fügen Sie pop-pay zu jedem MCP-kompatiblen Client hinzu (Claude Code, OpenClaw). Siehe MCP-Server unten.

• Python SDK / LangChain — siehe Python SDK unten.

MCP-Server (optional)

Der MCP-Server wird als Python-Modul aufgerufen und entschlüsselt den Vault beim Start.

Zu Ihrem MCP-Client hinzufügen

{
  "mcpServers": {
    "pop-pay": {
      "command": "python3",
      "args": ["-m", "pop_pay.mcp_server"],
      "env": {
        "POP_CDP_URL": "http://localhost:9222"
      }
    }
  }
}

claude mcp add pop-pay -- python3 -m pop_pay.mcp_server

Mit Umgebungsvariablen:

claude mcp add pop-pay \
  -e POP_CDP_URL=http://localhost:9222 \
  -e POP_ALLOWED_CATEGORIES='["aws","cloudflare"]' \
  -e POP_MAX_PER_TX=100.0 \
  -e POP_MAX_DAILY=500.0 \
  -e POP_GUARDRAIL_ENGINE=keyword \
  -- python3 -m pop_pay.mcp_server

Kompatibel mit jedem MCP-Host. Siehe den Integrationsleitfaden für Einrichtungsanweisungen und System-Prompt-Vorlagen.

docker-compose up -d

Führt den MCP-Server + Headless Chromium mit CDP aus. Mounten Sie Ihren verschlüsselten Vault vom Host. Siehe docker-compose.yml für die Konfiguration.

MCP-Tools

Konfiguration

Kernvariablen in ~/.config/pop-pay/.env. Siehe ENV_REFERENCE.md für die vollständige Liste.

Guardrail-Modus

Um den LLM-Modus zu aktivieren, siehe Integrationsleitfaden §1.

Anbieter

Priorität: Stripe Issuing → BYOC Local → Mock.

Python SDK

Integrieren Sie pop-pay in benutzerdefinierte Python- oder LangChain-Workflows:

from pop_pay.client import PopClient
from pop_pay.providers.stripe_mock import MockStripeProvider
from pop_pay.core.models import GuardrailPolicy

client = PopClient(
    provider=MockStripeProvider(),
    policy=GuardrailPolicy(
        allowed_categories=["API", "Cloud"],
        max_amount_per_tx=50.0,
        max_daily_budget=200.0,
    ),
)

# LangChain integration
from pop_pay.tools.langchain import PopPaymentTool
tool = PopPaymentTool(client=client, agent_id="agent-01")

Siehe Integrationsleitfaden §2 für die vollständige SDK- und Anbieterreferenz.

Sicherheit

Siehe THREAT_MODEL.md für die vollständige STRIDE-Analyse und COMPLIANCE_FAQ.md für Unternehmensdetails.

Architektur

• Python — Kern-Engine, MCP-Server, Guardrail-Logik, CLI

• Cython — Leistungskritische Vault-Operationen und Speicherschutz

• Chrome DevTools Protocol — Direkte DOM-Injektion via Raw-WebSocket

• SQLite — Lokale Transaktionsprüfung und Zustandsverwaltung

Dokumentation

• Bedrohungsmodell — STRIDE-Analyse, 5 Sicherheitsprimitive, 10 Angriffsszenarien

• Guardrail-Benchmark — Modellübergreifende Evaluierung (Anthropic / OpenAI / Gemini) über 585 Payloads, 11 Angriffskategorien

• Compliance-FAQ — PCI DSS, SOC 2, DSGVO-Details

• Umgebungsreferenz — Alle POP_*-Umgebungsvariablen

• Integrationsleitfaden — Einrichtung für Claude Code, Python SDK und Browser-Agenten

• Kategorien-Kochbuch — POP_ALLOWED_CATEGORIES-Muster und Beispiele

Lizenz

MIT