Skip to content

Add Bitrefill hybrid plugin for Base MCP agent commerce (verified commits)#107

Open
marcopesani wants to merge 2 commits into
base:masterfrom
marcopesani:plugin/bitrefill-verified
Open

Add Bitrefill hybrid plugin for Base MCP agent commerce (verified commits)#107
marcopesani wants to merge 2 commits into
base:masterfrom
marcopesani:plugin/bitrefill-verified

Conversation

@marcopesani

Copy link
Copy Markdown

Supersedes #87 — same plugin content, rebased on current master with a verified commit.

Summary

Adds skills/base-mcp/plugins/bitrefill.md — a hybrid Bitrefill integration for Base MCP agent commerce. Agents can discover and purchase digital goods (gift cards, mobile top-ups, eSIMs) and settle usdc_base invoices through Base Account on Base.

Design direction (authless-first)

  • Default path is guest checkout — browse, quote, and buy with no account sign-in
  • Shell surfaces → @bitrefill/cli — first command auto-provisions a machine session via client_credentials
  • Shell-less surfaces → Bitrefill MCP — connector OAuth at install only
  • Identity escalates only when needed — account binding reserved for order history, balance pay, etc.
  • Base MCP for onchain settlement — x402 primary, send fallback; both via Base Account approval

Native plugin listing in SKILL.md / tag vocabulary in plugin-spec.md intentionally deferred until this doc is approved.

Live validation

End-to-end purchase tests were run in Cursor with Base MCP + Bitrefill MCP connected (Amazon.it Italy 10 EUR, usdc_base). Onchain proof on Base mainnet:

Path Result BaseScan
x402 via initiate_x402_requestcomplete_x402_request Payment confirmed onchain tx
Direct USDC send fallback Full success — payment_detectedcomplete (~37s) tx
x402 (retried after wallet funded) Full success — payment settled despite HTTP 500 on complete tx

Test plan

  • Plugin conforms to references/plugin-spec.md (frontmatter, sections, conformance table)
  • Bitrefill MCP + CLI paths documented with authless-first routing
  • Base MCP x402 and send fallback orchestration documented
  • Commit cryptographically signed and GitHub-verified
  • Maintainer review

Made with Cursor

Authless-first Bitrefill plugin doc for Base MCP agent commerce: guest
checkout via CLI (shell) or MCP (shell-less), with Base Account USDC
settlement through x402 or send fallback.

Co-authored-by: Cursor <cursoragent@cursor.com>
@cb-heimdall

cb-heimdall commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants