MoltsPay Client Skill
Pay for AI services using USDC on Base chain. No gas needed.
When to Use
- User asks to generate a video, image, or use any paid AI service
- User asks about wallet balance or payment history
- User wants to discover available services
- User mentions "pay", "buy", "purchase" + AI service
Available Commands
The moltspay CLI provides these commands:
| Command | Description |
|---|---|
moltspay init --chain base | Create wallet (first time only) |
moltspay status | Check balance and limits |
moltspay config | Modify spending limits |
moltspay pay <url> <service> | Pay for a service |
Wallet Setup
On first use, initialize the wallet with sensible defaults:
- Chain: Base (mainnet)
- Max per transaction: $2 USDC
- Daily limit: $10 USDC
After setup, tell user their wallet address and that they need to fund it with USDC on Base.
Discover Services
MoltsPay API
Query available services:
- Search:
GET https://moltspay.com/api/search?q=<keyword> - List all:
GET https://moltspay.com/api/services
Provider Discovery
Providers publish services at /.well-known/agent-services.json
Example: https://juai8.com/.well-known/agent-services.json
Present results as a table to users:
| Service | Price | Description |
|---|---|---|
| text-to-video | $0.99 | Generate video from text prompt |
| image-to-video | $1.49 | Animate an image |
Never show raw JSON to users - always format nicely.
Paying for Services
Use the moltspay pay command with the provider URL and service ID.
Parameters vary by service:
--promptfor text-based services--imagefor image-based services--durationfor video length
Example: Zen7 video generation at https://juai8.com/zen7
Spending Limits
Users can configure:
- max-per-tx: Maximum per transaction (default $2)
- max-per-day: Daily spending limit (default $10)
Use moltspay config to modify limits.
Common User Requests
"Generate a video of X"
- Check wallet status
- If not initialized → init first
- If balance is 0 → tell user to fund wallet
- If funded → pay for text-to-video service
- Return video URL to user
"What's my balance?"
Run status check and report balance, limits, and today's usage.
"What services are available?"
Query the MoltsPay API, format results as a clean list with prices.
Error Handling
| Error | Solution |
|---|---|
| Insufficient balance | Tell user to fund wallet with USDC on Base |
| Exceeds daily limit | Wait until tomorrow, or increase limit |
| Exceeds per-tx limit | Increase limit with config command |
| Service not found | Verify service URL and ID |
Funding Instructions
Tell users:
- Get wallet address from status command
- Send USDC on Base chain to that address
- Use Coinbase, MetaMask, or any Base-compatible wallet
- No ETH needed (gasless transactions)
Links
- Docs: https://moltspay.com/docs
- Services: https://moltspay.com/services
- GitHub: https://github.com/Yaqing2023/moltspay