DEV Community

Nathaniel Cruz
Nathaniel Cruz

Posted on

How to monetize your AI agent tools with x402 micropayments

#tutorial

If you've built something an AI agent could use — a data feed, a specialized search API, a tool that does one thing well — you've probably noticed there's no obvious way to charge for it.

You could build auth, track API keys, send invoices, set up Stripe, handle webhooks. Or you could just not, and let people use it for free.

Neither option is great. The payment infrastructure wasn't designed for agents. Agents don't sign up for things. They don't have credit cards. They can't click an OAuth flow.

x402 changes that.

What x402 actually is

HTTP 402 has been a reserved status code since 1991. It means "payment required." Nobody used it because there was no standard way to pay.

The x402 spec gives it meaning: when a request hits a protected endpoint, the server returns 402 with a JSON body describing the payment. The agent reads it, signs a USDC microtransaction on Base L2, and retries with an X-PAYMENT header. The server verifies the payment onchain and returns the data.

No API keys. No signup forms. No billing dashboards. The agent handles the entire transaction in under a second.

Here's what a payment request looks like when an agent probes your endpoint:

{
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "10000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0xYourWalletAddress",
    "description": "real-time DeFi yield data"
  }]
}
Enter fullscreen mode Exit fullscreen mode

maxAmountRequired: 10000 is 10,000 USDC-base-units — $0.01. The agent pays it, gets the data, moves on. No friction. No account required.

What SKILL.md is

SKILL.md is a capability description file that lives at the root of your tool's repository. Think of it as package.json for agent capabilities — it tells agent runtimes what your tool does, how to access it, and what it costs.

Claude, Codex CLI, VS Code Copilot, and AWS Kiro now read SKILL.md files as part of tool discovery. When an agent is assembling its tool inventory, it can find and configure your skill automatically without a human writing integration code.

A minimal SKILL.md looks like this:

---
name: defi-yield-monitor
description: "Returns live DeFi pool yields across 5 chains, risk-adjusted"
version: 1.0.0
price: 0.01 USDC per call
payment: x402
endpoint: https://yourapi.com/v1/yields
schema: https://yourapi.com/v1/schema.json
---

Returns the top 50 DeFi pools by risk-adjusted yield. Filters by chain, minimum TVL, and risk tier. Agents use this to optimize yield allocation or monitor portfolio positions.
Enter fullscreen mode Exit fullscreen mode

The combination — SKILL.md for discovery, x402 for payment — means your tool can go from "built" to "earning" without any account management infrastructure.

Why curation matters here

There are open directories indexing 87,000+ unvetted AI skills right now. Some of those submissions are credential-theft tools. Security researchers have documented the pattern: open, unreviewed directories become targets for malicious submissions specifically because agent runtimes consume them automatically.

If your legitimate tool ends up in the same index as malware, agent developers will eventually stop trusting the index. That's not a theoretical risk — it's what's happening.

ClawMerchants curates. Every asset is reviewed before it goes live. Because payment is built in, the economics are different: providers have incentive to maintain quality, because quality keeps the probes coming.

This is the structural difference between a curated payment-backed catalog and an open submission directory. Not better marketing — different trust model.

How to list on ClawMerchants

What gets accepted:

  • APIs returning real-time or frequently updated data (price feeds, analytics, monitoring)
  • Skills with practical agent use cases (not toys or demos)
  • Endpoints with working x402 payment responses
  • SKILL.md file in the repository root

What the process looks like:

  1. Add x402 middleware to your API (reference implementation at x402.org)
  2. Write a SKILL.md with accurate description, pricing, and endpoint
  3. Submit via clawmerchants.com/browse — there's a provider form linked at the bottom
  4. After review, your asset goes live and starts receiving probes immediately

Payment flows directly to your wallet. ClawMerchants takes 5%. Every probe that pays out is a completed transaction — no invoices, no net-30, no chargebacks.

The 223 AI agents currently probing the catalog were attracted to specific assets: real-time DeFi yields, onchain intelligence feeds, financial risk signals. If your tool fits any of those verticals, it gets found.

If you're sitting on a data API or a specialized tool that agents could actually use, x402 + SKILL.md is the fastest path from "built it" to "charging for it." No billing infrastructure required.

Browse the current catalog at clawmerchants.com/browse.

Top comments (0)