v3.2.0 — Concierge copy for effortless checkout

Crypto purchases should feel like buying a gift card — not debugging a wallet stack.

What's new

• Concierge voice in SKILL.md — say/never-say substitutions, ≤4 user-visible messages per buy, decide routing in silence, compact receipt + delivery format
• All visible surfaces governed — same rules for assistant text, thinking summaries, and tool-call titles (Claude Chat)
• Point-of-use steering — every reference doc carries a self-contained banner + "User hears" footer and inline (say: …) hints at jargon-heavy steps (SIWX, x402, Base MCP pay, MCP workflow)

Install / update

/plugin marketplace update bitrefill-skills
/plugin update bitrefill@bitrefill-skills
/reload-plugins

Pin: bitrefill/agents@v3.2.0

Full changelog: v3.1.0...v3.2.0

v3.1.0 — Claude Chat shopping UX & routing

Shop on Bitrefill from Claude Chat (and other hosts) with clearer routing, natural language, and fewer mistaken payment flows.

Highlights

Natural shopping language

Agents no longer expose internal routing to users — no "Path 1/2", numbered steps, MCP/x402/SIWX jargon, or "optimal flow" narration. Instructions now map internal concepts to plain copy ("Sign in with your Base wallet", "Approve payment in your Base Account").

Three-phase routing

The skill entry point (SKILL.md) now routes in a fixed order:

1. Detect harness → read the host guide (Claude Chat, OpenClaw, etc.)
2. Detect wallets → read wallet guides (Base MCP, balance, AgentCash, …)
3. Pick touchpoint × wallet → lowest-friction stack for browse vs buy, account vs guest

Claude Chat harness fixes

• Detection: show_widget / read_me / MCP connectors on claude.ai — not "missing exec"
• Sandbox: code execution is always available; egress is variable — agents probe once per session
• Guest checkout: Base MCP wallet sign-in + one payment approval — not pay-per-call micro-fees per search
• Dual MCP: Bitrefill MCP for catalog when OAuth'd; Base MCP for USDC pay

Install / update

/plugin marketplace update bitrefill-skills
/plugin update bitrefill@bitrefill-skills
/reload-plugins

Pin: bitrefill/agents@v3.1.0

Claude Chat setup: use-with-claude-chat

Changed files

• skills/bitrefill/SKILL.md — user voice + three-phase routing
• skills/bitrefill/references/harnesses/claude-chat.md — detection, egress probe, guest checkout
• skills/bitrefill/references/harnesses/decision-engine.md — aligned phases + Claude Chat override
• skills/bitrefill/references/touchpoints/x402.md — user-facing phrasing table
• skills/bitrefill/references/wallets/siwx.md — Base MCP first on Claude Chat

Assets

• bitrefill.zip — plugin bundle (manifest, MCP config, skill)

Full changelog: v3.0.0...v3.1.0

v3.0.0

Bitrefill plugin v3.0.0

Major release: capability-based routing — probe harness → pick touchpoint → derive wallet at pay time. Lowest human-in-the-loop wins.

Highlights

• Three-axis routing model — agents no longer follow a fixed MCP-or-CLI path. The skill probes exec, egress, MCP availability, and wallet stack, then picks the best catalog/checkout channel and payment method for that host.
• Guest agent-commerce first — x402 REST via Base MCP and AgentCash for USDC on Base without a Bitrefill account; signed-in balance and OAuth MCP when the user already has an account.
• Dedicated harness guides — OpenClaw and Claude Chat (claude.ai + MCP + show_widget) get first-class routing docs instead of one-size-fits-all instructions.

New reference layout

References reorganized under three directories:

Directory	Purpose
references/harnesses/	Host capability probe, per-host defaults, OpenClaw, Claude Chat
references/touchpoints/	Catalog/checkout channels: MCP, x402, CLI, API, browse
references/wallets/	Pay-time wallet selection, SIWX, Base MCP, AgentCash, CDP awal, MetaMask, Phantom

New docs

Harnesses

• decision-engine.md — step-by-step capability probe and touchpoint/wallet derivation
• claude-chat.md — MCP-first routing for claude.ai, sandbox vs chat MCP egress, product widgets

Touchpoints

• x402.md — guest USDC checkout via x402 REST (JWT Path 1, approval Path 2)

Wallets

• matrix.md — wallet × touchpoint × HITL ranking
• payment.md — pay-time decision tree
• base-mcp.md, agentcash.md, cdp-awal.md, metamask.md, phantom.md, siwx.md

Scripts

• scripts/siwx_build_message.js — build SIWX sign-in messages for wallet connect flows
• scripts/siwx_send.js — submit signed SIWX to Bitrefill auth endpoints

Updated

