Bitrefill Agent Skills

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

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/agents@v3.1.0.

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.

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

{
  "name": "bitrefill-skills",
  "owner": {
    "name": "Bitrefill",
    "email": "support@bitrefill.com"
  },
  "metadata": {
    "description": "Agent skills and bundled eCommerce MCP connector for buying digital goods on Bitrefill with crypto",
    "version": "3.2.0"
  },
  "plugins": [
    {
      "name": "bitrefill",
      "description": "Browse and buy gift cards, mobile top-ups, and eSIMs on Bitrefill — 1,500+ brands, 180+ countries, crypto/x402/balance payments (bundled MCP connector)",
      "source": "./",
      "homepage": "https://www.bitrefill.com",
      "repository": "https://github.com/bitrefill/agents",
      "keywords": [
        "gift-cards",
        "esim",
        "mobile-topup",
        "crypto",
        "bitcoin",
        "lightning",
        "cli",
        "x402",
        "usdc",
        "base"
      ],
      "category": "commerce"
    }
  ]
}