Skip to directory

About CryptoRefills MCP

Official remote MCP for discovering, pricing, validating and ordering digital goods such as gift cards, mobile top-ups and eSIMs.

What you can use it for

  • Search product catalog
  • Get current prices and validate orders
  • Prepare/place digital goods orders
Connection and setup
Hosting
remote
Transport
Streamable HTTP
Endpoint
https://api.cryptorefills.com/mcp/http
Authentication
Official FAQ states no API key or account is required for MCP access; purchases require supported crypto payment and may use x402.

Requirements

  • Remote HTTP MCP client
  • Wallet/payment support for purchases

Setup steps

  1. Add the official MCP endpoint in a compatible client.
  2. Use publisher integration guide for current authentication/payment configuration.
  3. Require explicit user authorization before purchase or payment.
Tools 10

Ten tools come from the recorded unauthenticated tools/list snapshot. Catalog/search/validation are informational; createOrder and purchaseElicitation can initiate actual paid digital-goods orders. Require explicit purchase authorization.

  • purchaseElicitation

    Interactive, stateful endpoint to guide small-footprint AI agents through a purchase flow for gift cards or mobile top-ups. Call repeatedly with the same session_token until 'status' is 'complete' or 'error'. For the first call, provide an empty 'body': {} (session_token will be generated and returned). Provide 'answer' in the body to respond to the current question. Use 'action: back' in the body to go to the previous step. Handles product type selection, country, brand, amount, beneficiary, coin, network, user email, and final confirmation/validation/order creation.

    Parameters: body
    01
  • getCurrencies

    Fetch supported crypto currencies

    02
  • listBrands

    Fetch available gift-card and mobile top-ups brands for a given country

    Parameters: country_code, cid
    03
  • listProductsForCountry

    List all products in a country, optionally filtering by brand, family, coin, payment method, or language

    Parameters: country_code, brand_name, family_name, coin, payment_method, lang
    04
  • getPaymentViasWithCurrencies

    Fetch possible payment methods and supported currencies/networks

    05
  • getProductPrice

    Get pricing for range-based products where customer can select face value within min/max range

    Parameters: brand_name, country_code, face_value, coin
    06
  • validateOrder

    Validate a potential order against minimum amount and business rules

    Parameters: body
    07
  • createOrder

    Submit a new order with selected products and payment method

    Parameters: body
    08
  • getOrderStatus

    Retrieve the status and details of a submitted order

    Parameters: order_id
    09
  • searchProducts

    Search products by text query across brands and categories in a given country

    Parameters: country_code, q, lang
    10
Original sources
  • publisher primary source

    Confirms CryptoRefills MCP implementation identity and documented setup/capability details; fields remain limited to evidence actually captured.

  • official documentation

    Confirms CryptoRefills MCP implementation identity and documented setup/capability details; fields remain limited to evidence actually captured.

  • live runtime tools list

    Unauthenticated JSON-RPC tools/list response; 10 tool names returned with descriptions.

  • official agent documentation

    Current publisher agent docs describe the hosted MCP, no account/API key, product discovery, payment requirements, and order operations.

Documentation checked 2026-10-28. Connection has not been runtime tested.