# Overview

Self Agent ID binds an AI agent's key to a human's passport proof on-chain, so any service can check that a real person stands behind the agent, with no API key.

**Start here:** [Quickstart](/docs/agent-id/quickstart/): register a testnet agent in about 5 minutes with the SDK, the CLI or Postman.

## Who this is for

| You are                      | You do                                                     | Guide                                                               |
| ---------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------- |
| **Agent builder**            | Register an agent, sign outbound requests with `SelfAgent` | [Building an agent](/docs/agent-id/guides/agent-builder/)           |
| **Service or API team**      | Verify inbound agent requests with `SelfAgentVerifier`     | [Verifying agents](/docs/agent-id/guides/service-operator/)         |
| **Protocol or infra team**   | Gate contracts and read the registry on-chain              | [Gating smart contracts](/docs/agent-id/guides/contract-developer/) |
| **AI coding assistant user** | Register, look up and verify agents through MCP            | [Using the MCP server](/docs/agent-id/guides/mcp-user/)             |

## How it works

1. **The human scans a QR code** with the Self app, which makes a ZK proof on the phone.
2. **Hub V2 verifies the proof** on-chain and calls the registry.
3. **The registry mints a soulbound ERC-721 NFT** that binds the agent key to the human's nullifier.
4. **The agent signs each request** with its own key; services check the signature and the registry.

An agent is **verified** when `hasHumanProof && isProofFresh`. The SDK, the API and the contracts all apply this rule. The registry implements [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) with a [Proof-of-Human extension](/docs/agent-id/erc-8004/).

:::note
No personal data leaves the phone. Only the proof result, a nullifier and the credentials the human chose to disclose are stored on-chain.
:::

## Key properties

- **Trustless**: verification reads the on-chain registry, with no central server in the path.
- **Private**: each credential is disclosed only if the human opts in.
- **Sybil-resistant**: one nullifier per human. The registry caps agents per human at 10 on Celo Mainnet and sets no cap on Celo Sepolia. Verifiers set their own cap: `SelfAgentVerifier` defaults to 1 (`.sybilLimit(0)` = no limit).
- **Time-bounded**: proofs expire at `min(document expiry, registration + 365 days)` and can be refreshed in place.
- **Composable**: one registry call from any EVM contract, backend or agent framework.

## Networks

| Network      | API name  | Chain ID   | Registry                                     | Documents                                                                 |
| ------------ | --------- | ---------- | -------------------------------------------- | ------------------------------------------------------------------------- |
| Celo Mainnet | `mainnet` | `42220`    | `0xaC3DF9ABf80d0F5c020C06B04Cced27763355944` | Real passports and ID cards                                               |
| Celo Sepolia | `testnet` | `11142220` | `0x043DaCac8b0771DD5b444bCC88f2f8BBDBEdd379` | [Mock passports](/docs/self-enterprise/guides/using-mock-passports/) only |

Public RPCs: `https://forno.celo.org` (mainnet) and `https://forno.celo-sepolia.celo-testnet.org` (testnet).

:::warning
Each network accepts only its own kind of document. A real passport fails on Celo Sepolia with `InvalidIdentityCommitmentRoot`, and a mock passport fails on Celo Mainnet. The SDK, A2A and MCP default to `mainnet`; the CLI defaults to `testnet`.
:::

## Ways to use it

| Interface                                                                              | Use it for                                                               |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| TypeScript SDK [`@selfxyz/agent-sdk`](/docs/agent-id/sdk-integration/)                 | Registering, signing and verifying requests (the only official SDK)      |
| [REST API](/docs/agent-id/rest-api/) at `https://agent-api.self.xyz`                   | Registration and agent queries from any language, plus A2A and discovery |
| [Postman collection](/docs/agent-id/postman/)                                          | Trying every endpoint with no code                                       |
| [MCP server](/docs/agent-id/guides/mcp-user/) at `https://agent-api.self.xyz/api/mcp`  | AI coding assistants                                                     |
| [Local MCP server](/docs/agent-id/guides/mcp-user/#local-server) `@selfxyz/mcp-server` | AI coding assistants that sign as your own agent                         |
| [`self-agent` CLI](/docs/agent-id/cli/)                                                | Registering from a terminal                                              |
| [Smart contracts](/docs/agent-id/smart-contracts/)                                     | On-chain gating and reads                                                |

Other languages call the REST API and implement the [request-signing scheme](/docs/agent-id/sdk-integration/#signing-scheme). Source: [github.com/selfxyz/self-agent-id](https://github.com/selfxyz/self-agent-id).

## Next

- [Quickstart](/docs/agent-id/quickstart/): a verified testnet agent in about 5 minutes
- [Registration modes](/docs/agent-id/registration-modes/): pick the key type and ownership model
