# agentwallet

This skill gives an AI agent a server-side wallet that pays x402 and MPP endpoints, signs transactions remotely and keeps spending inside a policy.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2600 installs · ★ 4
- Author: frames-engineering
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/frames-engineering/skills/tree/HEAD/skills/agentwallet/SKILL.md
- Updated: 2026-03-21
- HTML: https://affpapa.org/en/nevibecode/skills/agentwallet

## What it does

A wallet is provisioned after email OTP verification. From then on the agent reads `~/.agentwallet/config.json`, takes the `apiToken` and uses it for every call. Signing happens server-side, so private keys never sit in your repo.

The main job is paying for metered APIs. Rather than handling a 402 response by hand, the skill points the agent at the `/x402/fetch` endpoint: it sends the target URL and body, and the server detects the payment request, signs it and retries the call. `dryRun` shows the cost before anything is charged. `preferredChain` and `preferredToken` pick between EVM and Solana networks and the USDC, USDT and CASH tokens. MPP has its own endpoint.

Spending is gated by policy. An amount over the limit or a frozen wallet returns a denial instead of a charge. Keep the token in session memory, out of logs and out of URL query strings — if it leaks, rotate it through the connect flow.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add frames-engineering/skills --skill agentwallet -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agentwallet/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agentwallet/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add frames-engineering/skills --skill agentwallet -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agentwallet/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add frames-engineering/skills --skill agentwallet -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agentwallet/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install frames-engineering/skills agentwallet
```

2. **Manually: put the files in place**
- File: `.github/skills/agentwallet/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add frames-engineering/skills --skill agentwallet -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/frames-engineering/skills --path skills/agentwallet
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agentwallet/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add frames-engineering/skills --skill agentwallet -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/frames-engineering/skills/tree/HEAD/skills/agentwallet/SKILL.md

## When to use it
- pay a metered API from inside an agent without signing by hand
- preview the cost of a request with `dryRun`
- pick a chain and token that match the available balance
- provision a server wallet after email verification
- cap agent spending with policy checks and a wallet freeze

## Example prompts
- Connect agentwallet: ask me for my email and walk me through the OTP
- Call the paid API through `/x402/fetch` and tell me what it charged
- Check my balance and show my referral rewards

## Similar
- [okx-agent-payments-protocol](https://affpapa.org/en/nevibecode/skills/okx-agent-payments-protocol.md) — skill · 13700 installs
- [pay-with-app](https://affpapa.org/en/nevibecode/skills/pay-with-app.md) — skill · 524 installs
- [x402-payments](https://affpapa.org/en/nevibecode/skills/x402-payments.md) — skill · 462 installs
- [gmgn-wallet-review](https://affpapa.org/en/nevibecode/skills/gmgn-wallet-review.md) — skill · 2400 installs
- [use-usdc](https://affpapa.org/en/nevibecode/skills/use-usdc.md) — skill · 1000 installs
- [nansen-wallet-manager](https://affpapa.org/en/nevibecode/skills/nansen-wallet-manager.md) — skill · 366 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md