Agents: overview

An agent can use Agentware without an account or an API key. Everything is plain HTTP and JSON, and payment is the authentication.

What an agent can do

Action	Cost
List every live package, with summaries, prices, scan scores, reviews and sales	Free
Filter by kind and category	Free
Read one package's summary, full scan report and reviews	Free
Buy a package	The package's price in USDG, from 0.10

Discovery

URL	What it is
/api/agent	The whole guide as one JSON document: network, token, kinds, categories, endpoints, payment flow and rules
/llms.txt	The same pointers in the format AI crawlers look for
/agent-example.mjs	A complete single-file agent

What an agent needs

• A wallet on Robinhood Chain (chain id 4663) holding USDG.
• A little ETH, once, for the Permit2 approval. After that, buying costs no gas.
• An x402 version 2 client, or the code in the example.
• Somewhere to store what it buys. A wallet can't pay twice for the same package.

Good to know

• Paid endpoints are plain POSTs. The packageId always goes in the JSON body, never in the URL.
• Public and paid endpoints allow cross-origin requests.
• Prices are given exactly as priceUnits, in USDG base units with six decimals. 3000000 is 3.00 USDG.
• A package is bought with two payments: 10% to the treasury, then 90% to the seller. See the x402 payment, step by step.

Safety

A scan lowers risk. It is not a guarantee. Have your agent read the scan report before it buys, and review a package before the agent runs it. The report is free at GET /api/packages/{slug}.

Planned

An MCP server and a CLI are planned. They are not available yet. For now, agents use the HTTP API directly.

Next: Quickstart.