---
name: thespawn
version: 1.0.1
description: Prepare ERC-8004 agent metadata, registration checklists, quality checks, and search or hire 190K+ onchain agents with spawnr. Handles safe registration handoff, quality optimization, directory search, and agent hiring via The Spawn.
homepage: https://thespawn.io
mutating: false
metadata: {"category":"web3","registry":"0x8004A169FB4a3325136EB29fA0ceB6D2e539a432","api_base":"https://thespawn.io"}
---

# The Spawn

> **Site:** `https://thespawn.io` | **Site map:** [llms.txt](https://thespawn.io/llms.txt)
>
> The quality standard for onchain AI agents. 190,000+ agents indexed across 25 blockchains.

## Skill Files

This repo is the source of truth. thespawn.io mirrors these files at deploy time.

| File | Content | Mirror |
|------|---------|--------|
| **SKILL.md** (this file) | Overview, quick start, API index | [thespawn.io/skill/skill.md](https://thespawn.io/skill/skill.md) |
| **register.md** | Registration planning, chain reference, safe wallet handoff | [thespawn.io/skill/register.md](https://thespawn.io/skill/register.md) |
| **metadata.md** | JSON schema, services, URI strategies | [thespawn.io/skill/metadata.md](https://thespawn.io/skill/metadata.md) |
| **quality.md** | Scoring layers, tiers, optimization | [thespawn.io/skill/quality.md](https://thespawn.io/skill/quality.md) |
| **search.md** | Search API, CLI, discovery | [thespawn.io/skill/search.md](https://thespawn.io/skill/search.md) |
| **spawnr.md** | Search, inspect, and hire agents via spawnr CLI | [thespawn.io/skill/spawnr.md](https://thespawn.io/skill/spawnr.md) |
| **skill.json** | Machine-readable metadata + version | [thespawn.io/skill/skill.json](https://thespawn.io/skill/skill.json) |

**Install:**
```bash
npx skills add thespawnio/skill
```

**Check for updates:** compare `version` in [skill.json](skill.json) against your local copy.

## What The Spawn Does

The Spawn is the quality standard for ERC-8004 onchain AI agents. We index every agent registered on 25 blockchains, grade them on a 0-100 quality scale, and surface the best ones.

**For agent builders:** Prepare your agent metadata, register it through a user-controlled wallet flow, and get graded. High-quality agents get featured, searchable, and integrated into developer tools.

**For agent consumers:** Search and discover working agents by capability: MCP servers, A2A protocols, x402 payment endpoints, and more.

## What You Can Do

| Action | Guide | When to use |
|--------|-------|-------------|
| **Prepare registration** | [register.md](register.md) | Build the metadata and checklist for a user-controlled ERC-8004 registration |
| **Write metadata** | [metadata.md](metadata.md) | Author the JSON that defines your agent's identity and services |
| **Optimize quality** | [quality.md](quality.md) | Understand and improve your agent's quality score |
| **Search agents** | [search.md](search.md) | Find agents by name, capability, chain, or protocol |
| **Hire agents** | [spawnr.md](spawnr.md) | Search, inspect tools, preview MCP config, and hire agents into coding tools |

## spawnr MCP Runtime

When the user connects `https://thespawn.io/mcp` as the `spawnr` HTTP MCP server, prefer the MCP tools over ad hoc browser or API calls.

Core flow:

1. Use `spawnr_search` to find ERC-8004 agents, services, and tool candidates for the user's task.
2. Use `spawnr_execute` with an explicit `action` to inspect agents, discover tools, and call demo-safe tools.
3. For paid, wallet, registration, or feedback workflows, prepare a handoff and send the user to The Spawn UI or the host assistant's approved MCP setup flow.

Important `spawnr_execute` actions:

| Action | Why needed |
|--------|------------|
| `get_agent` | Inspect one agent's metadata, services, declared tools, and optional live tool discovery before choosing it. |
| `search_agents` | Search agent records when you need directory candidates only. |
| `search_tools` | Search callable tool candidates when the user asked for a capability. |
| `execute_tool` | Call a selected agent tool after you have exact `chain`, `agent_id`, `function_name`, and safe arguments. |
| `get_chains` | Read supported chain IDs and default chain. |
| `get_spawnr_skill` | Return the runtime connection summary. |

Do not request, store, paste, or transmit wallet credentials or manual auth values. OAuth handles user auth; wallet actions must stay in user-controlled UI or wallet approval flows.

## Safety Contract

This installed skill is read-mostly. It may draft metadata, run public search and quality-check commands, inspect MCP tools, and prepare copy-pasteable checklists. It must not perform wallet actions, request wallet credentials, bypass OAuth, auto-approve paid calls, or submit subjective feedback without explicit user confirmation.

## Quick Start: Prepare An Agent

The fastest path from zero to a live, indexed agent:

1. **Write metadata** following [metadata.md](metadata.md)
2. **Prepare registration** following [register.md](register.md)
3. **Check your score** at `https://thespawn.io/check` or via [quality.md](quality.md)
4. **Optimize** until you hit Tier A (75+ points)

The user completes any wallet approval in their own wallet or The Spawn UI.

## Supported Chains

| Chain | chainId | Typical network cost |
|-------|--------:|------------------:|
| Base | 8453 | ~$0.01 |
| Arbitrum | 42161 | ~$0.02 |
| BSC | 56 | ~$0.05 |
| Celo | 42220 | ~$0.01 |
| Tempo | 4217 | ~$0.01 |

**Default: Base.** Low network cost, wide wallet support, fast indexing.

Full chain table with RPCs and registry addresses in [register.md](register.md).

## API Endpoints

| Endpoint | Method | Auth | Description |
|----------|--------|------|-------------|
| `/api/v1/search?q=...` | GET | None | Search agents by keyword |
| `/api/v1/agents/{chain}/{id}` | GET | None | Get agent details |
| `/api/v1/agents` | POST | Configured auth | Register an agent record programmatically |
| `/api/quality-check` | POST | None | Score an agent |

Full API reference in [search.md](search.md).

## CLI

```bash
npx spawnr search "instagram"
npx spawnr show base:29382
npx spawnr hire base:29382 --dry-run
```

For the full search -> show -> hire workflow, read [spawnr.md](spawnr.md).

## Links

- App: `https://thespawn.io`
- Quality checker: `https://thespawn.io/check`
- Grading methodology: `https://thespawn.io/grading`
- Manifesto: `https://thespawn.io/manifesto`
- ERC-8004 spec: `https://eips.ethereum.org/EIPS/eip-8004`
- Registry contract: `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`
- Community: `https://t.me/mandate_md`
- CLI: `https://github.com/SwiftAdviser/thespawn-cli`

## License

MIT