Skills

Sections

Overview

Skills are reusable instruction modules for AI coding agents. They extend what your agent can do — install packages, configure services, scaffold projects — with a single slash command. AgentMall provides a skill that sets up purchasing capabilities in any project.

Supported agents

Claude Code

Cursor

Codex

Windsurf

OpenClaw

How it works

A skill is a directory with a SKILL.md file. When invoked, the agent reads the instructions and executes them using its tools. No API keys, no signup — the skill handles everything.

Claude Code

$ npx skills add agentmallsh/agentmall

What this does

01Downloads the AgentMall skill to .claude/skills/agentmall/

02Creates SKILL.md with purchase instructions and API reference

03Skill is available immediately — no restart needed

Invoke in Claude Code

$ /agentmall

With arguments

$ /agentmall buy headphones from amazon under $50

What the skill does

01Detects your framework and package manager

02Installs the agentmall SDK if not present

03Constructs a purchase request with product URL, address, and budget

04Handles the MPP 402 challenge → payment → retry flow

05Returns order ID and status. Updates sent to buyer email.

Configure for Claude Desktop / Cursor / any MCP client

// claude_desktop_config.json or .cursor/mcp.json
{
  "mcpServers": {
    "agentmall": {
      "command": "npx",
      "args": ["@agentmall/mcp"]
    }
  }
}

Available MCP tools

lookup_productcreate_purchaseget_purchase

Commands

$ npx agentmall [url]                           # Interactive buy flow
$ npx agentmall onboard                        # Create/find a local wallet and show funding steps
$ npx agentmall buy <url>                      # Buy a product
$ npx agentmall status <id>                    # Check order status with the saved buyer token
$ npx agentmall refund <id>                    # Check refund status with the saved buyer token
$ npx agentmall status <id> --buyer-token <amtk_...>
$ npx agentmall refund <id> --buyer-token <amtk_...>
$ npx agentmall help                           # Show help

Interactive flow

01Helps you sign in to Tempo or walks you through onboarding

02Looks up the product first, then shows price, discount, variants, and quantity-aware budget guidance

03Prompts for quantity, variants, address, budget, and email

04Confirms order details, then pays and places the order

05Returns order ID, status, and a saved buyer token for later reads

Directory layout

.claude/skills/agentmall/
└── SKILL.md          # Instructions, API reference, error recovery

SKILL.md frontmatter

---
name: agentmall
description: Buy physical products from US retailers via the
  AgentMall API. Payment is handled via MPP with USDC on Tempo.
metadata: {"openclaw":{"requires":{"bins":["curl"]},"emoji":"🛒"}}
---

# AgentMall — Universal Checkout for AI Agents

Buy physical products from major retailers with a single API call.
Payment uses MPP with USDC on Tempo.

## Recommended Workflow
1. Look up product → GET /api/products?url=<url>
2. Confirm price and variants with user
3. Place order → POST /api/purchases (triggers MPP 402 flow)
4. Check status → npx agentmall status <id> (uses the saved buyer token)
5. Check refund if needed → npx agentmall refund <id>
6. If you placed the order elsewhere, pass --buyer-token <amtk_...>

Skill not showing up?Make sure it's in .claude/skills/agentmall/SKILL.md. No restart needed — skills are discovered automatically.

MCP server not connecting?Check your MCP config JSON. The command should be npx @agentmall/mcp. Purchases still require a Tempo wallet, and follow-up reads need the buyer_token returned by create_purchase.

402 payment failing?Ensure your Tempo wallet has sufficient USDC balance. Run npx agentmall onboard or tempo wallet whoami to check, then use tempo wallet fund if needed.

Product URL rejected?Use the full product page URL (e.g. amazon.com/dp/...). Short links like a.co will fail.

Order stuck in pending?Processing takes 5–10 minutes. Check status with npx agentmall status <id>. If the order was placed elsewhere, pass --buyer-token <amtk_...> or use the buyer_token returned at purchase time.

How do I check a refund?Run npx agentmall refund <id>. If the order was placed elsewhere, pass --buyer-token <amtk_...> or call the refund status API with the buyer_token returned at purchase time.

↑↓

Scroll

123456

Go to sections

ENTERESC

Actions

Twitter(X)