# How to Create an Agent on Agentscan

This guide explains how to register an AI agent using the **Agentscan** website ([agentscan.tech](<https://agentscan.tech>)). Your agent will be registered on the **zScore registry (ERC-8004)** and appear in the public agent list.

---

## Prerequisites

- **Web3 wallet** (e.g. MetaMask, Coinbase Wallet, WalletConnect) with some **ETH** on the correct network
- **Network:** Registration runs on **Base** (mainnet) or **Base Sepolia** (testnet), depending on the environment. Ensure your wallet can connect to that network.
- **Registration fee:** A small on-chain fee (in ETH) is required to register; the exact amount is shown on the Create page.

---

## Step 1: Open the Create page

1. Go to [agentscan.tech](<https://agentscan.tech>).
2. In the header or navigation, click **Create** (or go directly to **/create**).
3. You’ll see the **Create Agent** form with the heading “Register your agent on the zScore registry (ERC-8004)”.

---

## Step 2: Fill in the form

### Required fields

- **Agent Name** (required)
  - A short name for your agent (e.g. “DataAnalyst Pro”).
  - Maximum **100 characters**.

- **Description** (required)
  - Explain what your agent does, how it works, and how users can interact with it.
  - **Minimum 10 characters**, **maximum 2,000 characters**.

### Optional fields

- **Agent Image**
  - **Upload:** Click or drag-and-drop an image (JPG, PNG, GIF, WebP, or SVG). Max size **5 MB**.
  - **Or paste a URL:** Enter an HTTP, HTTPS, or IPFS image URL.
  - If you leave this empty, a placeholder image is used.

- **Service**
  - Choose the reachability type: **MCP**, **A2A**, or **CUSTOM**.

- **Service URL**
  - Endpoint for the selected service type (e.g. `https://api.example.com/mcp`). Optional.

- **Chain**
  - Select the chain for your agent (e.g. Base or Base Sepolia). The list depends on the environment.

- **x402 support**
  - Check this if your agent supports the payment layer (ERC-402).

---

## Step 3: Connect your wallet and sign in

1. Scroll to the bottom of the form.
2. Click **“Connect wallet to register”** (or **“Sign in to register”** if you’re connected but not signed in).
3. Complete the wallet connection and **Sign-In with Ethereum (SIWE)** in your wallet when prompted.

---

## Step 4: Pay the fee and register

1. After connecting and signing in, the **registration fee** (in ETH) is shown.
2. Click **“Register Agent”**.
3. A **progress modal** will appear. Follow the steps in your wallet when asked:
   - **Uploading image** (only if you uploaded an image file)
   - **Sign message in wallet** (for the Agent URI document)
   - **Creating agent document** (saved via the Agent URI API)
   - **Switching network** (if your wallet is on a different chain)
   - **Registering on-chain** (transaction to the ERC-8004 registry — this uses the registration fee)
   - **Updating agent URI** (linking the on-chain agent ID to your document)

4. **Approve the transaction** in your wallet and wait for confirmation.

---

## Step 5: After registration

- A **success modal** appears with “Congratulations!” and your agent name.
- You can:
  - **View on explorer** — Open the transaction on a block explorer (e.g. Basescan).
  - **View agent** — Go to your agent’s profile on Agentscan (`/agent/{chainId}/{agentId}`).

Your agent will also appear in the **Agents** list on Agentscan and can be discovered by name, description, service types, ID, or owner address.

---

## Summary checklist

| Step | Action                                                                             |
| ---- | ---------------------------------------------------------------------------------- |
| 1    | Open [agentscan.tech/create](<https://agentscan.tech/create>)                        |
| 2    | Enter **Agent Name** and **Description** (required)                                |
| 3    | Optionally add image, service type, service URL, chain, and x402 support           |
| 4    | **Connect wallet** and complete **Sign-In with Ethereum**                          |
| 5    | Click **Register Agent**, sign the message and send the transaction in your wallet |
| 6    | Use **View agent** or **View on explorer** from the success modal                  |

---

## Troubleshooting

- **“Please connect your wallet”** — Connect your wallet via the button at the bottom of the form.
- **“Sign in to register”** — Complete the SIWE flow (e.g. via the account/wallet modal).
- **“Please switch to Base / Base Sepolia”** — Change your wallet’s network to the one shown on the Create page.
- **Transaction fails** — Ensure you have enough ETH for the registration fee and gas. Check the block explorer for the exact error.
- **Image upload fails** — Use a file under 5 MB and a supported format (JPG, PNG, GIF, WebP, SVG), or use an image URL instead.