How do I install the Pay For Service skill?

Run npx skillmds@latest add modbender/pay-for-service in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pay For Service safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pay For Service?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pay For Service free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pay For Service?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pay For Service by modbender — Agent Skill

Name: Pay For Service
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Pay For Service

Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service.

modbender Updated Sep 9, 2026 12 repo stars

File contents

Making Paid x402 Requests

Use the npx awal@latest x402 pay command to call paid API endpoints with automatic USDC payment on Base.

Confirm wallet is initialized and authed

npx awal@latest status

If the wallet is not authenticated, refer to the authenticate-wallet skill.

Command Syntax

npx awal@latest x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]

Options

Option	Description
`-X, --method <method>`	HTTP method (default: GET)
`-d, --data <json>`	Request body as JSON string
`-q, --query <params>`	Query parameters as JSON string
`-h, --headers <json>`	Custom HTTP headers as JSON string
`--max-amount <amount>`	Max payment in USDC atomic units (1000000 = $1.00)
`--correlation-id <id>`	Group related operations
`--json`	Output as JSON

USDC Amounts

X402 uses USDC atomic units (6 decimals):

Atomic Units	USD
1000000	$1.00
100000	$0.10
50000	$0.05
10000	$0.01

IMPORTANT: Always single-quote amounts that use $ to prevent bash variable expansion (e.g. '$1.00' not $1.00).

Examples

# Make a GET request (auto-pays)
npx awal@latest x402 pay https://example.com/api/weather

# Make a POST request with body
npx awal@latest x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# Limit max payment to $0.10
npx awal@latest x402 pay https://example.com/api/data --max-amount 100000

Prerequisites

Must be authenticated (npx awal@latest status to check, see authenticate-wallet skill)
Wallet must have sufficient USDC balance (npx awal@latest balance to check)
If you don't know the endpoint URL, use the search-for-service skill to find services first

Error Handling

"Not authenticated" - Run awal auth login <email> first, or see authenticate-wallet skill
"No X402 payment requirements found" - URL may not be an x402 endpoint; use search-for-service to find valid endpoints
"Insufficient balance" - Fund wallet with USDC; see fund skill

---name: pay-for-servicedescription: Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service.--- # Making Paid x402 Requests Use the `npx awal@latest x402 pay` command to call paid API endpoints with automatic USDC payment on Base. ## Confirm wallet is initialized and authed ```bash npx awal@latest status ``` If the wallet is not authenticated, refer to the `authenticate-wallet` skill. ## Command Syntax ```bash npx awal@latest x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json] ``` ## Options | Option | Description | | ----------------------- | -------------------------------------------------- | | `-X, --method <method>` | HTTP method (default: GET) | | `-d, --data <json>` | Request body as JSON string | | `-q, --query <params>` | Query parameters as JSON string | | `-h, --headers <json>` | Custom HTTP headers as JSON string | | `--max-amount <amount>` | Max payment in USDC atomic units (1000000 = $1.00) | | `--correlation-id <id>` | Group related operations | | `--json` | Output as JSON | ## USDC Amounts X402 uses USDC atomic units (6 decimals): | Atomic Units | USD | | ------------ | ----- | | 1000000 | $1.00 | | 100000 | $0.10 | | 50000 | $0.05 | | 10000 | $0.01 | **IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`). ## Examples ```bash # Make a GET request (auto-pays) npx awal@latest x402 pay https://example.com/api/weather # Make a POST request with body npx awal@latest x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}' # Limit max payment to $0.10 npx awal@latest x402 pay https://example.com/api/data --max-amount 100000 ``` ## Prerequisites - Must be authenticated (`npx awal@latest status` to check, see `authenticate-wallet` skill) - Wallet must have sufficient USDC balance (`npx awal@latest balance` to check) - If you don't know the endpoint URL, use the `search-for-service` skill to find services first ## Error Handling - "Not authenticated" - Run `awal auth login <email>` first, or see `authenticate-wallet` skill - "No X402 payment requirements found" - URL may not be an x402 endpoint; use `search-for-service` to find valid endpoints - "Insufficient balance" - Fund wallet with USDC; see `fund` skill

Frequently asked questions