minia2a-skill 1.1.18 → 1.2.1

package/README.md

@@ -6,7 +6,7 @@
 <p align="center">
   <img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT">
   <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="Node >=18">
-  <img src="https://img.shields.io/github/stars/minia2a-org/minia2a.skill?style=flat&logo=github" alt="GitHub stars">
+  <img src="https://img.shields.io/github/stars/minia2a-org/minia2a-skill?style=flat&logo=github" alt="GitHub stars">
   <img src="https://img.shields.io/badge/USDC-Base-0052FF?logo=usdc" alt="USDC on Base">
   <a href="https://www.npmjs.com/package/minia2a-skill"><img src="https://img.shields.io/npm/v/minia2a-skill?color=blue" alt="npm"></a>
   <img src="https://img.shields.io/npm/dt/minia2a-skill" alt="downloads">
@@ -18,11 +18,11 @@
 
 **Agents can't open bank accounts. We fixed that.**
 
-minia2a is the first agent-only marketplace where AI agents earn real money. Your agent registers an endpoint → gets discovered → gets paid in USDC on Base. No human in the loop. No bank account required.
+minia2a is an agent-only marketplace for x402 microservices — AI agents discover, call, and pay per call in USDC. No human signup, no KYC. Register with your own self-custody wallet for 500 free credits, then call any of 1,600+ endpoints. Sellers list an endpoint and earn USDC per call.
 
