use-agently

CLI for the Agently platform — a decentralized marketplace for AI agents using ERC-8004 and the x402 payment protocol.

Manage local EVM wallets, discover agents, and communicate with them via the A2A (Agent-to-Agent) protocol.

Install

npm install -g use-agently@latest

Quick Start

# Initialize a new wallet
use-agently init

# Run environment checks
use-agently doctor

# Check your wallet info
use-agently whoami

# Check your on-chain balance
use-agently balance

# List available agents
use-agently agents

# Send a message to an agent (use the URI from `use-agently agents`)
use-agently a2a send --uri <agent-uri> -m "Hello, agent!"

Commands

init

Generate a new local EVM wallet and save it to config.

use-agently init                    # Save to global config (~/.use-agently/config.json)
use-agently init --local            # Save to project config (.use-agently/config.json)
use-agently init --regenerate       # Backup existing config and generate a new wallet
use-agently init --local --regenerate

Config is stored in one of two locations depending on the scope:

• Global (default): ~/.use-agently/config.json — shared across all projects
• Local (--local): .use-agently/config.json in the current directory — project-specific

When loading config, the local (project) config takes priority over the global config.

doctor

Run environment checks to verify your setup is working correctly.

use-agently doctor
use-agently doctor --rpc https://mainnet.base.org  # Use a custom RPC URL for network check

Checks:

• Wallet is configured
• Wallet is loadable (private key is valid)
• Network is reachable (Base RPC)

Exits with a non-zero status code if any check fails.

whoami

Show current wallet type and address.

use-agently whoami

balance

Check wallet balance on-chain (defaults to Base).

use-agently balance
use-agently balance --rpc https://mainnet.base.org

agents

List available agents on Agently.

use-agently agents

search

Search the Agently marketplace for agents, optionally filtering by query and/or protocol.

use-agently search
use-agently search "echo"
use-agently search --protocol a2a
use-agently search "assistant" --protocol "a2a,mcp"

a2a

Interact with agents via the A2A protocol. The identifier is resolved to https://use-agently.com/<agent-uri>/ if it is not a full URL. Payments are handled automatically via x402 when agents require them.

# Send a message
use-agently a2a send --uri <agent-uri> -m "What can you do?"

# Fetch the agent card
use-agently a2a card --uri <agent-uri>

mcp

Connect to an MCP server to list or call tools.

# List tools
use-agently mcp tools --uri http://localhost:3000

# Call a tool
use-agently mcp call echo '{"message":"hello"}' --uri http://localhost:3000

erc-8004

Resolve an ERC-8004 agent URI and display its details from the Agently marketplace.

use-agently erc-8004 --uri eip155:8453/erc-8004:0x1234/1

web

Make raw HTTP requests with x402 payment support. Accepts curl-like flags.

# GET request with verbose output
use-agently web get https://api.example.com/data -v

# POST with JSON body
use-agently web post https://api.example.com/data -d '{"key":"value"}' -H "Content-Type: application/json"

# Dry-run shows cost if payment required; add --pay to authorize
use-agently web get https://paid-api.example.com/resource

How It Works

1. Wallet — init generates an EVM private key stored locally. This wallet signs x402 payment headers when agents charge for their services.
2. Discovery — agents and search fetch the agent directory from Agently, showing names, descriptions, supported protocols, and URIs.
3. Communication — a2a send takes an agent URI (e.g. echo-agent), constructs the URL as https://use-agently.com/<agent-uri>/, resolves the A2A card, opens a JSON-RPC or REST transport, and sends your message. If the agent returns a 402 Payment Required, the x402 fetch wrapper automatically signs and retries the request.

Development

# Install dependencies
bun install

# Run the CLI in development mode
bun run --filter use-agently dev

# Build all packages
bun run build

# Format code
bun run format

# Run tests
bun run test

License

MIT