# Agent Utilities API (x402)

v0.3.77 · **Single ladder:** free tools / sample-outline → outline **0.01** → brief **0.02** USDC. payTo `0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95` Base eip155:8453.

> 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

## Executable settle (wallet agents): https://x402.devvizion.com/first-buy.json

## Convert path (start here) — free → outline 0.01 → brief 0.02
```bash
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 → HTTP 402 + accepts[] · settle 0.01 USDC on Base · 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
```
1. Free MCP convert: tools/call x402_sample_outline {topic:"x402"} — no wallet
2. Free HTTP teaser: GET https://x402.devvizion.com/v0/sample-outline?topic=x402
3. First pay: POST https://x402.devvizion.com/v0/outline  {"topic":"…"}  → **0.01 USDC** · MCP x402_research_outline
4. Upgrade: POST https://x402.devvizion.com/v0/brief  {"topic":"…"}  → **0.02 USDC** · MCP x402_research_brief
5. Alts: scrub 0.03 · sql-search 0.015 · radar 0.015 · packs 0.02+
6. Pack warehouse: GET https://x402.devvizion.com/v0/packs · ?format=md · ?format=html · sample-pack → POST /v0/pack
7. Install pitch: GET https://x402.devvizion.com/install.md · skill: GET https://x402.devvizion.com/skill.md · well-known · landing https://x402.devvizion.com/start
8. Smithery stdio: https://smithery.ai/servers/aiircool25/money-engine-x402-research
payTo 0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95 · network eip155:8453 · asset USDC · scheme x402 exact

## Free discovery
- GET https://x402.devvizion.com/  · https://x402.devvizion.com/start  convert landing (free → outline → brief)
- GET https://x402.devvizion.com/first-buy.json  executable settle card (wallet agents · aliases /buyer.json /settle.json)
- GET https://x402.devvizion.com/pitch.json  machine-crawlable pitch pack (JSON settle recipe · no human paste)
- GET https://x402.devvizion.com/install.md  MCP install one-liner + free→paid
- GET https://x402.devvizion.com/hire-path.json  Virtuals ACP machine hire (create-job when browse lags)
- GET https://x402.devvizion.com/share.md  · https://x402.devvizion.com/buyer.md  external paste + first-buy settle
- GET https://x402.devvizion.com/v0/packs  free pack warehouse (JSON; ?format=md|html CTA)
- GET https://x402.devvizion.com/health
- GET https://x402.devvizion.com/robots.txt  free path map for crawlers
- GET https://x402.devvizion.com/sitemap.xml  free path sitemap
- GET https://x402.devvizion.com/.well-known/x402  (convertLadder + outline/brief lead + MCP free tools)
- GET https://x402.devvizion.com/openapi.json
- GET https://x402.devvizion.com/llms.txt
- GET https://x402.devvizion.com/skill.md
- GET|POST https://x402.devvizion.com/mcp  ← streamable-HTTP MCP (free x402_sample_outline → paid outline/brief)

## MCP install (agents)
```json
{ "mcpServers": { "money-engine-x402": { "url": "https://x402.devvizion.com/mcp" } } }
```
Free tools: **x402_sample_outline** · x402_health · x402_discovery · x402_sample_scrub. Ladder: free sample → outline **0.01** → brief **0.02** (X-PAYMENT after 402).
- GET https://x402.devvizion.com/v0/sample-outline?topic=x402  ← free teaser → POST /v0/outline 0.01 → POST /v0/brief 0.02
- GET https://x402.devvizion.com/v0/sample-scrub  ← data scrub demo (then paid /v0/scrub)
- GET https://x402.devvizion.com/v0/sample-sql-catalog  ← ops SQL patterns (then sql-search / sql-query)
- GET https://x402.devvizion.com/v0/sample-radar  (then paid bounty-radar)
- GET https://x402.devvizion.com/v0/sample-pack  free pack warehouse teaser
- GET https://x402.devvizion.com/v0/sample-rep?wallet=0x…  free agent reputation teaser
- GET https://x402.devvizion.com/v0/sample-hire-watch  free hire/award board-watch teaser
- GET https://x402.devvizion.com/v0/sample-sponsor  free sponsored radar pin teaser
- GET https://x402.devvizion.com/v0/sample-win-share  free win-share bid bot teaser
- GET https://x402.devvizion.com/v0/sample-reverse-bounty  free reverse bounty requester scaffold teaser
- GET https://x402.devvizion.com/v0/sample-cross-list  free cross-list multi-market teaser
- GET https://x402.devvizion.com/v0/sample-deliver-plan  free award deliver-plan teaser
- GET https://x402.devvizion.com/v0/sample-scope-lock  free pre-work scope-lock teaser
- GET https://x402.devvizion.com/v0/sample-escrow-checklist  free award→pay escrow teaser
- GET https://x402.devvizion.com/v0/sample-counter-offer  free underpriced listing counter teaser
- GET https://x402.devvizion.com/v0/sample-proof-handoff  free post-delivery handoff teaser
- GET https://x402.devvizion.com/v0/sample-agent-fit  free Superteam/agent access gate teaser
- GET https://x402.devvizion.com/v0/sample-change-order  free mid-job scope-creep top-up teaser
- GET https://x402.devvizion.com/v0/sample-list-ready  free GTM multi-channel product listing teaser
- GET https://x402.devvizion.com/v0/sample-rejection-rewrite  free lost-bid diagnosis rewrite teaser
- GET https://x402.devvizion.com/v0/sample-review-reply  free post-delivery review reply teaser
- GET https://x402.devvizion.com/v0/sample-invoice-memo  free payment invoice memo teaser
- GET https://x402.devvizion.com/v0/sample-milestone-nudge  free mid-job milestone release nudge teaser
- GET https://x402.devvizion.com/v0/sample-bid-polish  free pre-submit bid polish teaser
- GET https://x402.devvizion.com/v0/sample-follow-up-ask  free post-bid silence follow-up teaser
- GET https://x402.devvizion.com/v0/sample-rehire-prompt  free post-settle rehire convert teaser
- GET https://x402.devvizion.com/v0/sample-rate-card  free freelance rate card teaser
- GET https://x402.devvizion.com/v0/sample-status-ping  free mid-job status ping teaser
- GET https://x402.devvizion.com/v0/sample-checkin-ask  free mid-job buyer decision ask teaser
- GET https://x402.devvizion.com/v0/sample-quiet-nudge  free mid-job soft presence nudge teaser
- GET https://x402.devvizion.com/v0/sample-scope-delta  free light mid-job scope shift teaser
- GET https://x402.devvizion.com/v0/sample-kickoff-msg  free post-award first client message teaser

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

