mcpField
M
moonpay-commerce

moonpay-commerce

github.com/moonpayOther11291 installsUpdated 23w ago
Repository

About moonpay-commerce

A CLI skill for browsing Solana Pay-enabled Shopify stores, managing carts, and paying with crypto. It handles checkout through a local wallet, without requiring a browser for the shopping flow.

Key features

  1. 01Browse stores and search products
  2. 02Retrieve product details
  3. 03Add, view, and remove cart items
  4. 04Pay for checkout with a wallet on Solana

Use cases

  1. 01Find products in supported Shopify stores
  2. 02Build a cart from multiple items
  3. 03Pay for an order with crypto from the CLI

MCP support

The skill interacts with Shopify MCP endpoints exposed by stores for browsing and cart management. Checkout starts a Helio payment, signs the transaction locally, and submits it.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/moonpay/skills --skill moonpay-commerce

After installing, type/moonpay-commercein Claude Code to confirm it loaded.

Details

From the project README

Shop with crypto

Goal

Browse Solana Pay-enabled Shopify stores, add items to a cart, and pay with crypto. The entire flow runs from the CLI — no browser needed.

Commands

List stores
mp commerce store list
Search products
mp commerce product search --store <store> --query <search-term>
Get product details
mp commerce product retrieve --store <store> --productId <product-id>
Add item to cart
mp commerce cart add \
  --store <store> \
  --variantId <variant-id> \
  --quantity <number> \
  --cartId <cart-id>  # omit to create a new cart
View cart
mp commerce cart retrieve --store <store> --cartId <cart-id>
Remove item from cart
mp commerce cart remove --store <store> --cartId <cart-id> --lineId <line-id>
Checkout and pay
mp commerce checkout \
  --wallet <wallet-name> \
  --store <store> \
  --cartId <cart-id> \
  --chain solana \
  --email <buyer-email> \
  --firstName <first> \
  --lastName <last> \
  --address <street-address> \
  --city <city> \
  --postalCode <zip> \
  --country <country-name>

Example flow

  1. Browse stores: mp commerce store list
  2. Search: mp commerce product search --store ryder.id --query "ryder"
  3. Add to cart: mp commerce cart add --store ryder.id --variantId "gid://shopify/ProductVariant/51751218774319" --quantity 1
  4. Check cart: mp commerce cart retrieve --store ryder.id --cartId <id-from-step-3>
  5. Checkout: mp commerce checkout --wallet main --store ryder.id --cartId <id> --chain solana --email [email protected] --firstName John --lastName Doe --address "123 Main St" --city Amsterdam --postalCode 1011 --country Netherlands

How it works

  1. Stores expose a Shopify MCP endpoint for browsing and cart management
  2. cart add creates or updates a cart (no auth needed, cart ID is the handle)
  3. checkout calls the API to start a Helio payment, signs the transaction locally, and submits
  4. Helio pays gas — the buyer only pays the item price in USDC
  5. Returns a transaction signature and order confirmation URL

Tips

  • Run cart add multiple times to add different items — pass the --cartId from the first call
  • Use product search to find variant IDs — each variant has a Shopify GID
  • The --country flag takes full country names (e.g. "United States", "Netherlands")
  • Checkout takes 30-90 seconds — the API automates the Shopify checkout flow
  • Currently supports Solana chain only for payment

Related skills

  • moonpay-auth — Set up a local wallet for signing
  • moonpay-check-wallet — Check USDC balance before checkout
  • moonpay-swap-tokens — Swap tokens to get USDC for payment

Comments

Markdown supported