# skill: x402-agent-utilities

**Single ladder (stranger convert):** free tools / sample-outline → outline **0.01** → brief **0.02** USDC (Base · payTo `0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95`).
Featured: MCP free **x402_sample_outline** → **x402_research_outline** 0.01 → **x402_research_brief** 0.02. HTTP: GET /v0/sample-outline → POST /v0/outline → POST /v0/brief.
Alts: packs 0.02 · scrub/sql · radar 0.015. Origin: https://x402.devvizion.com · eip155:8453 · USDC · x402 exact · payTo 0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95

> Install MCP com.devvizion/x402-research → https://x402.devvizion.com/mcp · free tools then outline 0.01 / pack 0.02 USDC Base · catalog GET /v0/packs · skill /skill.md

## MCP / agent discovery (distribution)
### Live MCP (preferred install)
- **Streamable-HTTP:** `https://x402.devvizion.com/mcp`  (GET discovery · POST JSON-RPC tools/list + tools/call)
- **Install pitch:** `https://x402.devvizion.com/install.md` · registry `com.devvizion/x402-research`
- **Free tools (no wallet):** **`x402_sample_outline`** (convert teaser) · `x402_health` · `x402_discovery` · `x402_sample_scrub`
- **Paid tools (single ladder):** `x402_research_outline` 0.01 · `x402_research_brief` 0.02 (402 + accepts[] when unpaid)
```json
// Claude Desktop / Cursor / any MCP host (streamable-http)
{
  "mcpServers": {
    "money-engine-x402": {
      "url": "https://x402.devvizion.com/mcp"
    }
  }
}
```
```bash
# smoke free convert path (no payment)
curl -s -X POST "https://x402.devvizion.com/mcp" -H "content-type: application/json" -H "accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
curl -s -X POST "https://x402.devvizion.com/mcp" -H "content-type: application/json" -H "accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"x402_sample_outline","arguments":{"topic":"x402"}}}'
```
- Smithery (stdio fallback): https://smithery.ai/servers/aiircool25/money-engine-x402-research
- Well-known: GET /.well-known/x402 · OpenAPI: GET /openapi.json · this skill: GET /skill.md · MCP: GET|POST /mcp · install: GET /install.md
- Pack warehouse: GET https://x402.devvizion.com/v0/packs (JSON) · ?format=md · ?format=html · sample GET /v0/sample-pack
- Bazaar: real CDP settle keeps merchant indexed (keepalive automated)

## First buy — single ladder (free → outline → brief)
### A · Research (preferred stranger path)
1. Free MCP: `tools/call x402_sample_outline` `{topic:"x402"}` · or HTTP: `GET /v0/sample-outline?topic=x402`
2. First pay: `POST /v0/outline` `{"topic":"x402"}` → **0.01 USDC** · MCP `x402_research_outline`
3. Upgrade: `POST /v0/brief` `{"topic":"x402"}` → **0.02 USDC** · MCP `x402_research_brief`
### B · Data scrub (alt)
1. Free: `GET /v0/sample-scrub`
2. Paid: `POST /v0/scrub` `{"text":"…","mode":"sql"}` → **0.03 USDC** (or scrub-score **0.01**)
### C · Ops SQL patterns (alt)
1. Free: `GET /v0/sample-sql-catalog`
2. Paid: `POST /v0/sql-search` `{"q":"products never sold","includeSql":true}` → **0.015 USDC**
3. Or one pack: `POST /v0/sql-query` `{"id":"sql_0007"}` → **0.025 USDC**
### D · Pack warehouse (alt · warehouse GTM)
1. Free catalog: `GET /v0/packs` · markdown `?format=md` · HTML `?format=html` · teaser: `GET /v0/sample-pack?packId=pay-ladder-kit`
2. Paid: `POST /v0/pack` `{"packId":"pay-ladder-kit"}` → **0.02 USDC** (kits 0.02; research 0.03–0.06)
3. Starter ids: `pay-ladder-kit` · `agent-radar-starter` · `m2-stranger-kit` · `agent-fit-kit`
Unpaid POST → HTTP 402 + accepts[] → settle USDC on Base → retry with `X-PAYMENT`.

```bash
# single ladder
curl -s "https://x402.devvizion.com/v0/sample-outline?topic=x402"
curl -s -i -X POST "https://x402.devvizion.com/v0/outline" -H "content-type: application/json" -d '{"topic":"x402"}'
# unpaid → 402 · settle 0.01 USDC · retry X-PAYMENT
curl -s -i -X POST "https://x402.devvizion.com/v0/brief" -H "content-type: application/json" -d '{"topic":"x402"}'
# unpaid → 402 · settle 0.02 USDC · retry X-PAYMENT
```

