Skip to main content
Glama
deenesjakoruzh
100xPercent

pop-pay

by 100xPercent
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

PyPI version License: MIT CI Python 3.10+

Point One Percent — pop-pay

这是 AI 代理商业活动的运行时安全层。提供即插即用的 CLI + MCP 服务器。卡片凭据通过 CDP 直接注入到浏览器 DOM 中——它们永远不会进入代理的上下文窗口。一个产生幻觉的提示词无法耗尽它看不见的钱包。

安装

选择你偏好的方法：

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

所有安装路径都会暴露 CLI 二进制文件：pop-launch、pop-init-vault、pop-unlock 和 pop-pay（仪表板启动器）。

使用 Node.js / JavaScript？ 查看 pop-pay (npm) — npm i -g pop-pay 或 brew install 100xpercent/tap/pop-pay。相同的安全模型，相同的保险库格式，独立的发布周期——在运行时之间切换是安全的。

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

快速入门 (CLI)

1. 初始化加密凭据保险库

pop-init-vault

这将把你的卡片凭据加密到 ~/.config/pop-pay/vault.enc (AES-256-GCM) 中。为了获得更强的保护（阻止具有 shell 访问权限的代理）：

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

2. 使用 CDP 远程调试启动 Chrome

pop-launch

在 http://localhost:9222 上打开一个 Chromium 实例，pop-pay 会将凭据注入其中。你的代理（通过 MCP、浏览器自动化或 x402）随后驱动结账流程——卡片详细信息永远不会离开浏览器进程。

3. 打开监控仪表板（可选）

pop-pay

实时查看代理支付活动、预算使用情况和拒绝日志。

4. 接入你的代理

支持两种集成路径：

  • MCP 服务器 — 将 pop-pay 添加到任何兼容 MCP 的客户端（Claude Code、OpenClaw）。请参阅下方的 MCP 服务器。

  • Python SDK / LangChain — 请参阅下方的 Python SDK。

MCP 服务器 (可选)

MCP 服务器作为 Python 模块调用，并在启动时解密保险库。

添加到你的 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

使用环境变量：

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

兼容任何 MCP 主机。请参阅 集成指南 获取设置说明和系统提示词模板。

docker-compose up -d

运行带有 CDP 的 MCP 服务器 + 无头 Chromium。从主机挂载你的加密保险库。请参阅 docker-compose.yml 获取配置。

MCP 工具

工具

描述

request_virtual_card

发行虚拟卡并通过 CDP 将凭据注入结账页面。

request_purchaser_info

自动填充账单/联系信息（姓名、地址、电子邮件、电话）。

request_x402_payment

通过 x402 HTTP 支付协议支付 API 调用费用。

page_snapshot

扫描结账页面以查找隐藏的提示词注入或异常。

配置

~/.config/pop-pay/.env 中的核心变量。请参阅 ENV_REFERENCE.md 获取完整列表。

变量

默认值

描述

POP_ALLOWED_CATEGORIES

["aws","cloudflare"]

批准的供应商类别 — 请参阅 类别手册

POP_MAX_PER_TX

100.0

每笔交易的最大美元金额

POP_MAX_DAILY

500.0

每天的最大美元金额

POP_BLOCK_LOOPS

true

阻止幻觉/重试循环

POP_AUTO_INJECT

true

启用 CDP 卡片注入

POP_GUARDRAIL_ENGINE

keyword

keyword (零成本) 或 llm (语义)

护栏模式

keyword (默认)

llm

机制

对推理字符串进行关键字匹配

通过 LLM 进行语义分析

成本

零 — 无 API 调用

每个请求一次 LLM 调用

最适合

开发、低风险工作流

生产环境、高价值交易

要启用 LLM 模式，请参阅 集成指南 §1。

提供商

提供商

描述

BYOC (默认)

自带卡片 — 加密保险库凭据，本地 CDP 注入。

Stripe Issuing

通过 Stripe API 获取真实虚拟卡。需要 POP_STRIPE_KEY。

Lithic

多发行商适配器 (Stripe Issuing / Lithic)。

Mock

用于开发的带有生成卡号的测试模式。

优先级： Stripe Issuing → BYOC Local → Mock。

Python SDK

将 pop-pay 集成到自定义 Python 或 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")

请参阅 集成指南 §2 获取完整的 SDK 和提供商参考。

安全性

层级

防御

上下文隔离

卡片凭据永远不会进入代理的上下文窗口或日志

加密保险库

带有 PBKDF2 密钥派生和操作系统密钥环集成的 AES-256-GCM

TOCTOU 护栏

在 CDP 注入瞬间验证域名 — 阻止重定向攻击

Repr 脱敏

在所有 MCP 响应、日志和回溯中自动屏蔽 (****-4242)

请参阅 THREAT_MODEL.md 获取完整的 STRIDE 分析，并参阅 COMPLIANCE_FAQ.md 获取企业详细信息。

架构

  • Python — 核心引擎、MCP 服务器、护栏逻辑、CLI

  • Cython — 性能关键的保险库操作和内存保护

  • Chrome DevTools Protocol — 通过原始 WebSocket 直接注入 DOM

  • SQLite — 本地交易审计和状态管理

文档

许可证

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • remit.md MCP Server

    pay-skill
    A
    license
    Not graded
    quality
    F
    maintenance
    Enables AI agents to perform financial transactions such as direct payments, escrows, and bounty management using natural language with zero code integration. It provides a comprehensive suite of tools for fund streaming, subscriptions, and reputation tracking to facilitate secure agent-to-agent commerce.
    22
    MIT

  • Arbor

    advaitgore
    A
    license
    Not graded
    quality
    C
    maintenance
    AgentPay is the authorization layer between an AI agent and real spending. You define the rules — spending caps, allowed merchants, time windows — and every purchase attempt the agent makes is checked against them in real time. Approved transactions go through. Anything outside the mandate is blocked and logged. No more babysitting every agent action. No more runaway charges.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/100xPercent/pop-pay-python'

If you have feedback or need assistance with the MCP directory API, please join our Discord server