x402-proxy

x402-proxy is a skill for Claude Code, Codex from cascade-protocol/x402-proxy. It costs 98 tokens per session (1,711 once invoked), scanned A, original, Apache-2.0.

A command-line proxy for making requests to paid web APIs. It handles payment methods where an API asks for payment through an HTTP 402 response, including one-time and per-token charges.

In plain words
What is it for?
Use it to send paid GET or POST requests, choose a payment network, save or pipe responses, run a local paid inference proxy, or connect Claude Code and MCP services to paid endpoints.
Why use it?
It removes the need to build payment handling into every script that calls a paid API.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cascade-protocol/x402-proxy/skills
Any agent
npx skills add cascade-protocol/x402-proxy --skill skills
Clone the repo
git clone --depth 1 https://github.com/cascade-protocol/x402-proxy

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for x402-proxy

README.md
[![agentmods](https://agentmods.dev/badge/skills/cascade-protocol/x402-proxy/skills.svg)](https://agentmods.dev/skills/cascade-protocol/x402-proxy/skills)
Your own site
<a href="https://agentmods.dev/skills/cascade-protocol/x402-proxy/skills"><img src="https://agentmods.dev/badge/skills/cascade-protocol/x402-proxy/skills.svg" alt="Measured on agentmods" height="20"></a>
Per session 98 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,711 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00098 $0.01711
Opus 5 $0.00049 $0.00856
Sonnet 5 $0.00020 $0.00342
Haiku 4.5 $0.00010 $0.00171

Measured 3d ago against content hash 6c943bee0fa9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

x402-proxy scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

`curl` for x402 and MPP paid APIs with MCP proxy support. Auto-pays HTTP 402 on Base, [Monad](https://monad.xyz/), Solana, and [Tempo](https://tempo.xyz/). Supports one-time payments (x402, MPP charge) and pay-per-token
packages/x402-proxy/skills/SKILL.md · 184 lines

How it starts

The opening of the file, as written. The whole thing — 184 lines — stays where its author put it; the contents beside it link to each section on GitHub.

x402-proxy

curl for x402 and MPP paid APIs with MCP proxy support. Auto-pays HTTP 402 on Base, Monad, Solana, and Tempo. Supports one-time payments (x402, MPP charge) and pay-per-token streaming (MPP sessions).

Quick start

npx x402-proxy https://surf.cascade.fyi/api/v1/twitter/user/openclaw

First run auto-creates a wallet. No setup needed.

HTTP requests

# GET - body to stdout, payment info to stderr
npx x402-proxy https://api.example.com/resource

# POST with body and headers
npx x402-proxy -X POST \
  -H "Content-Type: application/json" \
  -d '{"query":"example"}' \
  https://api.example.com/search

# Force a specific chain
npx x402-proxy --network solana https://api.example.com/data

# Pipe-safe - only response body on stdout
npx x402-proxy https://api.example.com/data | jq '.results'

# Save response to file
npx x402-proxy https://api.example.com/data > response.json

Commands

x402-proxy <url>                        # paid HTTP request (default)
x402-proxy serve                        # local paid inference proxy server
x402-proxy claude                       # run Claude Code through paid local proxy
x402-proxy mcp <url>                    # MCP stdio proxy for AI agents
x402-proxy mcp add <name> <url>         # install MCP server into AI client
x402-proxy setup                        # wallet onboarding wizard
x402-proxy setup --force                # re-run setup (overwrite existing wallet)
x402-proxy status                       # config + wallet + daily spend summary
x402-proxy config                       # show current configuration
x402-proxy config set <key> <value>     # set a config value
x402-proxy config unset <key>           # remove a config value
x402-proxy wallet                       # show addresses and USDC balances
x402-proxy wallet history               # payment log
x402-proxy wallet history --limit 5     # last 5 payments
x402-proxy wallet history --json        # machine-readable output
x402-proxy wallet export-key evm        # bare EVM private key to stdout
x402-proxy wallet export-key solana     # bare Solana private key to stdout
x402-proxy wallet export-key mnemonic   # bare mnemonic to stdout

Read the full file on GitHub · 184 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 184 lines · 98 tokens per session scan A 6c943bee0fa9

Subscribe to this mod's changes

x402-proxy is a skill published in the GitHub repository cascade-protocol/x402-proxy (11 stars, last pushed 20d ago), licensed Apache-2.0. It adds 98 tokens to every session and 1,711 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

clicks-protocol

Query and interact with Clicks Protocol: autonomous DeFi yield for AI agents on Base. Check current APY (Aave V3 + Morpho), query agent status, simulate payment splits, view referral earnings. Zero dependencies (curl only). Use when an agent holds idle USDC, needs treasury yield data, or wants to check Clicks Protocol…

clicks-protocol/clicks-protocol · 77 tokens

alien-plugg-x402

38 paid x402 API endpoints for AI agents — Zora crypto analysis, Robinhood Chain tokenized stocks, on-chain intelligence, whale tracking, and utilities. MCP-compatible. Flat $0.003/call via USDC micropayments on Base.

michaelhutchings626-hub/alien-plugg-x402 · 57 tokens

broke2built

Broke to Built AI operates 44 x402 micropayment services on Base. All services follow the x402 protocol: send USDC, receive data. No API keys. No subscriptions. No setup.

lordbasilaiassistant-sudo/x402-wiki · 0 tokens

dexter-mcp

Use Dexter MCP for authenticated access to Dexter's full tool suite: x402 marketplace search and payments, Solana trading (Jupiter swaps, token resolution, balances, sends), on-chain analytics, Hyperliquid perps, media generation (Sora video, meme images), Twitter analysis, Pokedexter battles, stream shouts, and 50+…

Dexter-DAO/dexter-mcp · 122 tokens

birdeye-plugin

Birdeye DeFi analytics with dual live access mode (apikey full coverage, x402 supported subset).

okx/plugin-store · 26 tokens

cardzero

CardZero — the first payment wallet built for AI agents. Create USDC wallets on Base L2, make payments, pay x402 paywalls, pay other agents, check balance, view transactions, and run A2A jobs with on-chain escrow (ERC-8183). Human owner sets spending rules via Dashboard; agent pays autonomously within limits. Use when…

mrocker/CardZero · 163 tokens