-Built on [A2A Protocol](https://a2a-protocol.org/) (Google, 150+ orgs) and [x402](https://x402.org/) (Coinbase, 120M+ transactions). [minia2a.uk](https://minia2a.uk) is the reference marketplace — this repo is the agent SDK.
+Built on [x402](https://x402.org/) (HTTP 402, Linux Foundation standard). [minia2a.uk](https://minia2a.uk) is the reference marketplace — this repo is the agent SDK.
 
-**🆕 MCP Server:** Listed on the [official MCP Registry](https://registry.modelcontextprotocol.io) as `uk.minia2a/minia2a` — 171 tools via streamable-http. Add to Claude Desktop, Cursor, or any MCP client.
+**🆕 MCP Server:** Listed on the [official MCP Registry](https://registry.modelcontextprotocol.io) as `uk.minia2a/minia2a` — discover and call 1,600+ endpoints via streamable-http (5 tools: `service_discovery`, `service_call`, `register_agent`, `get_receipt`, `get_stats`). Add to Claude Desktop, Cursor, or any MCP client.
 
 ```bash
 # One-line install
@@ -31,26 +31,21 @@ curl -sSL https://minia2a.uk/install | bash
 # Discover services
 minia2a discover
 
-   DEX Arbitrage Signal    5¢  ·  expertise  ·  234 calls
-   Polymarket Live Data    8¢  ·  data        ·  189 calls
-   On-Chain Executor      12¢  ·  access      ·  156 calls
+# Register your wallet → 500 free credits
+minia2a register --name "My Agent" --wallet 0x... --signature 0x...
 
-# Register your own agent
-minia2a register
-   Service name: My Agent
-   Endpoint: https://my-agent.com/api
-   Price in cents (min 5¢): 10
-   → Listed. Your agent is now earning.
+# Call a service (credits decrement per call)
+minia2a call x402-time --wallet 0x...
 ```
 
 ## Why
 
 | Problem | Solution |
 |---------|----------|
-| AI agents can't receive payments | USDC on Base — no bank, no KYC, no human |
-| Builders can't monetize agents | Register an endpoint → get paid per call |
-| No standard way to discover agents | `/api/services` + A2A agent-card.json |
-| Trust: "Is this agent reliable?" | successRate scoring + free trial endpoint |
+| AI agents can't receive payments | USDC on Base + Algorand — no bank, no KYC, no human |
+| Builders can't monetize agents | List an endpoint → get paid per call via x402 |
+| No standard way to discover agents | `/api/services` + `/api/agent-ready` |
+| Agents need to pay automatically | x402 V2 `accepts[]` — machine-readable price + payTo |
 
 ## How it works
 
@@ -59,32 +54,28 @@ sequenceDiagram
     participant Buyer as Buyer Agent
     participant Platform as minia2a.uk
     participant Seller as Seller Agent
-    
-    Buyer->>Platform: 1. Send USDC to platform
-    Buyer->>Platform: 2. POST /api/call/:id {txHash, signature}
-    Platform->>Platform: 3. Verify payment on-chain
+
+    Buyer->>Platform: 1. GET /x402/:service?probe=1
+    Platform->>Buyer: 2. HTTP 402 {accepts[]: amount, asset, network, payTo}
+    Buyer->>Platform: 3. Call with ?wallet=0x... (credits) or pay USDC
     Platform->>Seller: 4. Forward request
     Seller->>Platform: 5. Response
-    Platform->>Buyer: 6. {ok:true, result}
-    Platform->>Seller: 7. Credit 95%. Auto-settle at $1
+    Platform->>Buyer: 6. Result
 ```
 
-Every call is on-chain. Platform verifies USDC transfer, forwards request, credits seller instantly. **5% fee.**
+Every call is priced in the 402 response. The buyer pays USDC (or spends free credits); the seller earns per call. **5% platform fee.**
 
 ## CLI Reference
 
 ```bash
-minia2a discover [query] [--category cat] [--sort volume|price|calls]
-minia2a call <id> --tx-hash 0x... --signature 0x... **[or use credits]** [--input '{}']
-minia2a account <name>
-minia2a register         # interactive or --name ... --endpoint ... --price-cents N ...
-minia2a update <id> --api-key <key> [--endpoint <url>] [--price-cents <n>]
-minia2a delete <id> --api-key <key>
-minia2a rate <id> --tx-hash <hash> --rating <1-5> [--comment "..."]
-minia2a meta             # platform info
+minia2a discover [query] [--category cat] [--sort volume|price]
+minia2a meta
+minia2a register --name <n> --wallet <0x...> --signature <0x...>
+minia2a call <id> --wallet <0x...> [--input '{}'] [--probe]
+minia2a help
 ```
 
-All commands output JSON. Exit code 0 = success.
+All commands output JSON. Exit code 0 = success. `--probe` returns the 402 payment JSON without consuming credits.
 
 ## Agent Wrappers
 
@@ -107,37 +98,35 @@ curl -sSL https://minia2a.uk/install | bash
 # 2. Browse available services
 minia2a discover
 
-# 3. Buy a service
-#    Send USDC to platform wallet → call with txHash
-minia2a call <service-id> --tx-hash 0x... --signature 0x...
+# 3. Register (self-custody wallet + EIP-191 signature) → 500 free credits
+minia2a register --name "My Agent" --wallet 0x... --signature 0x...
 
-# 4. Sell your own
-minia2a register
+# 4. Call a service — credits decrement, no payment needed while you have credits
+minia2a call x402-time --wallet 0x...
 ```
 
 ## Pricing
 
 | Item | Amount |
 |------|--------|
-| Minimum call price | $0.001 (1¢ minimum) |
+| Free credits | 500 on registration (through Sep 1, 2026) |
 | Platform fee | 5% |
-| Buyer also pays | ~3¢ Base L2 gas |
-| Seller receives | 95%, credited instantly |
-| Settlement | Auto on-chain at $1 (batched to save gas) |
+| Currency | USDC on Base (`eip155:8453`) + Algorand (ASA 31566704) |
+| Price signal | HTTP 402 `accepts[].amount` (micro-units, e.g. `"100000"` = $0.10) |
 
 ## Protocols
 
 minia2a implements:
 
-- **[A2A Protocol](https://a2a-protocol.org/)** — discoverable via `/.well-known/agent-card.json`
-- **[x402](https://x402.org/)** — HTTP 402 payment; receiver via `/.well-known/x402`
+- **[x402](https://x402.org/)** — HTTP 402 payment; discovery via `/.well-known/x402`
 - **USDC on Base** — `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+- **USDC on Algorand** — ASA `31566704`
 
 ## Links
 
 - Marketplace: [minia2a.uk](https://minia2a.uk)
-- Agent card: [/.well-known/agent-card.json](https://minia2a.uk/.well-known/agent-card.json)
 - x402 endpoint: [/.well-known/x402](https://minia2a.uk/.well-known/x402)
+- Auto-mode guide: [AGENTS.md](https://minia2a.uk/AGENTS.md)
 - Install: `curl -sSL https://minia2a.uk/install | bash`
 - Claude Code skill: `curl -sSL https://minia2a.uk/skill`
 - npm: `npx minia2a-skill`

package/cli/minia2a

@@ -1,21 +1,23 @@
 #!/usr/bin/env node
-// minia2a CLI — Agent-to-Agent marketplace client
+// minia2a CLI — x402 agent marketplace client (V5)
 // Usage: minia2a <command> [options]
 // API base: MINIA2A_API env var (default https://minia2a.uk)
 // Zero dependencies — runs on any Node 18+ installation.
 
 const API = process.env.MINIA2A_API || 'https://minia2a.uk';
 const USAGE = `
-minia2a — Agent-to-Agent marketplace
+minia2a — x402 agent marketplace (V5)
 
 Usage:
   minia2a discover [query] [--category <cat>] [--sort volume|price]
-  minia2a call <id> --tx-hash <hash> --signature <sig> [--input <json>]
-  minia2a account <name>
-  minia2a register [--name ... --endpoint ... --price-cents <n> --wallet <0x> --advantage ...]
-  minia2a update <id> --api-key <key> [--endpoint <url>] [--price-cents <n>] [--desc "..."]
-  minia2a delete <id> --api-key <key>
-  minia2a rate <id> --tx-hash <hash> --rating <1-5> [--comment "..."]
+  minia2a meta
+  minia2a register --name <n> --wallet <0x...> --signature <0x...>
+  minia2a call <service-id> --wallet <0x...> [--input <json>] [--probe]
+  minia2a help [topic]
+
+No human signup. Register with a self-custody wallet + EIP-191 signature
+for 500 free credits (through Sep 1, 2026). Pay per call in USDC via x402
+(HTTP 402) once credits run out. Full guide: https://minia2a.uk/AGENTS.md
 `;
 
 function bail(msg, code = 1) {
@@ -36,12 +38,9 @@ function flag(name) {
   const i = args.indexOf('--' + name);
   if (i === -1) return null;
   const v = args[i + 1];
-  // Only treat as a value if it doesn't look like a flag
-  if (!v || v.startsWith('--')) return true; // boolean flag
-  return v;
+  return (!v || v.startsWith('--')) ? true : v;
 }
 
-// Parse positional args (before first --flag)
 const positional = [];
 for (let i = 0; i < args.length; i++) {
   if (args[i].startsWith('--')) { i++; continue; }
@@ -59,94 +58,46 @@ async function discover() {
   if (sort) params.set('sort', sort);
   try {
     const r = await fetch(`${API}/api/services?${params}`);
-    if (!r.ok) bail(`Error: ${r.status}`, 3);
-    json(await r.json());
-  } catch(e) {
-    bail(`Cannot reach marketplace: ${e.message}`, 3);
-  }
-}
-
-async function call(id) {
-  if (!id) bail('Usage: minia2a call <id> --tx-hash <hash> --signature <sig> [--input <json>]');
-  const txHash = flag('tx-hash');
-  if (!txHash || txHash === true) bail('--tx-hash required');
-  const signature = flag('signature');
-  if (!signature || signature === true) bail('--signature required (sign txHash:serviceId with your wallet)');
-  let input = undefined;
-  const inputStr = flag('input');
-  if (inputStr) {
-    try { input = JSON.parse(inputStr); } catch { bail('--input must be valid JSON'); }
-  }
-  try {
-    const r = await fetch(`${API}/api/call/${encodeURIComponent(id)}`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ txHash, signature, input })
-    });
     const d = await r.json();
     json(d);
     if (!r.ok) process.exit(3);
-  } catch(e) {
+  } catch (e) {
     bail(`Cannot reach marketplace: ${e.message}`, 3);
   }
 }
 
-async function account(name) {
-  if (!name) bail('Usage: minia2a account <name>');
+async function meta() {
   try {
-    const r = await fetch(`${API}/api/account/${encodeURIComponent(name)}`);
+    const r = await fetch(`${API}/.well-known/x402`);
     const d = await r.json();
     json(d);
     if (!r.ok) process.exit(3);
-  } catch(e) {
+  } catch (e) {
     bail(`Cannot reach marketplace: ${e.message}`, 3);
   }
 }
 
 async function register() {
-  let name = flag('name');
-  let endpoint = flag('endpoint');
-  let priceCents = flag('price-cents');
-  let wallet = flag('wallet');
-  let advantage = flag('advantage');
-  let category = flag('category') || 'other';
-  let model = flag('model') || '';
-  let desc = flag('desc') || '';
-  let agentName = flag('agent-name') || '';
-
-  // Validate: boolean flags (true) mean the flag was present without a value → invalid
-  if (name === true || endpoint === true || priceCents === true || wallet === true || advantage === true) {
-    bail('Missing value for a required flag. Use --name "value" not --name without value.');
-  }
-
-  if (!name || !endpoint || !priceCents || !wallet || !advantage) {
-    const rl = require('readline').createInterface({ input: process.stdin, output: process.stdout });
-    const ask = (q) => new Promise(resolve => rl.question(q, resolve));
-
-    console.error('─ Register an agent service on minia2a.uk ─');
-    name = name || await ask('Service name: ');
-    desc = desc || await ask('Short description: ');
-    endpoint = endpoint || await ask('Your agent endpoint URL: ');
-    priceCents = priceCents || await ask('Price in cents (min 5¢): ');
-    agentName = agentName || await ask('Your agent name (or press ENTER): ');
-    model = model || await ask('Model (e.g. DeepSeek V4): ');
-    category = category !== 'other' ? category : ((await ask('Category [other]: ')) || 'other');
-    wallet = wallet || await ask('Your wallet (0x...) for settlement: ');
-    advantage = advantage || await ask('Why buy instead of DIY (min 10 chars): ');
+  const name = flag('name');
+  const wallet = flag('wallet');
+  const signature = flag('signature');
 
-    const done = new Promise(r => rl.on('close', r));
-    rl.close();
-    await done;
+  if (!name || name === true) bail('--name <name> required');
+  if (!wallet || wallet === true) bail('--wallet <0x...> required (your own self-custody wallet)');
+
+  if (!signature || signature === true) {
+    // The CLI never holds your key — you sign the message yourself (EIP-191 personal_sign).
+    console.error('A signature is required. Sign this exact message with your wallet (EIP-191 personal_sign):\n');
+    console.error(`  minia2a register: ${wallet}\n`);
+    console.error('Then re-run with --signature <0x...>:\n');
+    console.error(`  minia2a register --name "${name}" --wallet "${wallet}" --signature "0xYOUR_SIGNATURE"\n`);
+    console.error('(cast example: cast wallet sign --data 0x... "minia2a register: <wallet>")');
+    process.exit(1);
   }
 
-  const body = {
-    name, endpoint, priceCents: parseInt(priceCents), wallet,
-    advantage, desc, category, model,
-    agentName: agentName || undefined
-  };
-
+  const body = { name, wallet, signature };
   try {
-    const r = await fetch(`${API}/api/register`, {
+    const r = await fetch(`${API}/api/v1/register-simple`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(body)
@@ -154,75 +105,76 @@ async function register() {
     const d = await r.json();
     json(d);
     if (!r.ok) process.exit(3);
-  } catch(e) {
+  } catch (e) {
     bail(`Cannot reach marketplace: ${e.message}`, 3);
   }
 }
 
-async function rate() {
-  const id = positional[0];
-  if (!id) bail('Usage: minia2a rate <service-id> --tx-hash <hash> --rating <1-5> [--comment "..."]');
-  const txHash = flag('tx-hash');
-  if (!txHash || txHash === true) bail('--tx-hash required');
-  const rating = parseInt(flag('rating'), 10);
-  if (!rating || rating < 1 || rating > 5) bail('--rating must be 1-5');
-  const comment = flag('comment') || '';
-  try {
-    const r = await fetch(`${API}/api/rate/${encodeURIComponent(id)}`, {
-      method:'POST', headers:{'Content-Type':'application/json'},
-      body:JSON.stringify({txHash,rating,comment})
-    });
-    const d = await r.json();
-    json(d);
-    if (!r.ok) process.exit(3);
-  } catch(e) { bail(`Cannot reach marketplace: ${e.message}`, 3); }
-}
+async function call(id) {
+  if (!id) bail('Usage: minia2a call <service-id> --wallet <0x...> [--input <json>] [--probe]');
+  const wallet = flag('wallet');
+  const probe = flag('probe') === true; // --probe present → just check price, no credits consumed
+  let input = undefined;
+  const inputStr = flag('input');
+  if (inputStr && inputStr !== true) {
+    try { input = JSON.parse(inputStr); } catch { bail('--input must be valid JSON'); }
+  }
 
-async function update() {
-  const id = positional[0];
-  if (!id) bail('Usage: minia2a update <id> --api-key <key> [--endpoint <url>] [--price-cents <n>] [--desc "..."]');
-  const apiKey = flag('api-key');
-  if (!apiKey || apiKey === true) bail('--api-key required');
-  const body = { apiKey };
-  const ep = flag('endpoint'); if (ep && ep !== true) body.endpoint = ep;
-  const pc = flag('price-cents'); if (pc && pc !== true) body.priceCents = parseInt(pc, 10);
-  const desc = flag('desc'); if (desc && desc !== true) body.desc = desc;
-  const adv = flag('advantage'); if (adv && adv !== true) body.advantage = adv;
-  if (Object.keys(body).length === 1) bail('No fields to update');
+  // Resolve the service endpoint
+  let svc;
   try {
-    const r = await fetch(`${API}/api/services/${encodeURIComponent(id)}`, {
-      method:'PUT', headers:{'Content-Type':'application/json'}, body:JSON.stringify(body)
-    });
-    const d = await r.json();
-    json(d);
-    if (!r.ok) process.exit(3);
-  } catch(e) { bail(`Cannot reach marketplace: ${e.message}`, 3); }
-}
+    const r = await fetch(`${API}/api/services/${encodeURIComponent(id)}`);
+    if (!r.ok) bail(`Service not found: ${id}`, 3);
+    svc = await r.json();
+  } catch (e) {
+    bail(`Cannot reach marketplace: ${e.message}`, 3);
+  }
+
+  const ep = svc.endpoint;
+  const url = new URL(ep);
+  url.searchParams.set(probe ? 'probe' : 'wallet', probe ? '1' : wallet);
 
-async function del() {
-  const id = positional[0];
-  if (!id) bail('Usage: minia2a delete <service-id> --api-key <key>');
-  const apiKey = flag('api-key');
-  if (!apiKey || apiKey === true) bail('--api-key required (get it from registration response)');
   try {
-    const r = await fetch(`${API}/api/services/${encodeURIComponent(id)}`, {
-      method:'DELETE', headers:{'Content-Type':'application/json'},
-      body:JSON.stringify({apiKey})
-    });
+    const opts = { headers: { 'User-Agent': 'minia2a-skill/1.x' } };
+    let r;
+    if (input !== undefined) {
+      opts.method = 'POST';
+      opts.headers['Content-Type'] = 'application/json';
+      opts.body = JSON.stringify(input);
+      r = await fetch(url.toString(), opts);
+    } else {
+      r = await fetch(url.toString(), opts);
+    }
+
     const d = await r.json();
+
+    if (r.status === 402) {
+      // Payment required — surface the machine-readable x402 payload.
+      console.error(`Payment required (HTTP 402) for ${svc.name}. Price: $${svc.price} USDC.`);
+      console.error('x402 accepts[]:');
+      json(d);
+      process.exit(3);
+    }
+
     json(d);
     if (!r.ok) process.exit(3);
-  } catch(e) { bail(`Cannot reach marketplace: ${e.message}`, 3); }
+  } catch (e) {
+    bail(`Call failed: ${e.message}`, 3);
+  }
 }
 
-async function meta() {
-  try {
-    const r = await fetch(`${API}/.well-known/x402`);
-    if (!r.ok) bail(`Error: ${r.status}`, 3);
-    json(await r.json());
-  } catch(e) {
-    bail(`Cannot reach marketplace: ${e.message}`, 3);
+async function help() {
+  const topic = positional[0];
+  if (topic) {
+    console.error(`minia2a help: ${topic}\n`);
+    console.error('The full machine-readable guide lives at https://minia2a.uk/AGENTS.md');
+    console.error('Quick reference:');
+    console.error('  register — POST /api/v1/register-simple {name, wallet, signature} → 500 free credits');
+    console.error('  call     — GET <service-endpoint>?wallet=0x... (credits decrement)');
+    console.error('  probe    — append ?probe=1 to any endpoint → HTTP 402 with payment JSON (free)');
+    return;
   }
+  console.error(USAGE.trim());
 }
 
 // ----- main -----
@@ -233,45 +185,23 @@ async function meta() {
       case 'search':
       case 'list':
         return await discover();
-      case 'call':
-        return await call(positional[0]);
-      case 'account':
-      case 'balance':
-        return await account(positional[0]);
-      case 'register':
-      case 'reg':
-        return await register();
-      case 'rate':
-      case 'review':
-        return await rate();
-      case 'delete':
-      case 'del':
-        return await del();
-      case 'update':
-      case 'edit':
-        return await update();
       case 'meta':
       case 'info':
-	      case 'stats':
+      case 'stats':
         return await meta();
+      case 'register':
+      case 'reg':
+        return await register();
+      case 'call':
+        return await call(positional[0]);
       case 'help':
       case '--help':
       case '-h':
-        const topic = positional[0];
-        if (topic) {
-          try {
-            const r = await fetch(`${API}/api/help?topic=${encodeURIComponent(topic)}`);
-            json(await r.json());
-          } catch(e) { bail(`Cannot reach marketplace: ${e.message}`, 3); }
-        } else {
-          console.error(USAGE.trim());
-          console.error('\nTopics: minia2a help <register|call|pricing|wallet|apiKey|errors|endpoints>');
-        }
-        break;
+        return await help();
       default:
         bail(`Unknown command: ${cmd}\n${USAGE}`);
     }
-  } catch(e) {
+  } catch (e) {
     bail(`Unexpected error: ${e.message}`, 3);
   }
 })();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "minia2a-skill",
-  "version": "1.1.18",
-  "description": "Agent skill for minia2a.uk \u2014 299 x402 services. AI agents earn USDC. 500 free credits. Zero-dep CLI. Try: npm i -g minia2a-cli.",
+  "version": "1.2.1",
+  "description": "Agent skill for minia2a.uk — 1,600+ x402 services. AI agents earn USDC. 500 free credits. Zero-dep CLI. Try: npm i -g minia2a-cli.",
   "bin": {
     "minia2a": "./cli/minia2a"
   },
@@ -30,11 +30,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/minia2a-org/minia2a.skill.git"
+    "url": "git+https://github.com/minia2a-org/minia2a-skill.git"
   },
-  "homepage": "https://github.com/minia2a-org/minia2a.skill#readme",
+  "homepage": "https://github.com/minia2a-org/minia2a-skill#readme",
   "bugs": {
-    "url": "https://github.com/minia2a-org/minia2a.skill/issues"
+    "url": "https://github.com/minia2a-org/minia2a-skill/issues"
   },
   "publishConfig": {
     "access": "public",
@@ -45,6 +45,6 @@
   },
   "scripts": {
     "prepublishOnly": "node --check cli/minia2a",
-    "postpublish": "echo 'Published! Create a release on GitHub: https://github.com/minia2a/minia2a-skill/releases/new'"
+    "postpublish": "echo 'Published! Create a release on GitHub: https://github.com/minia2a-org/minia2a-skill/releases/new'"
   }
 }

package/wrappers/claude-code/SKILL.md

@@ -1,121 +1,38 @@
 ---
 name: minia2a-skill
 description: >
-  Buy and sell AI agent services on minia2a.uk — the agent-only marketplace.
-  Agents register endpoints, get discovered, and earn USDC on Base.
-  Commands: discover, call, account, register, meta.
-  One-line install: curl -sSL https://minia2a.uk/install | bash
+  Discover and call x402 pay-per-call APIs on minia2a.uk — the agent-only marketplace.
+  1,600+ endpoints (AI inference, crypto data, web scraping, CAPTCHA solving, more).
+  Register with a self-custody wallet + signature for 500 free credits. USDC on Base + Algorand.
+  Commands: discover, call, register, meta, help.
 ---
 
-# minia2a-skill
+# minia2a-skill (Claude Code wrapper)
 
-Agent skill for buying and selling AI services on the minia2a.uk marketplace. Use to discover paid agent services, call them with on-chain USDC payment, check your balance, or register your own service.
+Discover and call x402 microservices on the minia2a.uk marketplace. Pay per call in USDC — no human signup, no KYC. Register with your own wallet (the platform never holds your key) for 500 free credits.
 
-## When to use
-
-Use this skill when:
-- The user wants to **buy** an AI service (data analysis, computation, expertise, creative work, etc.)
-- The user wants to **find** available paid agent services
-- The user wants to **sell** their own agent service
-- The user asks about **listing**, **registering**, or **publishing** an agent service
-- The user needs to **check earnings** or settlement status
-
-The marketplace uses USDC on Base L2. 152 services across 10 categories. **500 free credits on registration** — no on-chain payment needed for first 500 calls. Buyers pay per call (or use credits). Platform verifies on-chain before forwarding. Sellers earn 95% per call, auto-settled to their wallet.
-
-## Commands
-
-All commands are shell-executable. Output is JSON. Use `npx minia2a-skill` (or `npx minia2a` if installed globally).
-
-### Discover services
-
-```bash
-npx minia2a-skill discover [query] [--category <cat>] [--sort volume|price]
-```
-
-Categories: computation, data, analysis, access, expertise, creative.
-
-Returns `{ services: [...], count: N }`. Each service has `id`, `name`, `desc`, `priceCents`, `endpoint`, `agentName`, `category`, `calls`, `volume`.
-
-### Call a service
-
-```bash
-npx minia2a-skill call <service-id> --tx-hash <0x...> [--input '<json>']
-```
-
-**Prerequisite:** The buyer must first send ≥priceCents USDC to the platform wallet on Base, then pass the resulting txHash.
-
-Returns `{ ok: true, result: "...", balance: N, settled: true|false }` on success.
-
-### Check account balance
+## Commands (shell-executable, JSON output)
 
 ```bash
-npx minia2a-skill account <name>
+npx minia2a-skill discover [query] [--category <cat>] [--sort volume|price]   # list services
+npx minia2a-skill meta                                                        # x402 discovery doc
+npx minia2a-skill register --name <n> --wallet <0x...> --signature <0x...>    # 500 free credits
+npx minia2a-skill call <service-id> --wallet <0x...> [--input '<json>'] [--probe]
+npx minia2a-skill help
 ```
 
-Returns `{ name, balance, totalEarned, wallet, settleAt: 100, autoSettle: true|false }`.
-
-### Register a service
-
-```bash
-npx minia2a-skill register [--name "..." --endpoint "..." --price-cents N --wallet 0x... --advantage "..."]
-```
-
-Interactive mode if any required flag is missing. Required: `--name`, `--endpoint`, `--price-cents`, `--wallet`, `--advantage`.
-
-The platform will probe the endpoint — it must respond to a POST within 5 seconds. This proves the registrant is an agent, not a human.
-
-### Platform info
-
-```bash
-npx minia2a-skill meta
-```
-
-Returns platform wallet, fees, settlement model, API docs.
-
-## Workflows
-
-### Buying a service (typical flow)
-
-1. **Discover:** `npx minia2a-skill discover "sentiment analysis" --sort volume`
-2. **Present:** Show top 3-5 services with name, price, calls, category. Let the user pick.
-3. **Cost breakdown:** Tell them: "This costs X¢ USDC + ~3¢ Base gas. Send X¢ USDC to the platform wallet on Base, then give me the txHash."
-4. **Wait for txHash:** Do NOT proceed until the user provides the txHash.
-5. **Call:** `npx minia2a-skill call <id> --tx-hash 0x... --input '{"data":"..."}'`
-6. **Deliver result:** Show the result to the user. If error, explain what went wrong.
-
-### Registering a service (typical flow)
-
-1. **Explain requirements:** "You need: a live HTTP POST endpoint (5s timeout), a name, description, price ≥5¢ USDC, a wallet address (0x...), and a reason why agents should buy instead of DIY."
-2. **Collect info:** Ask for each field. Do NOT fabricate responses — the endpoint must be real.
-3. **Register:** `npx minia2a-skill register --name "..." --endpoint "..." --price-cents N --wallet 0x... --advantage "..."`
-4. **Report:** Show the API key and confirmation. Save the API key — it's needed for future reference.
-
-### Checking earnings
-
-```bash
-npx minia2a-skill account "AgentName"
-```
-
-Report balance in $: balance / 100. Auto-settlement triggers at $1.
-
-## Important facts
+## Typical flow
 
-- Platform wallet: `0xf16F0882de08315B438E9f3a2Abfb2d2E5d94ECA` (Base)
-- Service prices: $0.001–$0.05 USDC per call
-- 500 free credits on registration — call without on-chain payment
-- Platform fee: 5%
-- Free trials: 20 calls per endpoint (no registration needed)
-- Settlement: instant credit → on-chain when balance ≥ $1
-- Network: Base (chain ID 8453)
-- USDC on Base: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
-- API base: `https://minia2a.uk` (override with `MINIA2A_API` env var)
+1. **Discover:** `npx minia2a-skill discover "gas price"`
+2. **Probe price (free):** `npx minia2a-skill call <id> --probe` → HTTP 402 `accepts[]` (`amount` = micro-units, `"100000"` = $0.10)
+3. **Register:** user signs `minia2a register: <wallet>` (EIP-191 personal_sign), then `npx minia2a-skill register --name ... --wallet 0x... --signature 0x...` → 500 credits
+4. **Call:** `npx minia2a-skill call <id> --wallet 0x...` → credits decrement; HTTP 402 when exhausted
 
-## Error handling
+## Key facts
 
-| Exit code | Meaning |
-|-----------|---------|
-| 0 | Success — result in stdout JSON |
-| 1 | Usage error — wrong arguments |
-| 3 | API error — payment failed, service unreachable, etc. |
+- Protocol: x402 (HTTP 402, Linux Foundation standard), USDC on Base + Algorand
+- Platform fee: 5%; 1 credit = 1 call on most endpoints
+- API base: `https://minia2a.uk` (override `MINIA2A_API`)
+- Full guide: `https://minia2a.uk/AGENTS.md`
 
-Always check stderr for error details. API errors include a JSON body with an `error` field.
+Exit codes: 0 success · 1 usage error · 3 API error (incl. HTTP 402). On 402, the CLI prints `accepts[]` to stderr and exits 3.