clawpump/claw-agent/pay-sh

Pay.sh (x402 paid APIs) — paid by the ClawPump wallet

Pay.sh is a catalog of APIs gated by stablecoin payments instead of accounts and keys: call an endpoint, get HTTP 402 with a price, pay in USDC, get the response. ClawPump pays these from the agent's own custodial wallet — there is no separate wallet to create or fund.

Use the ClawPump MCP tools — nothing else

These come from the ClawPump MCP (mcp_clawpump_* / mcp_clawpump-stdio_*):

• pay_sh_search — find providers (free)
• pay_sh_provider_details — endpoints + per-call price for one provider (free)
• pay_sh_prepare_call — balance preflight + payment preview + a 10-minute

approval code; pays nothing

• pay_sh_execute_approved — pays from the agent wallet via x402 and returns

the response; needs the approval code + confirm_payment: true

⛔ Never do this

• Do NOT run the `pay` CLI (npx @solana/pay …) — pay setup,

pay account new, pay topup, pay curl, etc. That creates a separate local wallet, which is exactly what we are avoiding. The user wants the ClawPump agent wallet to pay.

• Do NOT create, fund, or transfer to any local/external pay wallet for

this. No wallet_transfer "allowance" hop either.

• If the ClawPump pay_sh tools are missing, tell the user to enable them

(hermes mcp configure clawpump, opt in pay_sh_execute_approved) and that the agent needs the x402 skill — do not fall back to the CLI.

Requirement: the x402 skill

pay_sh_prepare_call / pay_sh_execute_approved require the ClawPump agent to have the `x402` skill enabled. If a call is rejected for capability, enable it with update_agent (enabled_skills += x402), then retry — never reach for the CLI.

⚠️ Spending rules

pay_sh_execute_approved spends real USDC. Before it:

1. Get the price first — pay_sh_provider_details / the pay_sh_prepare_call

preview include per-call pricing.

1. Tell the user the exact endpoint and price; wait for a clear yes.
2. Only then call pay_sh_execute_approved with the approval code and

confirm_payment: true. Never loop paid calls without telling the user the total.

1. Report what was spent and the result.

Pattern

pay_sh_search → pay_sh_provider_details (price) → quote it to the user → pay_sh_prepare_call → (user approves) → pay_sh_execute_approved. All paid from the agent's ClawPump wallet. See the clawpump skill for the full tool reference.