Skip to main content
skill CX Codex

agent-ready-x402 — Claude Code skill: what it does, how to install

agent-ready-x402 configures x402 payment protocol support for backend routes. Useful when your API needs to accept automated HTTP payments from AI agents.

Apache-2.0 ★ 141 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-x402 -a claude-code
Open on GitHub

What agent-ready-x402 does

This skill guides coding agents through setting up agent-native HTTP payments with the x402 protocol. It helps inject middleware packages into Node.js services, specifically targeting @x402/express, @x402/hono, and @x402/next. Protected endpoints will answer with HTTP 402 Payment Required headers containing payment specs that caller agents handle automatically.

Setup depends on having both a facilitator URL and a destination crypto wallet address. Without those two values configured in the route middleware, payment requests will fail.

You can verify the configuration using the validation endpoint at https://isitagentready.com/api/scan. A passing setup reports pass under checks.commerce.x402.status.

What it helps with

  • integrate the x402 payment protocol into API endpoints
  • configure payment middleware for Express, Hono, or Next.js
  • return HTTP 402 headers with machine-readable payment demands
  • verify agent readiness through the isitagentready scan API

Example prompts for the agent

  • Add @x402/express middleware to my API routes with my wallet address
  • Set up x402 protocol payments for our Next.js backend endpoints
  • Check our domain readiness against the isitagentready scan endpoint

How to install agent-ready-x402

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-x402 -a claude-code

2Manually: put the files in place

~/.claude/skills/x402/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/x402/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-ready-x402

How do I install agent-ready-x402 in Claude Code?

Run npx skills add fabricioctelles/skills --skill x402 -a claude-code in your terminal.

What does agent-ready-x402 do?

It provides agent instructions to implement the x402 protocol, enabling automated micropayments on API routes via HTTP 402 status codes.

Which web frameworks does the skill support?

It covers middleware integration for @x402/express, @x402/hono, and @x402/next.

Source text

SKILL.md · Apache-2.0
---
name: agent-ready-x402
description: >
  Sub-skill de agent-ready-cloudflare: Implement x402 Payment Protocol
---
# Implement x402 Payment Protocol

Support agent-native HTTP payments via the
[x402 protocol](https://x402.org)
([docs](https://docs.x402.org), [GitHub](https://github.com/coinbase/x402)).

## Requirements

- Add x402 payment middleware to your API routes
- Use `@x402/express`, `@x402/hono`, or `@x402/next` middleware
- Configure a facilitator URL and wallet address
- Protected routes return HTTP 402 with payment requirements that agents fulfill automatically

## Validate

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}
```

Check that `checks.commerce.x402.status` is `"pass"`.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Similar skills

All skills for Backend and APIs →

From the same set46

The whole set →
agent-ready-llms-full-txt agent-ready-llms-full-txt — a skill to create and publish /llms-full.txt — expanded site content in a format that LLM agents can parse and use. Helps AI-powered tools understand your project's full documentation and APIs. CX Codex +1 ★ 141repo stars agent-ready-ucp agent-ready-ucp sets up Universal Commerce Protocol to allow content payments on your website. Useful when preparing an API or web service for autonomous agents. CX Codex +1 ★ 141repo stars agent-ready-sitemap The agent-ready-sitemap skill guides an agent through adding and checking an XML sitemap for public site pages. Use it when search crawlers need a clear page index. CX Codex +1 ★ 141repo stars agent-ready-llms-txt The agent-ready-llms-txt skill publishes a /llms.txt file on your site so agents and AI models can quickly understand its structure and content. Use it to make your site agent-ready. CX Codex +1 ★ 141repo stars agent-ready-acp The agent-ready-acp skill guides the publication of an ACP discovery document so AI agents can find an Agentic Commerce Protocol implementation. CX Codex +1 ★ 141repo stars agent-ready-robots-txt The agent-ready-robots-txt skill publishes a standards-compliant robots.txt at your site root per RFC 9309. Use it when agents need to control bot access and reference your sitemap. CX Codex +1 ★ 141repo stars agent-ready-api-catalog agent-ready-api-catalog implements an RFC 9727 API catalog so autonomous agents can discover your endpoints and OpenAPI specifications. CX Codex +1 ★ 141repo stars agent-ready-content-signals The agent-ready-content-signals skill adds Content Signals to robots.txt, letting you set preferences for AI training, search, and AI input. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open