## Free (start here)
- GET https://x402.devvizion.com/start  (human landing · single ladder CTA)
- GET https://x402.devvizion.com/health
- GET|POST https://x402.devvizion.com/mcp  (free tools → paid outline/brief)
- GET https://x402.devvizion.com/.well-known/x402  (Bazaar / x402scan resource list)
- GET https://x402.devvizion.com/llms.txt
- GET https://x402.devvizion.com/v0/sample-outline?topic=x402  (3-bullet free teaser → paid outline **0.01** → brief **0.02**)
- GET https://x402.devvizion.com/v0/sample-scrub  (data scrub dirty→clean demo)
- GET https://x402.devvizion.com/v0/sample-sql-catalog  (ops SQL patterns teaser · ?format=json)
- GET https://x402.devvizion.com/v0/sample-radar  (3-item teaser)
- GET https://x402.devvizion.com/v0/sample-pack?packId=m2-stranger-kit  (stranger convert kit teaser)
- GET https://x402.devvizion.com/v0/packs  (JSON catalog + install oneLiner)
- GET https://x402.devvizion.com/v0/packs?format=md  (warehouse pitch markdown)
- GET https://x402.devvizion.com/v0/packs?format=html  (warehouse lander + CTA)
- GET https://x402.devvizion.com/install.md  (MCP install one-liner + free→paid)
- GET https://x402.devvizion.com/robots.txt  (crawler free-path map)
- GET https://x402.devvizion.com/sitemap.xml

## More free teasers
- GET https://x402.devvizion.com/v0/sample-rep?wallet=0x…  (agent reputation teaser)
- GET https://x402.devvizion.com/v0/sample-hire-watch  (hire/award board-watch teaser)
- GET https://x402.devvizion.com/v0/sample-sponsor  (sponsored radar pin teaser)
- GET https://x402.devvizion.com/v0/sample-win-share  (win-share bid bot teaser)
- GET https://x402.devvizion.com/v0/sample-reverse-bounty  (reverse bounty requester scaffold teaser)
- GET https://x402.devvizion.com/v0/sample-cross-list  (cross-list multi-market teaser)
- GET https://x402.devvizion.com/v0/sample-deliver-plan  (award accept + deliver plan teaser)
- GET https://x402.devvizion.com/v0/sample-scope-lock  (pre-work scope lock teaser)
- GET https://x402.devvizion.com/v0/sample-escrow-checklist  (award→pay / release-chase teaser)
- GET https://x402.devvizion.com/v0/sample-counter-offer  (underpriced listing counter teaser)
- GET https://x402.devvizion.com/v0/sample-proof-handoff  (post-delivery handoff teaser)
- GET https://x402.devvizion.com/v0/sample-agent-fit  (listing gate scorecard teaser)
- GET https://x402.devvizion.com/v0/sample-change-order  (mid-job scope-creep top-up teaser)
- GET https://x402.devvizion.com/v0/sample-list-ready  (GTM multi-channel product listing teaser)
- GET https://x402.devvizion.com/v0/sample-rejection-rewrite  (lost-bid diagnosis rewrite teaser)
- GET https://x402.devvizion.com/v0/sample-review-reply  (post-delivery review reply teaser)
- GET https://x402.devvizion.com/v0/sample-invoice-memo  (payment invoice memo teaser)
- GET https://x402.devvizion.com/v0/sample-milestone-nudge  (mid-job milestone release nudge teaser)
- GET https://x402.devvizion.com/v0/sample-bid-polish  (pre-submit bid polish teaser)
- GET https://x402.devvizion.com/v0/sample-follow-up-ask  (silence follow-up ask teaser)
- GET https://x402.devvizion.com/v0/sample-rehire-prompt  (post-settle rehire prompt teaser)
- GET https://x402.devvizion.com/v0/sample-rate-card  (freelance rate card teaser)
- GET https://x402.devvizion.com/v0/sample-status-ping  (mid-job status ping teaser)
- GET https://x402.devvizion.com/v0/sample-checkin-ask  (mid-job buyer decision ask teaser)
- GET https://x402.devvizion.com/v0/sample-quiet-nudge  (mid-job soft presence nudge teaser)
- GET https://x402.devvizion.com/v0/sample-scope-delta  (light mid-job scope shift teaser)
- GET https://x402.devvizion.com/v0/sample-kickoff-msg  (post-award first client message teaser)

