npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@bitrefill/cli

v0.1.1

Published

Bitrefill - browse, buy, and manage gift cards, mobile top-ups, and eSIMs

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

willewillefurzelfurzel

Keywords

mcpclibitrefillagentsai

Readme

NPM package

@bitrefill/cli

Browse, buy, and manage gift cards, mobile top-ups, and eSIMs from the command line.

The CLI connects to the Bitrefill MCP server and dynamically discovers available tools, exposing each as a subcommand with typed options.

Install

npm install -g @bitrefill/cli

Authentication

OAuth (default)

On first run, the CLI opens your browser for OAuth authorization. Credentials are stored in ~/.config/bitrefill-cli/.

API Key

Generate an API key at bitrefill.com/account/developers and pass it via the --api-key option or the BITREFILL_API_KEY environment variable. This skips the OAuth flow entirely.

# Option
bitrefill --api-key YOUR_API_KEY search-products --query "Netflix"

# Environment variable
export BITREFILL_API_KEY=YOUR_API_KEY
bitrefill search-products --query "Netflix"

# Or copy .env.example to .env and fill in your key
cp .env.example .env

Usage

bitrefill [--api-key <key>] <command> [options]

Examples

# Search for products
bitrefill search-products --query "Netflix"

# Get product details
bitrefill get-product-details --product_id "steam-usa" --currency USDC

# Buy a product
bitrefill buy-products --cart_items '{"product_id": "steam-usa", "package_id": 10}' --payment_method usdc_base

# List your orders
bitrefill list-orders

# List available commands
bitrefill --help

# Clear stored credentials
bitrefill logout

Paying

Flow: get-product-details → pick product_id + package_id → buy-products with --cart_items and --payment_method.

Payment methods

| Method | Chain / asset | Response fields (raw) | |--------|----------------|----------------------| | bitcoin | Bitcoin (SegWit) | address, BIP21, lightningInvoice, satoshiPrice | | lightning | Lightning | lightningInvoice, satoshiPrice | | ethereum | Ethereum mainnet, native ETH | address, paymentUri / BIP21, altcoinPrice (ETH) | | eth_base | Base, native ETH | address, paymentUri (@8453) | | usdc_base | Base (8453) | address, paymentUri, contractAddress (USDC) | | usdc_arbitrum | Arbitrum (42161) | address, paymentUri, contractAddress | | usdc_polygon | Polygon (137) | address, paymentUri, contractAddress | | usdc_erc20 | Ethereum (1) | address, paymentUri, contractAddress | | usdc_solana | Solana | address (base58), contractAddress (USDC SPL) | | usdt_polygon, usdt_erc20 | Same as USDC, USDT | Same shape | | balance | Bitrefill account credit | No address; invoice created and paid from balance |

Response mode

  • --return_payment_link false: response includes address, amount, BIP21 / paymentUri (and for Bitcoin, also lightningInvoice). Use for wallet pay.
  • --return_payment_link true (default): response includes payment_link (browser checkout) and x402_payment_url for programmatic pay.

x402

x402 = HTTP 402 + payment-required header (Base64 JSON: amount, payTo, accepted networks, timeout). GET x402_payment_url → 402 + instructions → send crypto → resubmit with payment proof. For agents/tools; humans use payment_link.

Check status: get-invoice-by-id --invoice_id <id>.

Legal