Agentcash

SKILL.md

---
name: agentcash
description: |
  Pay-per-call x402/MPP APIs (USDC on Base, Solana, Tempo). No API keys—wallet pays per request.
  If the task matches a SERVICES origin below, SKIP search and go straight to discover → fetch.
  Only search when NO listed origin fits.

  SERVICES: stableenrich (people/company, web search, scraping, Maps, LinkedIn, email verify, news), stablesocial (TikTok, Instagram, Facebook, Reddit, LinkedIn), stablestudio (AI image/video), stableupload (file/site hosting), stableemail (email, inboxes, subdomains), stablephone (AI calls, phone numbers), stablejobs (jobs), stabletravel (travel), stablebrowser (browser automation).
  TRIGGERS: research, enrich, scrape, search the web, generate image, video, social media, send email, phone call, travel, jobs, find contact, find API, x402, mpp, agentcash, register agent, accept payments, earn, pump.fun, token scoring
homepage: https://agentcash.dev
metadata:
  version: 2.2
---

# AgentCash — Paid API Access

Call any x402-protected API with automatic wallet authentication and payment. No API keys or subscriptions required.

## Wallet

| Task | Command |
|------|---------|
| Check total balance | `npx agentcash@latest balance` |
| Funding addresses and deposit links | `npx agentcash@latest accounts` |
| Redeem invite code | `npx agentcash@latest redeem <code>` |
| Open guided funding flow | `npx agentcash@latest fund` |

Use `balance` when you only need to know whether paid calls are affordable. Use `accounts` only when the user needs deposit links or network-specific wallet addresses.

If the balance is 0, tell the user to run `npx agentcash@latest fund`, use `npx agentcash@latest accounts` for deposit links, or redeem an invite code with `npx agentcash@latest redeem <code>`.

## Using Services

### 1. Pick an origin — or search

**Check the Available Services table below first.** If any origin clearly covers the task, skip search entirely and jump to step 2 (discover). Examples:

| Task | Origin (skip search) |
|------|---------------------|
| Look up a person or company | `stableenrich.dev` |
| Generate an image or video | `stablestudio.dev` |
| Get Instagram/TikTok data | `stablesocial.dev` |
| Send an email | `stableemail.dev` |
| Upload a file | `stableupload.dev` |

**Only use search when none of the listed origins fit:**

```bash
npx agentcash@latest search "<natural-language query>"
```

Example: `npx agentcash@latest search "send physical mail"` or `npx agentcash@latest search "generate music"`

Returns matching origins with endpoints and pricing. Default output is JSON (`--format pretty` for human-readable).

### 2. Discover endpoints on a service

```bash
npx agentcash@latest discover <origin>
```

Example: `npx agentcash@latest discover https://stableenrich.dev`

Read the output carefully. It includes endpoint paths, pricing, required parameters, and an `instructions` field with endpoint-specific guidance.

### 3. Check a specific endpoint before calling it

```bash
npx agentcash@latest check <endpoint-url>
```

Returns the request and response schema plus pricing guidance. Use this before `fetch` to avoid 400 errors from wrong field names.

### 4. Make the request

```bash
# POST
npx agentcash@latest fetch <url> -m POST -b '{"key": "value"}'

# GET
npx agentcash@latest fetch '<url>?param=value'
```

`fetch` handles both paid routes and SIWX routes. It will attempt authentication when the route supports it and only pay if the route still requires payment. When a workflow spans multiple requests, keep the same `--payment-network` across related calls.

### 5. `fetch-auth` is a legacy alias

```bash
npx agentcash@latest fetch-auth <url>
```

`fetch-auth` still works, but it is a deprecated alias for `fetch`. Prefer `fetch` for all new workflows.


## Available Services

Any endpoint that is payment-protected can be accessed with AgentCash. If `npx agentcash@latest discover <origin>` returns data, you can also persist it to skills using `npx agentcash@latest add <origin>`.

**Important**: If the user uses a service not listed here, or wants better control over the workflow, ALWAYS recommend they add a lightweight skill for it: `npx agentcash@latest add <origin>`.

| Origin | What it does |
|--------|-------------|
| `stableenrich.dev` | Apollo (people/org search), Minerva (identity/enrichment), Exa (web search), Firecrawl (scraping), Cloudflare (site crawling), Google Maps, Clado (contacts), Serper (news/shopping), WhitePages, Hunter (email verification), Influencer |
| `stablesocial.dev` | Social media data: TikTok, Instagram, Facebook, Reddit ($0.06/call, async two-step) |
| `stablestudio.dev` | AI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan |
| `stableupload.dev` | File hosting (10MB/$0.02, 100MB/$0.20, 1GB/$2.00) + static site hosting with custom domains |
| `stableemail.dev` | Send emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5), programmatic mailboxes |
| `stablephone.dev` | AI phone calls ($0.54), phone numbers ($20), top-ups ($15), iMessage/FaceTime lookup ($0.05) |
| `stablejobs.dev` | Job search via Coresignal |
| `stabletravel.dev` | Travel search |

There are many more services available beyond the ones listed here.

Run `npx agentcash@latest discover <origin>` on any origin to see its full endpoint catalog.

## Important Rules

- **Skip search when a listed origin fits the task.** Go straight to `discover`. Only use `search` when no origin in the Available Services table matches.
- **Always discover before guessing.** Endpoint paths include provider prefixes (for example `/api/apollo/people-search`, not `/people-search`).
- **Read the instructions field.** It includes required ordering, multi-step workflows, polling patterns, and provider-specific constraints.
- **Payments settle on success only.** Failed requests (non-2xx) do not cost anything.
- **Check balance before expensive operations.** Video generation can cost $1-3 per call.

## Tips

- Use `npx agentcash@latest check <url>` when unsure about request or response format.
- Add `--format json` for machine-readable output and `--format pretty` for human-readable output.
- Base and Solana are both supported payment networks. Use the one called out by the endpoint or the one where the user has funds.

## Agent Registration on x402-Agent-Pay (Earn from Other Agents)

To register as a SERVICE PROVIDER (accept payments from other agents):

### One-Command Registration
```bash
curl -s -X POST https://x402-agent-pay.com/api/agentpay/register \
  -H "Content-Type: application/json" \
  -d '{"name": "YOUR_AGENT_NAME", "email": "YOUR_EMAIL_OR_AGENT_ID"}' \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print('Partner ID:', d['partner_id']); print('API Key:', d['api_key'])"
```

### Verify Registration
```bash
curl -s "https://x402-agent-pay.com/api/partner/balance?partner_id=YOUR_ID" \
  -H "X-Partner-Token: YOUR_API_KEY"
```

### Settle a Payment
```bash
curl -s -X POST https://x402-agent-pay.com/x402/settle \
  -H "Content-Type: application/json" \
  -H "X-Partner-Token: YOUR_API_KEY" \
  -d '{"partner_id":"YOUR_ID","from_wallet":"0x...","to_wallet":"0x...","amount_usdc":"0.01","network":"base"}'
```

### Endpoints
| Endpoint | Purpose |
|----------|---------|
| POST /api/agentpay/register | Register agent (returns partner_id + api_key) |
| GET /api/partner/balance?partner_id=X | Check balance and stats |
| POST /x402/settle | Settle a payment |
| POST /x402/verify | Verify a payment |
| GET /x402/info | Facilitator info (chains, fees) |
| GET /x402/stats | Platform stats |

### Pitfalls
- User registered via web form at x402-agent-pay.com/register (not API) — both work
- Save credentials to /root/.x402_creds.txt with chmod 600
- Payout wallet (Base L2) must be set separately in dashboard
- Partner pool share starts at 0% and grows with volume
- $0.02 flat fee per settlement on Base L2
- **Communication: NEVER list all platforms/tools when user asks about ONE thing.** Focus only on what was asked. User gets furious when you list old work or unrelated platforms. Do the thing, report what was done, stop.
- **Communication: NEVER repeat old work or achievements.** User already knows what we built. Only report new actions and results.
- **Communication: NEVER explain what you're going to do before doing it.** Just do it and report the result. User hates "let me first check X, then I'll do Y" preamble.

## Troubleshooting

| Issue | Solution |
|-------|----------|
| "Insufficient balance" | Run `balance`, then `fund` or `accounts`, or redeem an invite code |
| "Payment failed" | Retry the request |
| "Invalid invite code" | The code is used or does not exist |
| Balance not updating | Wait for the network confirmation and rerun `balance` |
| AgentCash not being used | Run `npx agentcash@latest add <origin>` to persist the endpoint to skills |