# AGENSAI

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

AGENSAI is a TypeScript SDK, CLI, and MCP server for creating AI agent wallets where every agent is identified by an ENS subname (e.g. `dca-bot.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) and gasless ENS subname issuance via the JAW SDK (`@jaw.id/core`), plus ERC-7715 permissions. Same team owns every layer of the stack.

## Install

- `npm install @agensai/sdk` — TypeScript SDK
- `npm install -g @agensai/cli` — Command-line tool with MCP server

## Five-line agent

```typescript
import { createAgent } from "@agensai/sdk";

const agent = await createAgent({
  name: "dca-bot",
  chainId: 8453,
  apiKey: process.env.AGENSAI_API_KEY!,
  ownerPrivateKey: process.env.AGENSAI_OWNER_PRIVATE_KEY!,
  policies: [
    { type: "spend", token: "USDC", amount: 50, period: "weekly" },
    { type: "contract", whitelist: ["uniswap.eth"] },
  ],
});

await agent.execute({ to: "treasury.acme.eth", amount: "10 USDC" });
```

## Documentation

- [Introduction](https://docs.agensai.xyz/introduction)
- [Quickstart (CLI)](https://docs.agensai.xyz/quickstart-cli)
- [Quickstart (SDK)](https://docs.agensai.xyz/quickstart-sdk)
- [Concepts: Agents & ENS](https://docs.agensai.xyz/concepts/agents-and-ens)
- [SDK reference](https://docs.agensai.xyz/sdk)
- [CLI reference](https://docs.agensai.xyz/cli)
- [MCP server](https://docs.agensai.xyz/mcp)
- [Recipes](https://docs.agensai.xyz/recipes)

## MCP integration

```bash
agensai mcp start
```

Add to AI IDE config (Claude Desktop, Cursor, Codex, Windsurf, Gemini, Warp):

```json
{
  "mcpServers": {
    "agensai": {
      "command": "agensai",
      "args": ["mcp", "start"],
      "env": { "AGENSAI_API_KEY": "..." }
    }
  }
}
```

## Standards

- [ERC-4337](https://eips.ethereum.org/EIPS/eip-4337)
- [ERC-7715](https://eips.ethereum.org/EIPS/eip-7715)
- [ERC-7528](https://eips.ethereum.org/EIPS/eip-7528)
- [ENS](https://docs.ens.domains/)

## Optional

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