Official agent skill

Pay For HTTP Request

by stripe in stripe/purl

Make HTTP requests with automatic x402 payment support using the purl command line interface.

OfficialMITAuto-check passed

Install Pay For HTTP Request

skills CLI
$ npx skills add stripe/purl --skill pay-for-http-request -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install stripe/purl pay-for-http-request --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/stripe/purl.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pay-for-http-request .claude/skills/pay-for-http-request && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pay-for-http-request
GitHub stars
181
Token cost
~1.7k tokens
SKILL.md length
596 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Make HTTP requests with automatic x402 payment support using the purl command line interface.

  • Works in 3 steps: Create a wallet: purl wallet add → Set up a payment method (wallet) with… → Ensure the target API supports x402…
  • SKILL.md covers Description, When to Use This Skill, Usage and Commands, plus 4 more sections
  • Needs PURL_PASSWORD

What it does

Pay For HTTP Request is an agent skill from stripe/purl, published by the product's own GitHub organization. Make HTTP requests with automatic x402 payment support using the purl command line interface.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with x402. The licence is MIT.

Example prompts

  • “/pay-for-http-request”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Create a wallet: purl wallet add
  2. Set up a payment method (wallet) with funds on the desired network
  3. Ensure the target API supports x402 payment protocol

What it can do on your machine

Read from SKILL.md and the folder at commit eb82039. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PURL_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pay For HTTP Request loads about 1.7k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 596 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from stripe/purl at commit eb82039, republished under its MIT licence (© stripe). 596 words, ~1,670 tokens.

