Skill

stripe

Every Stripe feature, plus a local SQLite mirror with FTS, cross-entity SQL, and analytics no other Stripe tool ships.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use stripe

Choose if

You need read-mostly Stripe access from an agent loop with a local SQLite mirror for FTS, cross-entity SQL (payouts → balance_transactions → charges → customers), customer health scoring, and dunning queue management. Pick this over Stripe's official SDK when you want pre-built analytics pivots and live-key mutation gates.

Avoid if

You need Stripe Issuing, Terminal, Tax-registration, or Connect account-fan-out workflows — those are passthrough-only in v0.1 and the README defers full support to v0.2. Also avoid for live production mutations from a non-audited agent loop (gated behind `--confirm-live`, but the underlying risk is still real-money state change) — use sk_test_* keys in agent dev.

Risk Flags

  • HIGH auth Live-mode keys (sk_live_*) grant production payment-state access. The CLI gates mutating commands behind `--confirm-live` after audit, but a leaked live key is a Tier-1 incident. Use sk_test_* for agent dev loops.
  • MEDIUM scope Known gaps deferred to v0.2 — Stripe Issuing full workflow (endpoint passthrough only), Stripe Terminal (passthrough only), Stripe Tax registration (tax-rates CRUD only), Connect account fan-out (single-account at a time). Agents on those surfaces must use Stripe's own SDK.
  • LOW rate_limit Upstream Stripe API enforces rate limits; the README doesn't enumerate them but Stripe's own docs document 100 req/sec read + 100 req/sec write in live mode. Exit code 7 surfaces hits.

Cost

Type: Unknown · Free tier: The CLI binary is free to install. Stripe issues both sk_test_* (sandbox, free) and sk_live_* keys; the CLI accepts both but gates mutating commands against live keys behind `--confirm-live`.

Hidden costs

  • Stripe itself charges per-transaction processing fees (typically 2.9% + $0.30 for US cards, plus international/dispute surcharges — see Stripe's own pricing page). The CLI is free; Stripe API access is included with any Stripe account.

Install

Default

npx -y @mvanhorn/printing-press install stripe
# Use a test-mode key for agent dev loops:
export STRIPE_API_KEY=sk_test_<your-key>
# Live-mode mutations require --confirm-live after audit:
# export STRIPE_API_KEY=sk_live_<your-key>

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js (npx) or Go 1.26.3+

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT