x402-payment

name	x402-payment
description	Pay x402-compatible URLs by opening a local browser page for MetaMask signing. Use when a URL returns HTTP 402 or when you know a URL requires x402 payment.

x402 Payment Skill

When you need to access a URL that requires x402 payment (HTTP 402 Payment Required), use this skill to handle the full payment flow. The script opens a temporary browser page for the user to sign the payment with MetaMask, then retries the request with the signed payment header.

When to Use

• A URL returns HTTP 402 Payment Required
• The user asks you to pay for / access an x402-gated resource
• The user provides a URL that you know requires x402 payment

How to Invoke

Run the payment script using Bash:

python3 SKILL_DIR/x402_pay.py <url> [--method METHOD] [--body '{"key":"value"}'] [--headers '{"Authorization":"Bearer xxx"}'] [--timeout 120]

Replace SKILL_DIR with the absolute path to this skill's directory.

Arguments

Argument	Default	Description
url	(required)	The x402-compatible URL to call
--method	GET	HTTP method
--body	none	Request body as JSON string
--headers	none	Additional HTTP headers as JSON string
--timeout