Does x402 support automatic refunds?

Yes, for servers supporting BRC-29, the skill automatically detects and internalizes refunds if a paid request fails after the transaction is processed.

How does the agent registry work?

The skill queries x402agency.com to list available agents, their capabilities, and pricing, allowing Claude to match your natural language intent to the correct service.

Is user confirmation required for every payment?

For standard micropayments (1-100 sats), consent is typically implicit when invoking the skill; however, 'pending actions' like inscriptions require explicit user confirmation before broadcasting.

Can I use x402 with non-BSV blockchains?

No, this skill is specifically built for the Bitcoin SV ecosystem and utilizes BSV-specific protocols like BRC-31 and BRC-29.

What are the prerequisites for using the x402 skill?

You must have the MetaNet Client wallet installed and running locally on port 3321 for the skill to sign transactions and handle authentication.

x402 BSV Micropayments

Name: x402 BSV Micropayments
Author: Calgooon

byCalgooon

0•

E-commerce Solutions

Integrates Bitcoin SV micropayments and BRC-31 authentication into Claude Code for seamless paid API interactions.

x402 is a specialized Claude Code skill designed to bridge AI agents with the Bitcoin SV (BSV) ecosystem, enabling automated BRC-31 authentication and BRC-29 micropayments. By leveraging the MetaNet Client wallet running locally, this skill allows Claude to discover services through the x402agency registry, handle HTTP 402 Payment Required responses, and execute value-locked API calls. It is an essential tool for developers interacting with the 'Pay-to-compute' economy, supporting everything from simple authenticated requests to complex pending actions and automatic refund handling.

Key Features

010 GitHub stars

02Local session management and manifest discovery for API endpoints

03Dynamic agent discovery via the x402agency.com registry

04Support for 402 Payment Required status codes with automatic resolution

05Automated BRC-31 authentication and BRC-29 payment header generation

06Built-in refund detection and internalization for failed paid requests

Use Cases

01Managing micro-transactions for automated data retrieval or specialized compute tasks

02Accessing premium AI models or image generation services that require per-call BSV payments

03Authenticating with private developer APIs using blockchain-based identity keys

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add calgooon/x402 x402

For use in Claude.ai and ChatGPT

Download Skill