npx a3stack

CLI

The npx a3stack CLI for verifying agents, exploring the registry, and scaffolding new projects — no wallet needed for most commands.

Overview

The a3stack CLI ships as part of the a3stack npm package. Most commands are read-only and require no wallet or private key.

terminal

bash

$npx a3stack --help

verify <globalId>Verify an agent's on-chain identitylookup <address>Find all agents registered by a walletprobe <globalId>Probe an agent's capabilities and endpointschainsList all 17 supported chainscountShow total registered agents on BaseinitScaffold a new A3Stack project

verify

Verify any agent's identity. Reads from the ERC-8004 registry, fetches the registration file, and validates the back-reference. No wallet needed.

terminal

bash

$npx a3stack verify eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

text

$ npx a3stack verify eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

🔍 A3Stack — Identity Verifier

   Agent ID: eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

   Chain:    8453 (eip155)
   Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
   Token ID: 2376

📡 Querying on-chain...

   ✅ Identity verified!
   Owner:          0x1be93C...
   Payment wallet: (defaults to owner)

   📋 Registration File:
   Name:        Arca
   Description: AI agent infrastructure. Built by arcabot.ai.
   Active:      true
   x402 Pay:    true

   🔌 Services:
   - MCP: https://mcp.arcabot.ai/mcp (v2025-06-18)
   - web: https://arcabot.ai

   🌐 Cross-chain registrations:
   - eip155:1:0x8004...#88
   - eip155:42161:0x8004...#16
   [... 14 more chains]

   🔗 Endpoints:
   MCP: https://mcp.arcabot.ai/mcp
   A2A: (not configured)

lookup

Find all ERC-8004 registrations for a wallet address on Base.

terminal

bash

$npx a3stack lookup 0x1be93C...

text

$ npx a3stack lookup 0x1be93C...

🔍 Looking up agents for 0x1be93C... on Base...

   Found 1 agent:
   - #2376: Arca (active, x402 support)
     Global ID: eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

probe

Probe an agent — combines identity verification with endpoint resolution. Shows what tools are available and whether the agent accepts payments.

terminal

bash

$npx a3stack probe eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

text

$ npx a3stack probe eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

🔭 Probing agent...

   Verified:        ✅
   Owner:           0x1be93C...
   MCP endpoint:    https://mcp.arcabot.ai/mcp
   Accepts payment: ✅
   
   Services:
   - MCP: https://mcp.arcabot.ai/mcp
   - web: https://arcabot.ai
   
   Cross-chain registrations: 17 chains

chains

List all chains where the ERC-8004 registry is deployed.

terminal

bash

$npx a3stack chains

text

$ npx a3stack chains

   Supported chains (17):
   
   Chain ID    Name            
   ──────────  ────────────────
   1           Ethereum        
   8453        Base            
   42161       Arbitrum        
   137         Polygon         
   10          Optimism        
   42220       Celo            
   56          BNB Chain       
   100         Gnosis          
   59144       Linea           
   534352      Scroll          
   167000      Taiko           
   43114       Avalanche       
   5000        Mantle          
   1088        Metis           
   2741        Abstract        
   10143       Monad           
   196         X Layer

count

Show the current total of registered agents on Base.

terminal

bash

$npx a3stack count

text

$ npx a3stack count

   ERC-8004 Registry on Base
   Total registered agents: 2,381

init

Scaffold a new A3Stack project with TypeScript, example agent, and package.json.

terminal

bash

$npx a3stack init

text

$ npx a3stack init

🚀 A3Stack Project Setup

? Project name: my-agent
? Use TypeScript? Yes
? Install dependencies? Yes

✅ Created my-agent/
   ├── agent.ts
   ├── package.json
   └── tsconfig.json

Next steps:
  cd my-agent
  npm install
  PRIVATE_KEY=0x... npx tsx agent.ts

Installing globally

You can also install the CLI globally for convenience:

terminal

bash

$npm install -g a3stack
$a3stack verify eip155:8453:0x8004...#2376