Bitrefill Agent Skills

A unified, capability-aware agent skill for Bitrefill — enabling AI agents to browse, buy, and manage gift cards, mobile top-ups, and eSIMs across 180+ countries with crypto, Lightning, USDC via x402, pre-funded account balance, card, Apple Pay or Google Pay.

Status

Installation

Claude Code / Cowork (plugin: skill + MCP)

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

Registers the bitrefill skill and eCommerce MCP (.mcp.json); OAuth on first MCP call. Pin: bitrefill/[email protected].

Update:

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

Cowork: Customize → Plugins → add bitrefill/agents → install bitrefill. claude.ai: Connectors only → claude-chat.md. Other hosts → mcp.md.

Cursor / Grok Bot (plugin: skill + MCP)

Cursor: Customize → search Bitrefill → Install. Grok Bot: Connect apps → Bitrefill → Add. Both get the skill and the connector in .mcp.json (OAuth with your Bitrefill account). Each purchase is confirmed with you unless you opt into autonomous buying; without a connected account the skill checks out as a guest through npm @bitrefill/cli. Host guide → grok-bot.md. Bitrefill Terms and Privacy Policy apply.

skills CLI

npx skills add bitrefill/agents

With a specific agent (e.g. Cursor):

npx skills add bitrefill/agents -a cursor -y

OpenClaw

Via the cross-host installer:

npx skills add bitrefill/agents -a openclaw -y

Or via OpenClaw’s own ClawHub registry:

openclaw skills install bitrefill
openclaw gateway restart

Then wire the eCommerce MCP for typed purchase tools:

openclaw mcp set bitrefill --url "https://api.bitrefill.com/mcp/$BITREFILL_API_KEY"

Full setup, channel-aware scenarios, and hardening: skills/bitrefill/references/harnesses/openclaw.md.

Skill

Structure

.mcp.json
.claude-plugin/
├── plugin.json
└── marketplace.json
skills/bitrefill/
├── SKILL.md
└── references/
    ├── harnesses/
    │   ├── decision-engine.md
    │   ├── capability-matrix.md
    │   ├── openclaw.md
    │   └── claude-chat.md
    ├── touchpoints/
    │   ├── mcp.md
    │   ├── x402.md
    │   ├── cli.md
    │   ├── cli-headless-auth.md
    │   ├── api.md
    │   └── browse.md
    ├── wallets/
    │   ├── matrix.md
    │   ├── payment.md
    │   ├── base-mcp.md
    │   ├── siwx.md
    │   ├── agentcash.md
    │   ├── cdp-awal.md
    │   ├── metamask.md
    │   └── phantom.md
    ├── safeguards.md
    └── troubleshooting.md

Contributing

To add a new skill:

1. Create a new directory under skills/ (e.g., skills/my-skill/)
2. Add a SKILL.md file with valid YAML frontmatter (name, description) and agent instructions
3. Optionally add a references/ subdirectory with supporting documentation
4. Update .claude-plugin/marketplace.json to register the skill

Skill names must be lowercase with hyphens and match the directory name exactly.

Documentation

For the full Agent Skills specification, see agentskills.io/specification.

License

MIT