# brianbooms-mcp

MCP server for [Brian Booms](https://brianbooms.com)' agent-commerce storefront — ambient music, ringtones, wallpapers, track leases, game licenses, and custom commissions, all buyable by AI agents with USDC on Base via x402.

## Install

```json
{
  "mcpServers": {
    "brianbooms": {
      "command": "npx",
      "args": ["-y", "github:brianbooms/brianbooms-mcp"]
    }
  }
}
```

No API key. No account. The server is read-only discovery — your agent pays with its own x402/EVM wallet.

## Tools

| Tool | What it does |
|---|---|
| `catalog` | List all 22 products: sku, name, USD price |
| `product` | Full details for one SKU: description, price, delivery, buy URL |
| `purchase_instructions` | Exact live x402 payment requirements for a SKU (pay-to, amount, asset, network), parsed from its 402 response |
| `payment_format` | Byte-exact X-PAYMENT header construction guide — call BEFORE the first payment attempt |
| `rewards` | Booms Rewards explainer: buyer earn rates (10%, 15% first purchase, 20% via referral), 5% referral earnings, and free merchant enrollment |

## Buy flow

1. `catalog` → pick a product.
2. `purchase_instructions` → get exact payment requirements.
3. `payment_format` → byte-exact X-PAYMENT header construction (prevents 80%+ of payment failures).
4. Your agent pays with any x402 v1 client (USDC on Base, facilitator `facilitator.xpay.sh`).
5. The 200 response is the order: instant download link, or fulfillment status for commissions/licenses.

Buyers earn 10% back in Booms Rewards credit on every purchase (15% on the first). Merchants join free: https://brianbooms.com/partner/

## License

MIT