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

すべてのインストールパスで、pop-launch、pop-init-vault、pop-unlock、および pop-pay（ダッシュボードランチャー）のCLIバイナリが公開されます。

Node.js / JavaScriptを使用していますか？ pop-pay (npm) をチェックしてください — npm i -g pop-pay または brew install 100xpercent/tap/pop-pay。同じセキュリティモデル、同じボルト形式、独立したリリースサイクルを採用しており、ランタイム間の切り替えも安全です。

Related MCP server: Arbor

クイックスタート (CLI)

1. 暗号化された認証情報ボルトの初期化

pop-init-vault

これにより、カードの認証情報が ~/.config/pop-pay/vault.enc (AES-256-GCM) に暗号化されます。より強力な保護（シェルアクセスを持つエージェントをブロック）を行うには：

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. エージェントに接続する

2つのサポートされている統合パスがあります：

• MCPサーバー — MCP互換クライアント（Claude Code、OpenClawなど）にpop-payを追加します。以下の 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

MCPサーバーとCDP付きのヘッドレスChromiumを実行します。ホストから暗号化されたボルトをマウントしてください。設定については docker-compose.yml を参照してください。

MCPツール

設定

~/.config/pop-pay/.env 内のコア変数。完全なリストについては ENV_REFERENCE.md を参照してください。

ガードレールモード

LLMモードを有効にするには、統合ガイド §1 を参照してください。

プロバイダー

優先順位: 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")

完全なSDKとプロバイダーのリファレンスについては、統合ガイド §2 を参照してください。

セキュリティ

完全なSTRIDE分析については THREAT_MODEL.md を、エンタープライズ向けの詳細については COMPLIANCE_FAQ.md を参照してください。

アーキテクチャ

• Python — コアエンジン、MCPサーバー、ガードレールロジック、CLI

• Cython — パフォーマンスが重要なボルト操作とメモリ保護

• Chrome DevTools Protocol — 生のWebSocket経由の直接DOM注入

• SQLite — ローカル取引監査と状態管理

ドキュメント

• 脅威モデル — STRIDE分析、5つのセキュリティプリミティブ、10の攻撃シナリオ

• ガードレールベンチマーク — 585のペイロード、11の攻撃カテゴリにわたるクロスモデル評価 (Anthropic / OpenAI / Gemini)

• コンプライアンスFAQ — PCI DSS、SOC 2、GDPRの詳細

• 環境変数リファレンス — すべての POP_* 環境変数

• 統合ガイド — Claude Code、Python SDK、ブラウザエージェントのセットアップ

• カテゴリクックブック — POP_ALLOWED_CATEGORIES のパターンと例

ライセンス

MIT