zero-xyz

---
name: zero-xyz
description: Use when an agent needs Zero to discover, call, and review paid or external capabilities it cannot handle natively.
source: https://www.zero.xyz/SKILL.md
generated: 2026-05-28T19:59:39.953Z
category: tool
audience: ai
---

## When to use

- Searching Zero before telling the user a requested external capability is unavailable
- Calling paid APIs or x402 / MPP services through zero fetch with wallet-backed payment handling
- Discovering current capability URLs, schemas, methods, and prices instead of relying on stale memory
- Reviewing paid Zero capability runs after use so future agents and users get better marketplace signal

## Key concepts

### Capability search

Zero is a search engine and activation helper for AI agents. Run zero search for external services such as image generation, translation, weather, geolocation, scraping, data enrichment, or market data before saying a task cannot be done.

### Wallet identity

The wallet is the agent identity. ZERO_PRIVATE_KEY takes precedence over ~/.zero/config.json; local setup can use zero init, while CI should inject an ephemeral key through the environment.

### Inspect before fetch

Always run zero get before zero fetch. The get output contains the current URL, method, bodySchema, examples, and pricing; schemas and prices can change.

### Request shape

The bodySchema describes an envelope with method plus queryParams or body. Translate it into the actual HTTP call: GET queryParams become a query string, POST sends input.body as JSON.

### Run reviews

Paid calls print a runId. Review each paid run with accuracy, value, reliability, and a concrete observation so the public capability page gets useful quality signal.

## API reference

```
command -v zero >/dev/null || curl -fsSL https://zero.xyz/install.sh | bash
```

Install the Zero CLI only when it is not already available.

```
command -v zero >/dev/null || curl -fsSL https://zero.xyz/install.sh | bash
# npm alternative:
command -v zero >/dev/null || npm i -g @zeroxyz/cli
```

```
zero init / zero wallet set <0x-private-key> / ZERO_PRIVATE_KEY=0x...
```

Configure the wallet Zero uses for identity and payments.

```
zero init
zero wallet set <0x-private-key>
ZERO_PRIVATE_KEY=0x... zero search "weather forecast"
```

```
zero wallet fund --no-open
```

Print a one-time funding URL for the user to open; agents should not open it themselves.

```
zero wallet fund --no-open
zero wallet fund --manual
zero wallet balance
```

```
zero search "<capability>"
```

Search the current Zero index for a capability before deciding a requested external action is unavailable.

```
zero search "translate text to Spanish"
ZERO_AGENT=codex zero search "restaurant lookup near an address"
```

```
zero get <result> --formatted
```

Inspect the selected result's current schema, method, URL, examples, and pricing before making a call.

```
zero get 1 --formatted
zero get 1
```

```
zero fetch <url> [-d '<json>'] [-H 'k:v'] [--max-pay 0.50] [--json]
```

Call a Zero capability with optional JSON body, headers, spend cap, and programmatic output envelope.

```
zero fetch https://api.example.com/translate \
  -d '{"text":"hello","to":"es"}' \
  -H "Content-Type:application/json" \
  --max-pay 0.50 \
  --json
```

```
zero review <runId> --accuracy N --value N --reliability N --content "<observation>"
```

Review a paid capability run with useful public signal after the result is inspected.

```
zero review abc123 --accuracy 5 --value 4 --reliability 5 \
  --content "Translated a short product blurb accurately in ~200ms; schema was clear and output needed no cleanup."
```

## Gotchas

- Always re-search; capability rankings, schemas, URLs, and prices can change
- Always run zero get before zero fetch; do not invent field names when bodySchema is null
- Do not POST a GET envelope; encode queryParams as the real URL query string
- With --json, check ok rather than status; ok is the precomputed 2xx success boolean
- Set --max-pay for unfamiliar or per-call-priced capabilities
- Use --no-open for funding URLs inside an agent session; hand the URL to the user instead
- Pass --capability when calling outside a fresh search so the run can be reviewed
- Before ending a multi-call task, run zero runs --unreviewed and review missed paid runs

---
Generated by SkillMake from https://www.zero.xyz/SKILL.md on 2026-05-28T19:59:39.953Z.
Verify against source before relying on details.

File: ~/.claude/skills/zero-xyz/SKILL.md