# AGENSAI

> ENS-native wallets for AI agents. Every agent gets an ENS name, a smart account, and onchain permissions. Built on JAW.

AGENSAI is an MCP server that lets any AI chat (Claude Desktop, Cursor, Claude Code, and any other MCP host) spawn, scope, and revoke onchain agents. Every agent is identified by an ENS subname (e.g. `ghadi-coffee.agensai.eth`) instead of a hex address. Built by JustaLab, the team behind JAW.id. JustaLab is an ENS DAO funded service provider.

Under the hood: ERC-4337 smart accounts (EntryPoint v0.8), gasless ENS subname issuance via JAW (`@jaw.id/core`), and ERC-7715 permissions enforced onchain. Same team owns every layer.

## Install

`agensai` is the only package. There is no separate SDK or CLI. The MCP server is the product.

```bash
npx agensai pair <token>
```

Get the pairing token from the dashboard at https://app.agensai.xyz after signing up with a passkey.

> Older `@agensai/mcp`, `@agensai/sdk`, and `@agensai/cli` packages on npm are deprecated. Do not install them. Use `agensai` only.

## How users spawn an agent

The MCP exposes 12 tools (spawn, scope, send, query, revoke, grant allowance, etc). Users describe what they want in plain English in their AI chat:

> "Pay ghadi.eth 1 USDC every day for a week."

The AI chains `create_agent` (spawning an isolated `ghadi-coffee.agensai.eth` wallet funded with 7 USDC) with `grant_allowance` (letting ghadi.eth pull 1 USDC per day from that agent). Result: ghadi pulls from an isolated, named wallet — not from the user's main pool — and the user can revoke or drain anytime.

## MCP integration

Once paired, add to your IDE's MCP config:

```json
{
  "mcpServers": {
    "agensai": {
      "command": "npx",
      "args": ["@agensai/mcp", "serve"]
    }
  }
}
```

The daemon reads its config from `~/.agensai/orchestrator.json`, written by the `pair` step. No env vars needed in the IDE config.

## Documentation

- [Introduction](https://docs.agensai.xyz/introduction)
- [Quickstart](https://docs.agensai.xyz/quickstart)
- [Identity model](https://docs.agensai.xyz/concepts/identity)
- [ENS as canonical state](https://docs.agensai.xyz/concepts/ens-as-state)
- [Recovery](https://docs.agensai.xyz/recovery)
- [Security](https://docs.agensai.xyz/security)
- [MCP setup](https://docs.agensai.xyz/mcp/setup)
- [MCP tools](https://docs.agensai.xyz/mcp/tools)
- [FAQ](https://docs.agensai.xyz/faq)

## Standards

- [ERC-4337](https://eips.ethereum.org/EIPS/eip-4337) — account abstraction
- [ERC-7715](https://eips.ethereum.org/EIPS/eip-7715) — permission grants
- [ERC-7528](https://eips.ethereum.org/EIPS/eip-7528) — native asset address
- [ERC-6492](https://eips.ethereum.org/EIPS/eip-6492) — counterfactual signature verification
- [ENS](https://docs.ens.domains/) — subname issuance + text records

## Optional

- [GitHub](https://github.com/agensai/poc)
- [JAW.id](https://jaw.id)