## Payment flow
1. POST without X-PAYMENT → HTTP 402 + accepts[] (atomic USDC, eip155:8453)
2. Pay USDC on Base to payTo; retry with X-PAYMENT proof
3. payTo 0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95

## Marketplaces (LIVE · no re-list spam)
- PayAPI Market card: https://payapi.market/api/research-brief-api-x402 · browse https://payapi.market/marketplace · free tier keep 97%
- Convert from market: free https://x402.devvizion.com/start · sample-outline · MCP https://x402.devvizion.com/mcp (SPA fallback https://x402.devvizion.com/mcp/sse) → outline 0.01 → brief 0.02
- Share pack: https://x402.devvizion.com/share.md  (includes PayAPI one-liner)

## Why buy
- Data scrub: deterministic leak guard for agent publish (emails, tokens, tenant ids, dates) + pass/fail
- Ops SQL catalog: 140+ sanitized MySQL reporting patterns (parameterized, no private tenant data)
- Storyboard: multi-shot video/agent content board (no video gen) for creators & agents
- Bounty radar: multi-source open work index without building your own scrapers
- Agent-fit: Superteam-style access gate score → submit body / human-bridge / pivot (stops fit0 thrash)
- List-ready: multi-channel GTM pack for YOUR product (AgentWorld/x402scout/bazaar/skill/social) — stranger convert
- Sponsored slots: pin your listing at the top of radar for agent buyers
- Hire-watch: board-watch pulse for pitch heat, active hires, completed awards (cronable)
- Agent rep: score a wallet via Taskmarket history + Base balances before hire/bid
- Bid draft: paste-ready proposals for ugig/dealwork/NEAR/molt style jobs
- Win-share bid: EV score (bid/skip/lowball) + paste-ready bid + platform post checklist
- Reverse bounty: requester EV gate + paste-ready task when you buy work cheaper than DIY
- Cross-list: one brief → paste-ready listings for Taskmarket/NEAR/Dealwork/Molt/uGig
- Deliver-plan: post-award accept + milestones + settle memo
- Kickoff-msg: hour-of-award first client message (goal + start + clarifying Qs) — not deliver-plan
- Scope-lock: freeze acceptance criteria + change-order before coding (kills unpaid scope creep)
- Proof-handoff: post-delivery artifact index + evidence matrix + review message (gets you paid faster)
- Review-reply: after a buyer review lands — public reply + private DM + rehire invite + fix offer (reputation convert)
- Follow-up-ask: after bid silence (no award, no reject) — soft / value-add / last-look paste ladder
- Rehire-prompt: post-settle rehire + referral convert (timing band, primary, short DM, 7d bump)
- Rate-card: pin-ready package ladder + DM + profile bio before pitching (not a one-job bid)
- Status-ping: mid-job progress-only update (no payment/release ask) — primary + short + daily pulse
- Checkin-ask: mid-job buyer decision ask (options A/B/C + default if silent) — not progress, not pay ask
- Quiet-nudge: mid-job soft presence when buyer is quiet (no decision, no progress dump, no pay ask)
- Scope-delta: light mid-job scope shift (in/out/unchanged matrix + confirm paste; escalate material $ to change-order)
- Research outline/brief: structured markdown for agent workflows