# gift-cards

Buy gift cards, mobile top-ups, and eSIMs from 10,001+ brands across 180 countries. Pay with USDC, USDT, BTC, LTC, ETH, SOL, SUI, TON, TRON and other cryptocurrencies. No account, no OAuth, no API ke…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add cryptorefills/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list cryptorefills/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get cryptorefills/mcp-server purchaseElicitation

# Call a tool
npx -y @smithery/cli@latest tool call cryptorefills/mcp-server purchaseElicitation '{}'
```

## Direct MCP Connection

Endpoint: `https://cryptorefills.run.tools`

## Tools (10)

- `purchaseElicitation` — Interactive, stateful endpoint to guide small-footprint AI agents through a purchase flow for gift cards or mobile top-…
- `getCurrencies` — Fetch supported crypto currencies
- `listBrands` — Fetch available gift-card and mobile top-ups brands for a given country
- `listProductsForCountry` — List all products in a country, optionally filtering by brand, family, coin, payment method, language, or promo code
- `getPaymentViasWithCurrencies` — Fetch possible payment methods and supported currencies/networks
- `getProductPrice` — Get pricing for range-based products where customer can select face value within min/max range
- `validateOrder` — Validate a potential order against minimum amount and business rules
- `createOrder` — Submit a new order with selected products and payment method
- `getOrderStatus` — Retrieve the status and details of a submitted order
- `searchProducts` — Search products by text query across brands and categories in a given country

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get cryptorefills/mcp-server <tool-name>
```