## Paid (x402 exact, Base USDC → payTo in /health)
**Featured SKUs (ops + privacy + packs):** scrub · sql-search · sql-query · sql-catalog · pack.
| Call | Price | Body |
|------|------:|------|
| POST /v0/scrub | 0.03 | {"text":"…","mode":"sql"} |
| POST /v0/scrub-score | 0.01 | {"text":"…","mode":"sql"} |
| POST /v0/sql-search | 0.015 | {"q":"products never sold","includeSql":true} |
| POST /v0/sql-query | 0.025 | {"id":"sql_0007"} |
| POST /v0/sql-catalog | 0.02 | {"category":"sales"} optional |
| POST /v0/outline | 0.01 | {"topic":"..."} |
| POST /v0/bid-draft | 0.01 | {"brief":"..."} |
| POST /v0/deliver-plan | 0.012 | {"brief":"...","reward":12,"platform":"taskmarket"} |
| POST /v0/bounty-radar | 0.015 | {"limit":15} |
| POST /v0/hire-watch | 0.012 | {"wallet":"0x…"} optional |
| POST /v0/agent-rep | 0.015 | {"wallet":"0x…"} |
| POST /v0/agent-fit | 0.012 | {"title":"...","agentAccess":"HUMAN_ONLY","reward":500} |
| POST /v0/change-order | 0.012 | {"brief":"...","change":"...","reward":12,"hours":3} |
| POST /v0/list-ready | 0.015 | {"name":"...","url":"https://...","priceUsdc":"0.01"} |
| POST /v0/rejection-rewrite | 0.012 | {"brief":"...","bid":"...","feedback":"too generic"} |
| POST /v0/review-reply | 0.012 | {"review":"...","rating":3,"brief":"..."} |
| POST /v0/invoice-memo | 0.012 | {"brief":"...","amount":12,"wallet":"0x…"} |
| POST /v0/milestone-nudge | 0.012 | {"brief":"...","milestone":"2","done":"...","amount":8} |
| POST /v0/bid-polish | 0.012 | {"brief":"...","bid":"...draft..."} |
| POST /v0/follow-up-ask | 0.012 | {"brief":"...","silentDays":4,"bid":"..."} |
| POST /v0/rehire-prompt | 0.012 | {"brief":"...","outcome":"...","daysSinceClose":1} |
| POST /v0/rate-card | 0.012 | {"name":"...","skills":"...","microUsdc":15} |
| POST /v0/status-ping | 0.012 | {"brief":"...","progress":"...","percent":70} |
| POST /v0/checkin-ask | 0.012 | {"brief":"...","ask":"...","options":["A","B"]} |
| POST /v0/quiet-nudge | 0.012 | {"brief":"...","silentDays":4,"shipping":"..."} |
| POST /v0/scope-delta | 0.012 | {"brief":"...","delta":"...","hours":1.5} |
| POST /v0/kickoff-msg | 0.012 | {"brief":"...","goal":"...","start":"today"} |
| POST /v0/win-share-bid | 0.015 | {"brief":"...","reward":25,"platform":"near"} |
| POST /v0/reverse-bounty | 0.015 | {"need":"...","valueUsd":20,"maxBounty":6} |
| POST /v0/cross-list | 0.02 | {"brief":"...","reward":15} |
| POST /v0/scope-lock | 0.012 | {"brief":"...","reward":12,"days":3} |
| POST /v0/escrow-checklist | 0.012 | {"brief":"...","role":"requester","reward":12} |
| POST /v0/counter-offer | 0.012 | {"brief":"...","offered":8,"hours":4} |
| POST /v0/proof-handoff | 0.012 | {"brief":"...","artifacts":["https://…"],"reward":12} |
| POST /v0/brief | 0.02 | {"topic":"..."} |
| POST /v0/storyboard | 0.02 | {"scene":"..."} |
| POST /v0/pack | 0.02–0.06 | {"packId":"pay-ladder-kit"} · see GET /v0/packs |
| POST /v0/sponsor-slot | 0.05 | {"title":"…","url":"https://…"} |

## Flow (convert)
1. Free GET /v0/packs or /v0/sample-pack → pick packId
2. Unpaid POST /v0/pack {"packId":"pay-ladder-kit"} → 402 + accepts[] (0.02 USDC typical)
3. Pay USDC on Base; retry with X-PAYMENT
4. Alt cheap singles: outline 0.01 · scrub-score 0.01 · sql-search 0.015 after free samples
5. Catalog: list-ready for YOUR product; mid-job tools after hire; full table above
