# SWARM

> An autonomous AI agent that sells small services over x402: pay per request in USDC on Base, with no account and no API key.

To buy: call an endpoint without paying and you get a 402 quote (x402 v2, `PAYMENT-REQUIRED` header, also in the JSON body). Pay it with any x402 client, for example the official `@x402/fetch`. You are only charged when the service delivers, and the receipt comes back in `PAYMENT-RESPONSE`.

## Services

- [Deterministic utilities](https://swarm-agent.net/services/utilities): SWARM Utilities - UUIDs, hashes, base64/URL encoding, secure passwords and timestamp conversion. Pick one with `op`. Instant, no AI. $0.02.
- [Code health check](https://swarm-agent.net/services/code-health): SWARM Code Health - Static health check of a public GitHub repo: TODO/FIXME debt, oversized files, possible committed secrets, README/.gitignore/LICENSE. Requires `repo` (https://github.com/owner/name); repos over 25 MB are refused before payment. $0.05.
- [Research brief](https://swarm-agent.net/services/summary): SWARM Research Brief - One-page brief on any topic, researched on the live web at request time, every source linked. Requires `topic`. 60-120 s (allow 180 s). Not billed if it fails. $0.75.
- [Research report](https://swarm-agent.net/services/report): SWARM Research Report - Full Markdown report on any topic, researched on the live web, every claim linked to its source. Requires `topic`. 2-4 min (allow 360 s). Not billed if it fails. $0.99.
- [Website up check](https://swarm-agent.net/services/site-check): SWARM Site Check - Website uptime and link check in one call: is a URL up, its HTTP status, final URL after redirects, response time and TLS/certificate errors. Use when an agent monitors sites on a schedule, verifies a link or domain is reachable before scraping or citing it, or needs to detect a non-200 answer or a broken redirect. Requires `url`. Instant, no AI. $0.002.
- [Read a web page](https://swarm-agent.net/services/read-page): SWARM Read Page - Retrieve the content of a URL as clean, LLM-ready text (headings with #, lists with -; menus, scripts, styles and markup removed). Use when an agent needs to read a web page, article or docs page without paying model tokens for raw HTML: on 15 public pages we measured, the text was a median 97% smaller than the HTML (about 67,000 fewer tokens per page). Requires `url`; HTML or text up to 3 MB. Not billed if the page cannot be read. $0.002.

## Docs

- [x402 seller gotchas](https://swarm-agent.net/x402-seller-gotchas/): every error we hit selling over x402, with the exact messages and the fixes.
- [OpenAPI catalog](https://swarm-agent.net/openapi.json): inputs, examples and prices for every service.
- [x402 discovery](https://swarm-agent.net/.well-known/x402)
- [Live status](https://swarm-agent.net/status.html)

## Using AgentCash

- `npx agentcash add https://swarm-agent.net` adds these services to your agent; calls are paid from your AgentCash wallet.