Point One Percent — pop-pay

La capa de seguridad en tiempo de ejecución para el comercio de agentes de IA. CLI de instalación directa + servidor MCP. Las credenciales de la tarjeta se inyectan directamente en el DOM del navegador a través de CDP; nunca entran en la ventana de contexto del agente. Una instrucción alucinada no puede drenar una billetera que no puede ver.

Instalación

Elige tu método preferido:

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

Todas las rutas de instalación exponen los binarios de la CLI: pop-launch, pop-init-vault, pop-unlock y pop-pay (lanzador del panel de control).

¿Usas Node.js / JavaScript? Echa un vistazo a pop-pay (npm) — npm i -g pop-pay o brew install 100xpercent/tap/pop-pay. Mismo modelo de seguridad, mismo formato de bóveda, ciclo de lanzamiento independiente: es seguro cambiar entre entornos de ejecución.

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

Inicio rápido (CLI)

1. Inicializa la bóveda de credenciales cifrada

pop-init-vault

Esto cifra las credenciales de tu tarjeta en ~/.config/pop-pay/vault.enc (AES-256-GCM). Para una protección más fuerte (bloquea agentes con acceso a la shell):

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

2. Inicia Chrome con depuración remota CDP

pop-launch

Abre una instancia de Chromium en http://localhost:9222 en la que pop-pay inyecta las credenciales. Tu agente (a través de MCP, automatización de navegador o x402) dirige entonces el flujo de pago; los detalles de la tarjeta nunca abandonan el proceso del navegador.

3. Abre el panel de monitoreo (opcional)

pop-pay

Vista en tiempo real de la actividad de pago del agente, utilización del presupuesto y registros de rechazo.

4. Conecta a tu agente

Dos rutas de integración compatibles:

• Servidor MCP — añade pop-pay a cualquier cliente compatible con MCP (Claude Code, OpenClaw). Consulta Servidor MCP a continuación.

• SDK de Python / LangChain — consulta SDK de Python a continuación.

Servidor MCP (opcional)

El servidor MCP se invoca como un módulo de Python y descifra la bóveda al iniciarse.

Añadir a tu cliente MCP

{
  "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

Con variables de entorno:

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

Compatible con cualquier host MCP. Consulta la Guía de integración para obtener instrucciones de configuración y plantillas de System Prompt.

docker-compose up -d

Ejecuta el servidor MCP + Chromium headless con CDP. Monta tu bóveda cifrada desde el host. Consulta docker-compose.yml para la configuración.

Herramientas MCP

Configuración

Variables principales en ~/.config/pop-pay/.env. Consulta ENV_REFERENCE.md para ver la lista completa.

Modo de protección (Guardrail)

Para habilitar el modo LLM, consulta Guía de integración §1.

Proveedores

Prioridad: Stripe Issuing → BYOC Local → Mock.

SDK de Python

Integra pop-pay en flujos de trabajo personalizados de Python o LangChain:

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")

Consulta Guía de integración §2 para obtener la referencia completa del SDK y del proveedor.

Seguridad

Consulta THREAT_MODEL.md para ver el análisis STRIDE completo y COMPLIANCE_FAQ.md para detalles empresariales.

Arquitectura

• Python — Motor principal, servidor MCP, lógica de protección, CLI

• Cython — Operaciones de bóveda críticas para el rendimiento y protección de memoria

• Chrome DevTools Protocol — Inyección directa en el DOM a través de WebSocket sin procesar

• SQLite — Auditoría de transacciones locales y gestión de estado

Documentación

• Modelo de amenazas — Análisis STRIDE, 5 primitivas de seguridad, 10 escenarios de ataque

• Benchmark de protección — Evaluación entre modelos (Anthropic / OpenAI / Gemini) en 585 cargas útiles, 11 categorías de ataque

• Preguntas frecuentes sobre cumplimiento — Detalles de PCI DSS, SOC 2, GDPR

• Referencia de entorno — Todas las variables de entorno POP_*

• Guía de integración — Configuración para Claude Code, SDK de Python y agentes de navegador

• Libro de recetas de categorías — Patrones y ejemplos de POP_ALLOWED_CATEGORIES

Licencia

MIT