Download SKILL.mdSave it as .claude/skills/pay-for-http-request/SKILL.md (or your agent's skills folder).
name
pay-for-http-request
description
Make HTTP requests with automatic x402 payment support using the purl command line interface.

pay-for-http-request

Make HTTP requests with automatic x402 payment support using purl.

Description

This skill enables making HTTP requests to payment-gated APIs using purl, a curl-like CLI tool that automatically handles x402-based payments on EVM and Solana networks.

When to Use This Skill

When an API returns HTTP 402 (Payment Required) and supports the x402 payment protocol, purl can automatically negotiate and execute the payment to access the resource.

Common Scenarios
ScenarioExample
Tool callsPaying per request to an API service
Premium data feedsAccessing real-time market data, weather, or analytics
Content monetizationPaying to access paywalled articles or media
Compute resourcesOn-demand access to compute or storage services
When NOT to Use
  • Regular HTTP requests that don't require payment (use curl instead)
  • APIs using traditional payment methods (credit cards, API keys with billing)

Usage

bash
purl <URL> [OPTIONS]
purl <COMMAND>

Commands

CommandDescription
walletManage wallets (keystores)
configManage configuration
balanceCheck wallet balance
inspectInspect payment requirements without executing
networksManage and inspect supported networks
versionShow version information
completionsGenerate shell completions script
topicsDisplay help topics (exit-codes, formatting, examples, environment)

Request Options

Payment Options
OptionDescription
--max-amount <AMOUNT>Maximum amount willing to pay (in atomic units)
--confirmRequire confirmation before paying
--network <NETWORKS>Filter to specific networks (comma-separated)
--dry-runPreview payment without executing
Display Options
OptionDescription
-v, --verbosityVerbosity level (can be used multiple times: -v, -vv, -vvv)
-q, --quiet / -s, --silentDo not print log messages
-i, --includeInclude HTTP headers in output
-I, --headShow only HTTP headers
-o, --output <FILE>Write output to file
--output-format <FORMAT>Output format: auto, text, json, yaml (auto detects: text for terminal, json for pipes)
--color <MODE>Control color output: auto, always, never
HTTP Options
OptionDescription
-X, --request <METHOD>Custom request method
-H, --header <HEADER>Add custom header
-A, --user-agent <AGENT>Set user agent
-L, --locationFollow redirects
--connect-timeout <SECONDS>Connection timeout in seconds
-m, --max-time <SECONDS>Maximum time for the request
-d, --data <DATA>POST data
--json <JSON>Send JSON data with Content-Type header
Wallet Options
OptionDescription
--wallet <PATH>Path to wallet file
--password <PASSWORD>Password for wallet decryption
--private-key <KEY>Raw private key (hex, for EVM; use wallet for better security)
Show full SKILL.md (234 more words)Show less
Global Options
OptionDescription
-C, --config <PATH>Configuration file path

Wallet Commands

bash
purl wallet <COMMAND>
CommandDescription
listList available wallets
addCreate a new wallet (interactive)
show <NAME>Show wallet details
verify <NAME>Verify wallet integrity
use <NAME>Set a wallet as the active payment method
remove <NAME>Remove a wallet
Wallet Add Options
OptionDescription
-n, --name <NAME>Name for the wallet
-t, --type <TYPE>Wallet type: evm or solana
-k, --private-key <KEY>Private key to import (hex for EVM, base58 for Solana)

Config Commands

bash
purl config [COMMAND]
CommandDescription
(none)Show current config
get <KEY>Get a specific configuration value (supports dot notation)
validateValidate configuration file

Examples

Basic payment request
bash
purl https://api.example.com/premium-data
Preview payment without executing
bash
purl --dry-run https://api.example.com/data
Require confirmation before payment
bash
purl --confirm https://api.example.com/data
Set maximum payment amount
bash
purl --max-amount 10000 https://api.example.com/data
Filter to specific network
bash
purl --network base-sepolia https://api.example.com/data
Verbose output with headers
bash
purl -vi https://api.example.com/data
Save output to file as JSON
bash
purl -o output.json --output-format json https://api.example.com/data
POST request with JSON data
bash
purl --json '{"key": "value"}' https://api.example.com/data
Custom headers
bash
purl -H "Authorization: Bearer token" https://api.example.com/data
Follow redirects with custom method
bash
purl -L -X POST https://api.example.com/data
Check wallet balance
bash
purl balance
purl balance --network base
Inspect payment requirements
bash
purl inspect https://api.example.com/endpoint
Wallet management
bash
purl wallet add                      # Interactive wallet creation
purl wallet add --type evm           # Skip type selection
purl wallet add --type solana -k KEY # Import existing key
purl wallet list                     # List all wallets
purl wallet use my-wallet            # Switch active wallet
View supported networks
bash
purl networks
purl networks info base

Supported Networks

TypeNetworks
EVMethereum, ethereum-sepolia, base, base-sepolia, avalanche, avalanche-fuji, polygon, arbitrum, optimism
SVMsolana, solana-devnet

Prerequisites

  1. Create a wallet: purl wallet add
  2. Set up a payment method (wallet) with funds on the desired network
  3. Ensure the target API supports x402 payment protocol

Environment Variables

VariableDescription
PURL_MAX_AMOUNTDefault maximum amount willing to pay
PURL_NETWORKDefault network filter
PURL_CONFIRMDefault confirmation behavior (true/false)
PURL_KEYSTOREDefault wallet/keystore path
PURL_PASSWORDWallet password (for non-interactive use)

© stripe, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/pay-for-http-request of stripe/purl.

Open the folder on GitHubat commit eb82039

Compare with similar skills

Pay For HTTP Request next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pay For HTTP Request compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pay For HTTP Request this skillstripe/purl181—~1.7kAutomated safety check: PassMIT
BlockRun Image GenerationBlockRunAI/ClawRouter6.6k—~2.1kAutomated safety check: PassMIT
Agentic Walletcoinbase/agentic-wallet-skills1272 repos~1kAutomated safety check: PassMIT
PhoneBlockRunAI/ClawRouter6.6k—~2.4kAutomated safety check: PassMIT
Kleros IPFS Uploadinternet-court/internet-court-skill6.4k—~4.9kAutomated safety check: NotesMIT
Polymarket TradingBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT

Similar skills

  • BlockRun Image Generation

    BlockRunAI/ClawRouter

    Generates or edits images through ClawRouter's local image API, with a choice of models and sizes and payment handled automatically through x402.

    6.6k GitHub stars~2.1k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Agentic Wallet

    coinbase/agentic-wallet-skills

    Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API…

    127 GitHub starsUsed in 2 repos~1k tokens
    Backend & APIsAuto-check passed
  • Phone

    BlockRunAI/ClawRouter

    Verify phone numbers (carrier + SIM-swap fraud signals) and place AI-powered outbound voice calls via BlockRun's gateway (Twilio + Bland.ai).

    6.6k GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Kleros IPFS Upload

    internet-court/internet-court-skill

    Uploads one Kleros-related file per paid request to IPFS through the Kleros x402 gateway for 0.01 USDC on Base, returning a CID that Kleros contracts can reference.

    6.4k GitHub stars~4.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Polymarket Trading

    BlockRunAI/ClawRouter

    A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

    6.6k GitHub stars~1.4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    356 GitHub stars~5.7k tokensUpdated 20 days ago
    Business, Finance & HRAuto-check passed

Works with

Questions about Pay For HTTP Request

What does Pay For HTTP Request do?

Make HTTP requests with automatic x402 payment support using the purl command line interface. Pay For HTTP Request is an agent skill from stripe/purl, published by the product's own GitHub organization. Make HTTP requests with automatic x402 payment support using the purl command line interface.

How do I install Pay For HTTP Request in Claude Code?

Run `npx skills add stripe/purl --skill pay-for-http-request -a claude-code`. Or copy the skill folder (skills/pay-for-http-request in stripe/purl) into .claude/skills/pay-for-http-request in your project. Claude Code loads it when a task matches its description.

How do I install Pay For HTTP Request in Codex?

Run `npx skills add stripe/purl --skill pay-for-http-request -a codex`. Or copy the skill folder (skills/pay-for-http-request in stripe/purl) into .agents/skills/pay-for-http-request in your project. Codex loads it when a task matches its description.

Can I use Pay For HTTP Request in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add stripe/purl --skill pay-for-http-request -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pay-for-http-request, .gemini/skills/pay-for-http-request, .github/skills/pay-for-http-request and .opencode/skills/pay-for-http-request in your project.

What does Pay For HTTP Request need to run?

Going by SKILL.md and its folder, Pay For HTTP Request needs credentials named PURL_PASSWORD.

Does Pay For HTTP Request access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pay For HTTP Request safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pay For HTTP Request use?

Pay For HTTP Request is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pay For HTTP Request use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pay For HTTP Request?

Skills that share tags, products or a category with Pay For HTTP Request: BlockRun Image Generation (BlockRunAI/ClawRouter, 6.6k stars), Agentic Wallet (coinbase/agentic-wallet-skills, 127 stars), Phone (BlockRunAI/ClawRouter, 6.6k stars) and Kleros IPFS Upload (internet-court/internet-court-skill, 6.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pay For HTTP Request?

stripe (a GitHub organization, an official publisher) maintains it in stripe/purl, which has 181 GitHub stars. The repository was last updated on October 6, 2026.

Source: stripe/purl on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.