• SKILL.md — rewritten routing table; references harness/touchpoint/wallet split
• capability-matrix.md — condensed per-host exec/egress stacks (moved to harnesses/)
• openclaw.md — guest CLI + capability routing (renamed from host-openclaw.md)
• Touchpoint docs (mcp, cli, cli-headless-auth, api, browse) — paths and cross-links updated
• safeguards.md, troubleshooting.md — aligned with multi-wallet, multi-touchpoint flows
• README.md — v3.0 status and new reference paths

Breaking changes (v2.x → v3.0)

• Flat references/*.md paths removed — update any bookmarks or hard-coded links to harnesses/, touchpoints/, or wallets/ subpaths
• Routing is capability-driven, not channel-first — agents should read decision-engine.md before assuming MCP or CLI

Distribution

• .claude-plugin/plugin.json and marketplace.json: 3.0.0
• Skill metadata: 3.0.0
• Release asset: bitrefill.zip (skill bundle)

Install (Claude Code)

/plugin marketplace add bitrefill/agents
/plugin install bitrefill@bitrefill-skills
/reload-plugins

Update

/plugin marketplace update bitrefill-skills
/plugin update bitrefill@bitrefill-skills
/reload-plugins

Cowork: Customize → Plugins → add marketplace bitrefill/agents → install bitrefill. claude.ai: MCP connectors only (not plugins) — see skills/bitrefill/references/harnesses/claude-chat.md.

Full Changelog: v2.1.5...v3.0.0

What's Changed

• Release v3.0.0 — harness × touchpoint × wallet routing by @marcopesani in #4

Full Changelog: v2.1.5...v3.0.0

v2.1.5

Bitrefill plugin v2.1.5

Skill docs for @bitrefill/cli 0.3.0 — headless agent auth, guest checkout, and OpenClaw routing.

Highlights

• Guest checkout first — agents can search, quote, and buy with buy-products --email + crypto or payment link. No login required. Fastest way to try Bitrefill autonomously.
• Sign up when it matters — login / verify unlock store-credit balance, cashback rewards, and order history. Human pre-funds spending cap via account balance.
• OpenClaw prefers guest CLI — default purchase path is exec: bitrefill … before MCP or signed-in flows.

New

• references/cli-headless-auth.md — headless sign-in with AgentMail or equivalent inbox; 1Password TOTP via official op read / op item get --otp.

CLI path (references/cli.md)

• Rewritten for CLI ≥ 0.3.0: removed --api-key, BITREFILL_API_KEY, credentials.json, browser OAuth.
• Documented magic-link auth: login --email → verify --code [→ --otp for 2FA].
• Guest vs signed-in payment matrix; whoami, reset, manifest.
• Verify gotchas from real agent sessions (email code vs TOTP, login hidden after sign-in).

OpenClaw (references/host-openclaw.md)

• Path priority: guest CLI → signed-in CLI → MCP → API → Browse.
• Telegram, cron, camera, and heartbeat scenarios use exec: bitrefill ….
• MCP demoted to optional; no API key env required for first purchase.

Also updated

• SKILL.md — routing, compatibility, reference table.
• troubleshooting.md — CLI 0.3.0 auth errors and verify pitfalls.
• safeguards.md — agent-owned inbox; OpenClaw guest-first policy.
• capability-matrix.md — OpenClaw guest CLI default.

Distribution

• .claude-plugin/plugin.json and marketplace.json: 2.1.5.

Full Changelog: v2.1.2...v2.1.5

v2.1.2

Bitrefill plugin v2.1.2

Skill

• references/cli.md: aligned with @bitrefill/cli 0.2.0 — bitrefill init, llm-context, global --api-key / --json / --no-interactive, credentials.json vs OAuth state, OpenClaw bootstrap pointer.
• references/troubleshooting.md: OAuth / credential paths updated; bitrefill init as first-time fix.
• Skill metadata version: 2.1.0.

Distribution

• .claude-plugin/plugin.json and marketplace.json: 2.1.2.

Full Changelog: v2.1.1...v2.1.2

v2.1.1

Highlights

• Single bitrefill skill replaces separate bitrefill-cli and bitrefill-website skills with a capability decision tree and shared references.
• Bundled eCommerce MCP via .mcp.json (OAuth) for typed catalog and purchase flows.
• Reference layout: api, cli, mcp, browse, host-openclaw, capability-matrix, safeguards, troubleshooting.

Install

/plugin marketplace add bitrefill/agents
/plugin install bitrefill@bitrefill-skills

Plugin version: 2.1.1 (see .claude-plugin/plugin.json).

What's Changed

• Unified bitrefill skill (v2.0.0) + bundled eCommerce MCP connector (v2.1.0) by @marcopesani in #1

New Contributors

• @marcopesani made their first contribution in #1

Full Changelog: v1.5.0...v2.1.1

v1.5.0

Full Changelog: v1.4.0...v1.5.0

v1.4.0

Full Changelog: v1.3.2...v1.4.0

v1.3.2

Full Changelog: 1.3.1...v1.3.2

1.3.1

Full Changelog: v1.3.0...1.3.1